Add all OpenRouter provider routing fields to OpenRouterRouting (#2904)
The OpenRouterRouting interface only had only and order, but the runtime passes the entire object as-is to the OpenRouter API's provider field. This means all other fields worked at runtime but had no TypeScript type-checking, no autocomplete, and no config validation. This adds all fields from the OpenRouter provider selection API (https://openrouter.ai/docs/guides/routing/provider-selection): allow_fallbacks, require_parameters, data_collection, zdr, enforce_distillable_text, ignore, quantizations, sort, max_price, preferred_min_throughput, preferred_max_latency. Also fixes the models.md documentation which had an invalid fallbacks field in the example (not part of the OpenRouter API), replaces it with a comprehensive example showing all available fields, and clarifies that openRouterRouting is sent as-is in the provider field.
This commit is contained in:
committed by
GitHub
parent
ee2483cd34
commit
f05f4e8a5f
@@ -305,7 +305,7 @@ For providers with partial OpenAI compatibility, use the `compat` field.
|
||||
| `requiresThinkingAsText` | Convert thinking blocks to plain text |
|
||||
| `thinkingFormat` | Use `reasoning_effort`, `zai`, `qwen`, or `qwen-chat-template` thinking parameters |
|
||||
| `supportsStrictMode` | Include the `strict` field in tool definitions |
|
||||
| `openRouterRouting` | OpenRouter routing config passed to OpenRouter for model/provider selection |
|
||||
| `openRouterRouting` | OpenRouter provider routing preferences. This object is sent as-is in the `provider` field of the [OpenRouter API request](https://openrouter.ai/docs/guides/routing/provider-selection). |
|
||||
| `vercelGatewayRouting` | Vercel AI Gateway routing config for provider selection (`only`, `order`) |
|
||||
|
||||
`qwen` uses top-level `enable_thinking`. Use `qwen-chat-template` for local Qwen-compatible servers that require `chat_template_kwargs.enable_thinking`.
|
||||
@@ -325,8 +325,32 @@ Example:
|
||||
"name": "OpenRouter Claude 3.5 Sonnet",
|
||||
"compat": {
|
||||
"openRouterRouting": {
|
||||
"order": ["anthropic"],
|
||||
"fallbacks": ["openai"]
|
||||
"allow_fallbacks": true,
|
||||
"require_parameters": false,
|
||||
"data_collection": "deny",
|
||||
"zdr": true,
|
||||
"enforce_distillable_text": false,
|
||||
"order": ["anthropic", "amazon-bedrock", "google-vertex"],
|
||||
"only": ["anthropic", "amazon-bedrock"],
|
||||
"ignore": ["gmicloud", "friendli"],
|
||||
"quantizations": ["fp16", "bf16"],
|
||||
"sort": {
|
||||
"by": "price",
|
||||
"partition": "model"
|
||||
},
|
||||
"max_price": {
|
||||
"prompt": 10,
|
||||
"completion": 20
|
||||
},
|
||||
"preferred_min_throughput": {
|
||||
"p50": 100,
|
||||
"p90": 50
|
||||
},
|
||||
"preferred_max_latency": {
|
||||
"p50": 1,
|
||||
"p90": 3,
|
||||
"p99": 5
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user