Routing
Provider Routing
Select and filter serving providers.
The provider object uses OpenRouter field names and semantics.
| Field | Type | Effect |
|---|---|---|
order |
string[] | Try these providers first in order, then other eligible providers. |
only |
string[] | Allow only these providers. |
ignore |
string[] | Exclude these providers. |
sort |
string or object with by |
Sort by price, throughput, or latency. |
allow_fallbacks |
boolean | With false, use only the ordered providers or the first host. |
data_collection |
string | deny keeps hosts marked as denying collection. |
zdr |
boolean | true keeps zero data retention hosts. |
quantizations |
string[] | Keep listed quantizations; unknown matches an unset value. |
max_price |
object | Maximum prompt and completion prices in USD per 1M tokens. |
| Default config order pins the first host for each model, plaingateway only. | ||
| A filter that leaves no host returns 404 with routing details. | ||
Recorded cases: chat_provider_order, chat_provider_only, chat_provider_ignore, chat_provider_sort_price, chat_provider_sort_throughput, chat_provider_sort_latency, chat_provider_allow_fallbacks_false, chat_provider_data_collection_deny, chat_provider_zdr, chat_provider_quantizations, and chat_provider_max_price_ok. |