Install
openclaw skills install openrouterOpenRouter API gateway skill. Access 300+ AI models from 60+ providers through a single OpenAI-compatible API. Unified billing, automatic fallbacks, provider...
openclaw skills install openrouterOpenRouter is a unified API gateway that gives you access to 300+ AI models from 60+ providers — Anthropic, OpenAI, Google, DeepSeek, Meta, Mistral, xAI, and more — through a single, OpenAI-compatible API endpoint.
Instead of managing separate accounts, API keys, and billing for each provider, you use one API key and one credit balance. Switch models by changing a single parameter — no code changes needed.
OpenRouter powers 250,000+ apps with 4.2M+ users globally.
Base URL: https://openrouter.ai/api/v1
| Benefit | Details |
|---|---|
| One API, all models | Access Claude, GPT, Gemini, DeepSeek, Llama, Grok, and hundreds more through a single endpoint |
| OpenAI-compatible | Drop-in replacement — change the base URL and API key, everything else works unchanged |
| No markup | Provider pricing is passed through at cost |
| Automatic fallbacks | If a provider goes down, requests route to another provider automatically |
| Edge routing | ~25–40ms of added latency between you and inference |
| Privacy controls | Fine-grained data policies — choose which providers can see your prompts |
| BYOK support | Bring your own provider API keys and still get OpenRouter's routing and analytics |
Sign up at openrouter.ai and add credits on the Credits page. Credits work with any model or provider. There is no minimum purchase and credits don't expire.
Go to Settings > API Keys and create a key. Store it securely as an environment variable:
export OPENROUTER_API_KEY="sk-or-v1-..."
OpenRouter is fully OpenAI-compatible. Here's a basic example:
curl https://openrouter.ai/api/v1/chat/completions \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "anthropic/claude-sonnet-4-20250514",
"messages": [
{"role": "user", "content": "Hello, what can you help me with?"}
]
}'
To switch models, just change the model field — no other code changes needed.
from openai import OpenAI
client = OpenAI(
base_url="https://openrouter.ai/api/v1",
api_key="sk-or-v1-..."
)
response = client.chat.completions.create(
model="anthropic/claude-sonnet-4-20250514",
messages=[{"role": "user", "content": "Hello!"}]
)
OpenRouter passes through provider pricing at cost — no markup.
| Plan | How It Works |
|---|---|
| Free models | Dozens of models at $0/token. Rate-limited to 20 req/min, 200 req/day (or 1,000/day with $10+ in credits) |
| Pay-as-you-go | Buy credits, use them with any model. Billed per token at posted rates. Auto top-up available |
| BYOK | Use your own provider API keys. First 1M BYOK requests/month are free, then 5% of upstream cost |
| Enterprise | Volume discounts, prepayment credits, annual commits, invoicing/POs, SSO (SAML) |
Input and output tokens are billed separately per model. You're only charged for successful completions — failed requests and fallback attempts don't cost you.
| Model | Input | Output |
|---|---|---|
| DeepSeek V3.2 | $0.25 | $0.38 |
| Gemini 3.1 Flash Lite | $0.25 | $1.50 |
| Llama 3.3 70B | Free | Free |
| GPT-5.4 | $2.50 | $15.00 |
| Claude Sonnet 4.6 | ~$3.00 | ~$15.00 |
| GPT-5.4 Pro | $30.00 | $180.00 |
Prices change as providers update. Check openrouter.ai/models for current rates.
OpenRouter automatically routes requests to the best available provider. If one provider goes down or errors, the request falls back to another — you're only billed for the successful run.
You can also control routing explicitly:
:nitro variant — Append :nitro to a model slug for speed-optimized routingUse your existing API keys from OpenAI, Anthropic, Google Cloud, AWS Bedrock, Azure AI, and other providers while still getting OpenRouter's unified interface, fallback routing, and analytics.
If the underlying model supports function calling / tool use, you can use it through the same API. Structured output formats (JSON mode) are also supported for compatible models.
Append :online to any model slug to enable web search (powered by Exa.ai). Search
results are injected into the context with citations. Pricing is per result returned.
OpenRouter supports images, audio, and PDFs across models that handle them. Send images as URLs or base64, and PDFs work the same way.
Most major providers now support context caching through OpenRouter. Gemini offers a 90% discount on cached tokens.
Every request includes Zero Completion Insurance — if a model returns an empty or failed completion, you're not charged.
For sensitive workloads, enable ZDR to ensure providers don't retain your prompts or completions.
All endpoints use Authorization: Bearer <OPENROUTER_API_KEY>.
Base URL: https://openrouter.ai/api/v1
| Method | Endpoint | Description |
|---|---|---|
| POST | /chat/completions | Chat completion (OpenAI-compatible) |
| POST | /completions | Text completion (OpenAI-compatible) |
| GET | /models | List all available models with pricing |
| GET | /models/{model_id} | Get details for a specific model |
| POST | /embeddings | Generate embeddings (model-dependent) |
| Method | Endpoint | Description |
|---|---|---|
| POST | /keys | Create a new API key (requires Provisioning key) |
| GET | /keys | List API keys |
| DELETE | /keys/{key_id} | Delete an API key |
| Method | Endpoint | Description |
|---|---|---|
| GET | /credits | Check credit balance |
| GET | /activity | View usage activity and costs |
OpenRouter works with popular frameworks out of the box:
For teams, OpenRouter offers organizations with:
OpenRouter offers dozens of models at zero cost, including DeepSeek R1, Llama 3.3 70B, Gemma 3, and others. Free models are rate-limited (20 req/min, 200 req/day for accounts without credits; 1,000/day with $10+ credits) but require no payment to use.
A dedicated free model router (openrouter/free) automatically selects the best
available free model for your request.
| Need | Channel |
|---|---|
| Technical support | Discord — #help forum |
| Billing & account | support@openrouter.ai |
| Enterprise sales | Enterprise form |
| Status page | status.openrouter.ai |
| Documentation | openrouter.ai/docs |
OPENROUTER_API_KEY in your environment.openrouter.ai.
Your key grants access to your credit balance and all enabled models.