OpenRouter
aggregator
Getting credentials
api-key
api_key via header (header Authorization: Bearer)
Environment: OPENROUTER_API_KEY
openrouter.ai → Keys. Prepaid credits (5.5% purchase fee); optional HTTP-Referer and X-Title attribution headers.
Endpoints
| ID | URL | Protocol | Auth |
|---|---|---|---|
| chat-completions | https://openrouter.ai/api/v1/chat/completions | openai-chat | any |
API surfaces
textstreaming
Quirks
- Unified reasoning object: {effort | max_tokens, exclude, enabled}. Effort converts to a token budget where needed (Anthropic clamped min 1024 / max 128000). reasoning.exclude strips reasoning from responses. Routing: provider.order/allow_fallbacks/sort/require_parameters/max_price; :nitro and :floor model suffixes. (docs)
Models offered
| Model | Wire ID | Endpoint | Status | Reasoning |
|---|---|---|---|---|
| alibaba/qwen3-7-flash | qwen/qwen3.7-flash | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| alibaba/qwen3-7-plus | qwen/qwen3.7-plus | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| alibaba/qwen3-8-2-4t-a95b | qwen/qwen3.8-2.4t-a95b | chat-completions | ga | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |
| alibaba/qwen3-8-27b | qwen/qwen3.8-27b | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| alibaba/qwen3-8-flash | qwen/qwen3.8-flash | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| alibaba/qwen3-8-max | qwen/qwen3.8-max-0902 | chat-completions | ga | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |
| allenai/olmo-3-32b-think | allenai/olmo-3-32b-think | chat-completions | retired | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |
| amazon/nova-2-lite | amazon/nova-2-lite-v1 | chat-completions | ga | effort · default off · returns reasoning_content |
| anthropic/claude-fable-5 | anthropic/claude-fable-5 | chat-completions | ga | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |
| anthropic/claude-fable-5-1 | anthropic/claude-fable-5.1 | chat-completions | ga | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |
| anthropic/claude-haiku-4-5 | anthropic/claude-haiku-4.5 | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| anthropic/claude-opus-4-6 | anthropic/claude-opus-4.6 | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| anthropic/claude-opus-4-7 | anthropic/claude-opus-4.7 | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| anthropic/claude-opus-4-8 | anthropic/claude-opus-4.8-fast | chat-completions | retired | effort · default on · returns reasoning_content · round-trips reasoning_content |
| anthropic/claude-opus-4-8 | anthropic/claude-opus-4.8 | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| anthropic/claude-opus-5 | anthropic/claude-opus-5 | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| anthropic/claude-sonnet-5 | anthropic/claude-sonnet-5 | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| baidu/ernie-4-5-vl | baidu/ernie-4.5-vl-424b-a47b | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| bytedance/seed-2-0-code | bytedance-seed/seed-2.0-code | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| bytedance/seed-2-0-lite | bytedance-seed/seed-2.0-lite | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| bytedance/seed-2-0-mini | bytedance-seed/seed-2.0-mini | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| bytedance/seed-2-1-turbo | bytedance-seed/seed-2-1-turbo | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| deepseek/deepseek-v4-flash | deepseek/deepseek-v4-flash-0731 | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| deepseek/deepseek-v4-flash | deepseek/deepseek-v4-flash | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| deepseek/deepseek-v4-pro | deepseek/deepseek-v4-pro-0813 | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| deepseek/deepseek-v4-pro | deepseek/deepseek-v4-pro | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| google/gemini-3-1-pro | google/gemini-3.1-pro-preview | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| google/gemini-3-5-flash | google/gemini-3.5-flash | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| google/gemini-3-5-flash-lite | google/gemini-3.5-flash-lite | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| google/gemini-3-6-flash | google/gemini-3.6-flash | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| google/gemini-3-7-flash | google/gemini-3.7-flash | chat-completions | ga | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |
| google/gemini-3-8-flash | google/gemini-3.8-flash | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| google/gemini-3-flash | google/gemini-3-flash-preview | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| google/gemma-4 | google/gemma-4-26b-a4b-it | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| google/gemma-4 | google/gemma-4-31b-it | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| ibm/granite-4-1-8b | ibm-granite/granite-4.1-8b | chat-completions | retired | none · default off · returns reasoning_content |
| ibm/granite-4-2-8b | ibm-granite/granite-4.2-8b | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| inception/mercury-2 | inception/mercury-2 | chat-completions | ga | effort · default on · returns reasoning_content |
| inclusionai/ling-3-0-flash | inclusionai/ling-3.0-flash | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| kwaipilot/kat-coder-pro-v2-5 | kwaipilot/kat-coder-pro-v2.5 | chat-completions | ga | none · default off · returns reasoning_content |
| liquid/lfm-2-5-2-6b | liquid/lfm-2.5-2.6b:free | chat-completions | ga | effort · default on · mandatory · returns reasoning_content |
| meituan/longcat-2-0 | meituan/longcat-2.0 | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| meta/llama-3-3-70b | meta-llama/llama-3.3-70b-instruct | chat-completions | ga | none · default off · returns reasoning_content |
| meta/llama-4-maverick | meta-llama/llama-4-maverick | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| meta/muse-glimmer-30b | meta/muse-glimmer-30b | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| meta/muse-spark-1-2 | meta/muse-spark-1.2 | chat-completions | ga | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |
| meta/muse-spark-1-3 | meta/muse-spark-1.3-contributor | chat-completions | ga | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |
| meta/muse-spark-1-3 | meta/muse-spark-1.3 | chat-completions | ga | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |
| minimax/minimax-m2-5 | minimax/minimax-m2.5 | chat-completions | ga | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |
| minimax/minimax-m2-7 | minimax/minimax-m2.7 | chat-completions | ga | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |
| minimax/minimax-m3 | minimax/minimax-m3 | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| mistral/mistral-large-3 | mistralai/mistral-large-2512 | chat-completions | ga | none · default off · returns hidden |
| mistral/mistral-medium-3-5 | mistralai/mistral-medium-3-5 | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| moonshot/kimi-k2-5 | moonshotai/kimi-k2.5 | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| moonshot/kimi-k2-6 | moonshotai/kimi-k2.6 | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| moonshot/kimi-k2-7-code | moonshotai/kimi-k2.7-code | chat-completions | ga | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |
| moonshot/kimi-k3 | moonshotai/kimi-k3 | chat-completions | ga | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |
| nex-agi/nex-n2-5-mini | nex-agi/nex-n2.5-mini:free | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| nex-agi/nex-n2-5-pro | nex-agi/nex-n2.5-pro:free | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| nex-agi/nex-n2-mini | nex-agi/nex-n2-mini | chat-completions | retired | effort · default on · returns reasoning_content · round-trips reasoning_content |
| nex-agi/nex-n2-pro | nex-agi/nex-n2-pro | chat-completions | retired | effort · default on · returns reasoning_content · round-trips reasoning_content |
| nvidia/nemotron-3-5-lightning | nvidia/nemotron-3.5-lightning | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| nvidia/nemotron-3-nano | nvidia/nemotron-3-nano-30b-a3b | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| nvidia/nemotron-3-super | nvidia/nemotron-3-super-120b-a12b | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| nvidia/nemotron-3-ultra | nvidia/nemotron-3-ultra-550b-a55b | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| openai/gpt-5 | openai/gpt-5 | chat-completions | ga | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |
| openai/gpt-5-1 | openai/gpt-5.1 | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| openai/gpt-5-4 | openai/gpt-5.4-pro | chat-completions | ga | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |
| openai/gpt-5-4 | openai/gpt-5.4 | chat-completions | ga | effort · default off · returns reasoning_content · round-trips reasoning_content |
| openai/gpt-5-4-mini | openai/gpt-5.4-mini | chat-completions | ga | effort · default off · returns reasoning_content · round-trips reasoning_content |
| openai/gpt-5-4-nano | openai/gpt-5.4-nano | chat-completions | ga | effort · default off · returns reasoning_content · round-trips reasoning_content |
| openai/gpt-5-5 | openai/gpt-5.5-pro | chat-completions | ga | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |
| openai/gpt-5-5 | openai/gpt-5.5 | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| openai/gpt-5-6 | openai/gpt-5.6-luna-pro | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| openai/gpt-5-6 | openai/gpt-5.6-luna | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| openai/gpt-5-6 | openai/gpt-5.6-sol-pro | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| openai/gpt-5-6 | openai/gpt-5.6-sol | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| openai/gpt-5-6 | openai/gpt-5.6-terra-pro | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| openai/gpt-5-6 | openai/gpt-5.6-terra | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| openai/gpt-6 | openai/gpt-6-astra-pro | chat-completions | ga | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |
| openai/gpt-6 | openai/gpt-6-astra | chat-completions | ga | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |
| openai/gpt-oss-120b | openai/gpt-oss-120b | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| openai/gpt-oss-20b | openai/gpt-oss-20b | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| openai/o3 | openai/o3 | chat-completions | ga | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |
| poolside/laguna-s-2-1 | poolside/laguna-s-2.1 | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| poolside/laguna-xs-2-1 | poolside/laguna-xs-2.1 | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| sakana/fugu-ultra | sakana/fugu-ultra | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| stepfun/step-3-5-flash | stepfun/step-3.5-flash | chat-completions | ga | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |
| stepfun/step-3-7-flash | stepfun/step-3.7-flash | chat-completions | ga | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |
| tencent/hy3 | tencent/hy3 | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| thinkingmachines/inkling | thinkingmachines/inkling | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| thinkingmachines/inkling-small | thinkingmachines/inkling-small | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| upstage/solar-pro-4 | upstage/solar-pro4 | chat-completions | ga | adaptive · default on · returns reasoning_content |
| xai/grok-4-5 | x-ai/grok-4.5 | chat-completions | ga | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |
| xai/grok-4-6 | x-ai/grok-4.6 | chat-completions | ga | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |
| xiaomi/mimo-v2-5 | xiaomi/mimo-v2.5 | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| xiaomi/mimo-v2-5-pro | xiaomi/mimo-v2.5-pro | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| zai/glm-4-6 | z-ai/glm-4.6 | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| zai/glm-4-7 | z-ai/glm-4.7 | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| zai/glm-4-7-flash | z-ai/glm-4.7-flash | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| zai/glm-5-1 | z-ai/glm-5.1 | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| zai/glm-5-2 | z-ai/glm-5.2 | chat-completions | ga | effort · default on · returns reasoning_content · round-trips reasoning_content |
| zai/glm-5-3 | z-ai/glm-5.3 | chat-completions | ga | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |
| zai/glm-5-3-flash | z-ai/glm-5.3-flash | chat-completions | ga | effort · default on · mandatory · returns reasoning_content · round-trips reasoning_content |