Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -91,6 +91,8 @@ Warp's **Auto** models dynamically route requests across different models based

To use your own key, select a specific provider model (for example, Claude Opus 4.7, Claude Sonnet 4.6, GPT-5.5, or Gemini 3.1 Pro) directly from the model picker with a key icon.

[Custom routers](/agent-platform/inference/custom-routers/) behave differently: a router resolves each task to a concrete model you chose, and Warp then applies your API keys to that model. Requests that resolve to a model covered by one of your keys are billed through your provider account instead of consuming Warp credits. See [Credits and model availability](/agent-platform/inference/custom-routers/#credits-and-model-availability) for details.

### Credit usage

When you select a model with the key icon in your model picker, Warp routes the request through your API key. In that case:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -95,6 +95,8 @@ Warp's **Auto** models dynamically route across providers using Warp's infrastru

To use your endpoint, select the specific endpoint-routed model from the model picker rather than an Auto option.

[Custom routers](/agent-platform/inference/custom-routers/) can't use your endpoint either: routing targets must be Warp-supported models, so a router never resolves to an endpoint-routed model. Custom routers do apply [BYOK](/agent-platform/inference/bring-your-own-api-key/) provider keys after resolving a model.

### Other AI features in Warp

Some AI-powered features (Codebase Context, Active AI recommendations, cloud agent runs) rely on Warp's infrastructure and are unaffected by a custom inference endpoint. See the [feature breakdown on the BYOK page](/agent-platform/inference/bring-your-own-api-key/#byok-usage-and-billing-behavior) for which features still consume Warp credits.
Expand Down
13 changes: 12 additions & 1 deletion src/content/docs/agent-platform/inference/custom-routers.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ Custom routers automatically pick the right model for each task, using routing l
* **Complexity-based routing** - Warp classifies each task's difficulty and routes to the model you mapped to that level.
* **Rule-based routing** - Write natural-language rules that describe when to use each model.
* **Any supported model** - Route to any concrete model you have access to, across providers.
* **BYOK support** - With [your own API keys](/agent-platform/inference/bring-your-own-api-key/) configured, requests that resolve to a model covered by one of your keys bill through your provider account instead of Warp credits.
* **Settings or file** - Create a router in settings, or author it as a YAML file that Warp loads automatically.
* **Team-synced routers** - Admins can share a router with an entire team (Enterprise).

Expand Down Expand Up @@ -116,7 +117,17 @@ Team-synced routers appear in the model picker for every team member, who can se

A custom router resolves to a concrete model, so credit usage matches whichever model the router selects for each task. See [Credits](/support-and-community/plans-and-billing/credits/) for how credits are consumed.

Like Warp's built-in Auto models, custom routers consume Warp credits and don't draw on your own provider keys, even if you've configured [Bring Your Own API Key (BYOK)](/agent-platform/inference/bring-your-own-api-key/). To run a model on your own key, select that model directly instead of a router.
### Using your own API keys (BYOK)

Custom routers work with [Bring Your Own API Key (BYOK)](/agent-platform/inference/bring-your-own-api-key/). After the router resolves a task to a concrete model, Warp applies your API keys to that model — the same as selecting that model directly from the picker. Requests that resolve to a model covered by one of your keys are billed through your provider account and don't consume Warp credits; requests that resolve to a model without a matching key consume Warp credits as usual.

This is different from Warp's built-in Auto models, which always consume Warp credits even when BYOK is configured.

* **Running a router entirely on your own keys** - To use a router with no Warp credits available, your keys must cover every model the router references. If only some models are covered, you still need Warp credits for the requests that resolve to the uncovered models.
* **Team-managed keys (Enterprise)** - [Team-managed API keys](/enterprise/enterprise-features/team-managed-keys-and-endpoints/) apply to custom routers the same way; a member's own key for a provider takes precedence over the team's.
* **No custom inference endpoints** - Routing targets must be Warp-supported models, so a router can't resolve to a model from a [custom inference endpoint](/agent-platform/inference/custom-inference-endpoint/) and never draws on your endpoint.

### Model availability and fallback

If a router targets a model you don't have access to or that's disabled for your organization, Warp falls back to the router's default model. If no usable model remains, Warp falls back to a built-in default and tells you.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -106,7 +106,7 @@ If the admin allows members to add their own keys and endpoints, members can sti
## Billing behavior

* **No AI credits for team-routed inference** - When a request routes through a team key or team endpoint, Warp doesn't consume your [AI credits](/support-and-community/plans-and-billing/credits/). Inference is billed directly by your provider or endpoint.
* **Auto still uses Warp credits** - Warp's **Auto** models route across providers using Warp's infrastructure, so Auto always consumes Warp credits. To use a team provider, select a specific model or endpoint from the picker.
* **Auto still uses Warp credits** - Warp's **Auto** models route across providers using Warp's infrastructure, so Auto always consumes Warp credits. To use a team provider, select a specific model or endpoint from the picker. [Custom routers](/agent-platform/inference/custom-routers/) are the exception: after a router resolves a task to a concrete model, the request routes through the first-party key for that model's provider (the member's own key first, then the team key). Routers can't target team endpoint models.
* **Platform and compute credits still apply** - On Enterprise, local agent runs still consume [platform credits](/support-and-community/plans-and-billing/platform-credits/) for Warp's platform infrastructure (run lifecycle, orchestration, and observability). Cloud agent runs consume platform credits too, plus [compute credits](/support-and-community/plans-and-billing/credits/#compute-credits) when they use Warp-hosted compute.

See [The three credit buckets](/support-and-community/plans-and-billing/platform-credits/#the-three-credit-buckets) for more on credit types.
Expand Down
Loading