Try Bifrost Enterprise free for 14 days.
Request access

How to Get an OpenRouter API Key

Create a Mistral account at openrouter.ai, generate your API key, store it securely, then integrate with Bifrost for virtual keys, budgets, and cost governance. Complete setup in minutes.

Multi-providerOpenAI-compatibleModel routingPay-as-you-goBifrost gateway

OpenRouter provider summary

Bifrost supports OpenRouter as a single OpenAI-compatible gateway to hundreds of models from many providers.

PropertyDetails
DescriptionOpenRouter provides one API and key to access models from OpenAI, Anthropic, Google, Meta, Mistral, and others.
Provider route on Bifrostopenrouter/<model>
Provider docOpenRouter
API endpoint for providerhttps://openrouter.ai/api/v1
Supported endpoints/v1/models, /v1/completions, /v1/chat/completions, /v1/responses, /v1/embeddings

Official OpenRouter Resources

OpenRouter docs, keys dashboard, and model catalog.

Prerequisites

Before you begin, you will need:

OpenRouter accountEmail addressCredits for production use
i
Credits: OpenRouter uses a credit balance. Add credits in the dashboard before production traffic.

[ QUICK START ]

How Do You Get an OpenRouter API Key in 5 Steps?

1

Create an OpenRouter account

Use openrouter.ai.

Go to openrouter.ai and sign up with email or OAuth.

2

Open the Keys page

Navigate to openrouter.ai/keys from your account menu.

3

Create and copy your API key

Copy the key immediately.

Click Create Key, name it, and copy the value into your secrets manager or .env file.

Terminal (macOS/Linux)
export OPENROUTER_API_KEY="..."
!
Treat keys like passwords: Never expose secrets in client-side code or version control.
4

Make your first Chat Completions call

OpenRouter is OpenAI-compatible.

Use Bearer authentication with the OpenAI-compatible base URL:

Terminal
$ curl https://openrouter.ai/api/v1/chat/completions   -H "Content-Type: application/json"   -H "Authorization: Bearer $OPENROUTER_API_KEY"   -d '{
    "model": "openai/gpt-4o-mini",
    "messages": [{"role":"user","content":"Hello from OpenRouter!"}]
  }'

[ MODELS ]

Available OpenRouter Models

ModelAPI IDBest for
GPT-4oopenai/gpt-4oOpenAI multimodal via OpenRouter.
GPT-4o miniopenai/gpt-4o-miniAffordable OpenAI tier.
Claude Sonnet 4.5anthropic/claude-sonnet-4.5Anthropic agents and coding.
Claude Haiku 4.5anthropic/claude-haiku-4.5Fast Anthropic tier.
Gemini 2.5 Progoogle/gemini-2.5-proGoogle reasoning via OpenRouter.
Gemini 2.5 Flashgoogle/gemini-2.5-flashFast Google multimodal.
Llama 3.3 70B Instructmeta-llama/llama-3.3-70b-instructOpen model routing.
DeepSeek R1deepseek/deepseek-r1Reasoning model aggregation.
Mistral Largemistralai/mistral-largeMistral flagship routing.
Qwen 3 235Bqwen/qwen3-235b-a22bLarge Qwen via OpenRouter.

Models and availability change over time. See the OpenRouter models directory for the latest list and pricing.

[ TROUBLESHOOTING ]

Troubleshooting Common OpenRouter Issues

ErrorLikely CauseWhat to Do
401 UnauthorizedInvalid or missing API key.Verify your API key is correct. Generate a new key if needed.
400 Bad RequestInvalid request format or unsupported model.Check request format and confirm model ID is valid.
429 Rate LimitedRate limit exceeded for your plan.Upgrade your plan or implement exponential backoff. Use Bifrost for intelligent load distribution.
502/503 Service ErrorTemporary Mistral service unavailability.Retry after a delay. Check Mistral status page. Configure failover with Bifrost.

[ PRODUCTION-READY ]

Use OpenRouter with Bifrost

Bifrost is a drop-in replacement for OpenRouter SDKs: keep your client code and change the base URL to your gateway. Bifrost handles cost tracking, virtual keys, budgets, and failover automatically.

Step 1: Start Bifrost and register OpenRouter

Run the Bifrost gateway and configure your Mistral credentials in the Web UI.

Terminal
$ npx -y @maximhq/bifrost
OUTPUT
 Bifrost started
├─ HTTP server listening on http://localhost:8080
├─ Web UI available at   http://localhost:8080
└─ Configure providers and virtual keys in the dashboard
Add the OpenRouter integration in the Web UI. For details, read OpenRouter on Bifrost.

Step 2: Point your OpenRouter SDK at Bifrost

Update your OpenRouter SDK client to route through the Bifrost gateway.

example.py
from openai import OpenAI

client = OpenAI(
    api_key="sk-bf-your-virtual-key",
    base_url="http://localhost:8080/openai"
)

response = client.chat.completions.create(
    model="openai/gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello from Bifrost!"}]
)

print(response.choices[0].message.content)
Virtual keys can be sent as x-bf-vk or Authorization: Bearer sk-bf-* per the Bifrost documentation.

Ready to Route OpenRouter Through Bifrost?

Bifrost is open source and production-ready. Get started in minutes with cost tracking, virtual keys, and failover built in.

[ BIFROST FEATURES ]

Open Source & Enterprise

Everything you need to run AI in production, from free open source to enterprise-grade features.

01 Governance

SAML support for SSO and Role-based access control and policy enforcement for team collaboration.

02 Adaptive Load Balancing

Automatically optimizes traffic distribution across provider keys and models based on real-time performance metrics.

03 Cluster Mode

High availability deployment with automatic failover and load balancing. Peer-to-peer clustering where every instance is equal.

04 Alerts

Real-time notifications for budget limits, failures, and performance issues on Email, Slack, PagerDuty, Teams, Webhook and more.

05 Log Exports

Export and analyze request logs, traces, and telemetry data from Bifrost with enterprise-grade data export capabilities for compliance, monitoring, and analytics.

06 Audit Logs

Comprehensive logging and audit trails for compliance and debugging.

07 Vault Support

Secure API key management with HashiCorp Vault, AWS Secrets Manager, Google Secret Manager, and Azure Key Vault integration.

08 VPC Deployment

Deploy Bifrost within your private cloud infrastructure with VPC isolation, custom networking, and enhanced security controls.

09 Guardrails

Automatically detect and block unsafe model outputs with real-time policy enforcement and content moderation across all agents.

[ SHIP RELIABLE AI ]

Try Bifrost Enterprise with a 14-day Free Trial

[quick setup]

Drop-in replacement for any AI SDK

Change just one line of code. Works with OpenAI, Anthropic, Vercel AI SDK, LangChain, and more.

1import os
2from anthropic import Anthropic
3
4anthropic = Anthropic(
5 api_key=os.environ.get("ANTHROPIC_API_KEY"),
6 base_url="https://<bifrost_url>/anthropic",
7)
8
9message = anthropic.messages.create(
10 model="claude-3-5-sonnet-20241022",
11 max_tokens=1024,
12 messages=[
13 {"role": "user", "content": "Hello, Claude"}
14 ]
15)
Drop in once, run everywhere.

[ FAQ ]

Frequently Asked Questions

OpenRouter is a unified API that routes requests to many LLM providers through one key and OpenAI-compatible endpoints.

New accounts may receive trial credits. Check your dashboard for current promotions and balance.

Use provider/model IDs like openai/gpt-4o-mini. Browse the catalog at openrouter.ai/models.

Yes. Set base_url to https://openrouter.ai/api/v1 and pass your OpenRouter API key.

Configure OpenRouter in Bifrost and route through http://localhost:8080/openrouter.

OpenRouter bills per model at listed rates. Use Bifrost for aggregated cost tracking across providers.