OpenRouter — One API Key, Hundreds of AI Models

OpenRouter 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

---

Why Use OpenRouter

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 |

---

Quick Start

1. Create an Account

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.

2. Create an API Key

Go to Settings > API Keys and create a key. Store it securely as an environment
variable:

CODEBLOCK0

3. Make a Request

OpenRouter is fully OpenAI-compatible. Here's a basic example:

CODEBLOCK1

To switch models, just change the model field — no other code changes needed.

4. Using the OpenAI SDK

CODEBLOCK2

---

Pricing

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.

Sample Model Pricing (per 1M tokens)

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.*

---

Key Features

Model Routing & Fallbacks

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:

• - Provider ordering — Prioritize specific providers for a model
• Provider ignoring — Exclude providers you don't trust
• Performance thresholds — Set latency or throughput minimums
• Regional routing — Pin requests to specific regions (Enterprise / Pay-as-you-go)
• :nitro variant — Append :nitro to a model slug for speed-optimized routing

Bring Your Own Key (BYOK)

Use 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.

• - First 1M BYOK requests per month are free
• 5% fee on subsequent usage (based on upstream provider cost)
• BYOK keys are automatically prioritized during routing
• Supports: OpenAI, Anthropic, Google Vertex, AWS Bedrock, Azure, and more

Tool Calling & Structured Outputs

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.

Web Search

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.

Multimodal

OpenRouter supports images, audio, and PDFs across models that handle them. Send
images as URLs or base64, and PDFs work the same way.

Prompt Caching

Most major providers now support context caching through OpenRouter. Gemini offers
a 90% discount on cached tokens.

Zero Completion Insurance

Every request includes Zero Completion Insurance — if a model returns an empty or
failed completion, you're not charged.

Zero Data Retention (ZDR)

For sensitive workloads, enable ZDR to ensure providers don't retain your prompts
or completions.

---

API Reference

All endpoints use Authorization: Bearer <OPENROUTER_API_KEY>.

Base URL: INLINECODE6

Core Endpoints

Method	Endpoint	Description
POST	INLINECODE7	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) |

Key Management Endpoints

Method	Endpoint	Description
POST	INLINECODE12	Create a new API key (requires Provisioning key)
GET

/keys | List API keys | | DELETE | /keys/{key_id} | Delete an API key |

Analytics & Account

Method	Endpoint	Description
GET	INLINECODE15	Check credit balance
GET

/activity | View usage activity and costs |

---

Security & Privacy

• - No training on your data. OpenRouter does not train on prompts or completions.
• Provider logging controls. Providers that log prompts are flagged. You can

restrict routing to non-logging providers in your privacy settings.

• - Fine-grained data policies. Ensure prompts only go to providers you trust.
• SOC 2 Type I compliance indicated (verify current status for compliance-critical

deployments).

• - ZDR (Zero Data Retention) available per-request or account-wide.
• API key spending limits — Set per-key caps with daily, weekly, or monthly resets.

---

Framework Integrations

OpenRouter works with popular frameworks out of the box:

• - OpenAI SDK (Python & TypeScript) — change the base URL
• LangChain / LangGraph
• Vercel AI SDK
• Langfuse (observability)
• Mastra
• MCP Servers
• Any framework that supports the OpenAI API format

---

Organizations & Enterprise

For teams, OpenRouter offers organizations with:

• - Shared credit pools and centralized billing
• Role-based access control (Admin / Member)
• Organization-wide activity tracking and CSV/PDF exports
• Guardrails — spending limits, model/provider allowlists, ZDR enforcement
• Programmatic key provisioning and rotation via Management API
• SSO (SAML) on Enterprise plans
• Broadcast / observability integrations (up to 5 destinations)

---

Free Models

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.

---

Contact & Support

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 |

---

Important Notes

• - Save your API key on creation. Store it in your platform's secrets manager or

as OPENROUTER_API_KEY in your environment.

• - Never send your OpenRouter API key to any domain other than openrouter.ai.

Your key grants access to your credit balance and all enabled models.

• - Model availability can change. Models can be deprecated or have pricing updates

at any time. Pin specific model IDs/versions in production to avoid surprises.

• - Free model rate limits apply. Free-tier usage is subject to rate limiting,

especially during peak times. Failed attempts still count toward daily quotas.

• - BYOK is not free after 1M requests. The first million BYOK requests per month

are free, then a 5% fee applies based on upstream cost.

• - OpenRouter is a proxy, not a provider. It routes your requests to the underlying

model provider. Latency, output quality, and capabilities depend on the model and provider, not OpenRouter itself.