ax llm-provider | AX Documentation

The same surface as Integrations → LLM Providers in the platform app; see Model Providers and the 514.ax AI Gateway for how routing, allowlists, and billing behave. Providers are stack-ranked (lower priority runs first). API keys are write-only: prompted at a TTY or read from stdin, never accepted as a flag, never returned by reads.

Command	Use
`llm-provider list`	List providers and the built-in gateway.
`llm-provider view`	One provider by id.
`llm-provider create`	Create a BYOK provider.
`llm-provider update`	Update a provider.
`llm-provider delete`	Delete a provider.
`llm-provider reorder`	Re-rank providers.
`llm-provider test`	Probe a base URL + key without storing them.
`llm-provider gateway`	Enable or disable the 514.ax gateway fallback.

Requires org admin. All commands accept --org <org-id>; list and view also accept --json.

`llm-provider list`

List org BYOK providers and the built-in 514.ax gateway, in priority order.

ax llm-provider list

`llm-provider view`

Show one provider by id.

ax llm-provider view <PROVIDER_ID>

Argument / flag	What it does
`<PROVIDER_ID>`	Required. Provider record UUID from `llm-provider list`.
`--web`	Open the provider settings page in a browser.

`llm-provider create`

Create a BYOK provider. The API key is prompted at a TTY, or piped on stdin.

printf '%s' "$PROVIDER_API_KEY" | ax llm-provider create "<DISPLAY_NAME>" \
  --base-url <URL> --model <CANONICAL[=CUSTOM]>

Argument / flag	What it does
`<DISPLAY_NAME>`	Required. Human label shown in the provider list.
`--base-url <url>`	Required. Upstream base URL requests are forwarded to.
`--model <CANONICAL[=CUSTOM]>`	Required. Canonical model this provider may serve, optionally mapped to a custom upstream name. Repeatable.
`--priority <n>`	Stack-rank (lower runs first). Omit to append at the bottom.

Example:

printf '%s' "$ANTHROPIC_API_KEY" | ax llm-provider create "Prod Anthropic" \
  --base-url https://api.anthropic.com \
  --model anthropic/claude-sonnet-4-6

`llm-provider update`

Update a provider. Omitted flags keep their current values.

ax llm-provider update <PROVIDER_ID>

Argument / flag	What it does
`<PROVIDER_ID>`	Required. Provider record UUID.
`--display-name <name>`	New label.
`--base-url <url>`	New upstream base URL.
`--model <CANONICAL[=CUSTOM]>`	Replace the whole model list (repeatable).
`--set-key`	Prompt for (or read from stdin) a new API key. Without it the stored key is kept.
`--priority <n>`	New stack-rank.

`llm-provider delete`

Delete a provider by id.

ax llm-provider delete <PROVIDER_ID> [--yes]

`llm-provider reorder`

Re-rank providers: listed ids lead (first = priority 0), unlisted providers keep their relative order.

ax llm-provider reorder <PROVIDER_ID>...

Argument / flag	What it does
`<PROVIDER_ID>...`	Required. Ids in the desired leading order (a partial list is fine).
`--gateway-priority <n>`	Also set the built-in gateway's rank on the same scale.

`llm-provider test`

Probe a candidate base URL and key without storing anything. Exits non-zero on failure.

ax llm-provider test --base-url <URL>

Argument / flag	What it does
`--base-url <url>`	Required. Candidate upstream base URL. The key is prompted or piped.

`llm-provider gateway`

Enable or disable 514-managed model access as the fallback behind your BYOK providers.

ax llm-provider gateway <enable | disable>

Argument / flag	What it does
`<enable \| disable>`	Required. Turn the gateway fallback on or off.
`--priority <n>`	Stack-rank for the gateway. Omit to keep the current rank.

Search documentation