OpenRouter 统一调用指南

还在为每个模型去注册账号、绑定信用卡、管理几十个 API Key 而头大吗？OpenRouter 就是你的救星。它是一个且聚合了 OpenAI, Anthropic, Google, Meta, Mistral, DeepSeek 等几乎所有主流大模型的 API 聚合平台。

1. 为什么选择 OpenRouter

一个 Key 调所有: 只需要配置一个 OpenRouter API Key，就能调用上百种模型。
无需魔法/海外卡: OpenRouter 支持加密货币充值，也更容易通过国内网络访问（通常不需要复杂的代理配置，但需检查网络连通性）。
极其实惠: 部分开源模型（如 Llama 3 8B Free）甚至是完全免费的。付费模型通常与官方价格持平或略低。
排名比价: 它提供了一个直观的排行版，展示各个模型的 ELO 分数和每百万 Token 的价格。

2. 快速接入

OpenRouter 完全兼容 OpenAI API 标准。这意味着你现有的代码几乎不需要改动。

2.1 注册与充值

访问 openrouter.ai。
使用 Google 或 GitHub 登录。
在 Key Management 页面创建 API Key。
(可选) 充值 Credit (最低 $5)。

2.2 Python 调用示例

from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key="<YOUR_OPENROUTER_KEY>",
)

completion = client.chat.completions.create(
    model="anthropic/claude-3.5-sonnet", # 格式通常是: 厂商/模型名
    messages=[
        {"role": "user", "content": "What is the meaning of life?"}
    ],
)

print(completion.choices[0].message.content)

注意 Model ID 的格式。具体的 Model ID 可以在 OpenRouter 官网的模型列表中复制。例如：

openai/gpt-4o
google/gemini-flash-1.5
meta-llama/llama-3.1-405b
deepseek/deepseek-chat

3. 高级特性

3.1 HTTP Headers

OpenRouter 建议在请求头中添加两个字段，以便在它的后台统计中正确显示你的应用名称：

HTTP-Referer: 你的网站 URL。
X-Title: 你的应用名称。

3.2 自动回退 (Model Routing)

你可以让 OpenRouter 自动帮你省钱。它支持 "Auto" 路由模式，或者你可以自定义一个列表，如果首选模型挂了，自动尝试备选模型。

3.3 免费模型

OpenRouter 上有一系列后缀带 :free 的模型，这些通常是其它厂商为了宣传提供的免费配额。可以用于测试或非关键业务。

4. 常见问题

Q: 数据隐私如何？
- A: OpenRouter 默认不存储你的输入输出数据（除非你在设置中主动开启记录以方便调试）。但数据依然会经过模型提供方（如 OpenAI），请遵循各厂商的隐私政策。
Q: 速度慢吗？
- A: 对于闭源模型（GPT-4），速度基本与官方 API 一致。对于开源模型，取决于背后的托管商（如 Together AI, Fireworks），通常速度非常快。

最后更新：2025-12