OpenRouter 入门 — 一个 API 金钥打通 300+ 模型 | THINPA

OpenRouter 是什么

OpenRouter 是一个 AI API 聚合平台。简单说，它在你和各大模型提供商（OpenAI、Anthropic、Google、Meta、Mistral 等）之间加了一层统一界面。你只需向 https://openrouter.ai/api/v1 发送请求，带上一组 OpenRouter API Key，就能呼叫平台上所有已接入的模型——目前已超过 300 款，涵盖闭源、开源、免费、付费各类型。

这和直接调用 OpenAI 或 Anthropic API 有什么不同？

• 单一端点、单一金钥：不需要分别在 OpenAI Console、Anthropic Console、Google AI Studio 申请账号、绑定信用卡、管理多组 Key。
• 统一计费：所有模型消费都在 OpenRouter 账户扣款，支援支付宝、币安支付等对陆友好方式，不用担心海外信用卡被拒。
• 模型发现与比价：平台内建即时定价表，能看到每个模型的 input/output 单价、context window、免费额度，甚至能直接在网页端试用对话。

想深入理解术语定义？请见 名词百科：OpenRouter。

为什么用 OpenRouter？优缺点一次讲清

优点

• 统一金钥管理：一组 Key 搞定所有模型，团队协作时只需分享一组凭证，权限控制也更简单。
• 即时比价、随时换模型：同一个 prompt，想试 GPT-4o、Claude 3.5 Sonnet、Gemini 2.5 Pro、DeepSeek V3，只要换 model 参数即可，不用改代码、不用换 SDK。
• 自动 Fallback：可设定 models: ["openai/gpt-4o", "anthropic/claude-3.5-sonnet"]，第一个模型不可用时自动切换到下一个，提高可用性。
• 免费模型可用：平台提供数十款免费模型（如 meta-llama/llama-3.1-8b-instruct:free、google/gemma-2-9b-it:free），适合原型验证、个人项目、学习实验，零成本起步。
• 对陆友好支付：支援支付宝、USDT（TRC20/ERC20）、币安支付，解决了国内开发者无海外信用卡无法直接用 OpenAI/Anthropic 官方 API 的痛点。

缺点

• 多一层网络延迟：请求先到 OpenRouter 再转发到上游，平均增加 ~50ms 延迟。对即时性要求极高的场景（如语音对话、高频交易）需评估影响。
• 部分模型定价略高：OpenRouter 会在上游价格基础上加价 0%~10%（视模型而定），大多数情况差异可忽略，但长期大量调用建议对比官方价格。
• 第三方依赖风险：若 OpenRouter 服务中断，所有模型同时不可用。生产环境建议保留直连关键模型的备用方案。
• 数据隐私考量：请求内容会经过 OpenRouter 服务器，极高敏感度数据（医疗、金融、机密代码）请审慎评估，或走官方直连/私有化部署。

5 分钟快速上手：从注册到第一个请求

Step 1：注册 + 取得 API Key

1. 打开 openrouter.ai，点击右上角“Sign Up”，支援 GitHub、Google、Email 注册。
2. 登入后进入 Keys 页面，点击“Create Key”，给个名称（如 my-app-dev），复制生成的 Key（格式：sk-or-v1-xxxxx）。只显示一次，请妥善保存。
3. 在 Credits 页面充值（最低 $5，支援支付宝/USDT），或先用免费模型试用。

Step 2：用 cURL 测试第一个请求

打开终端机，贴上以下指令（将 YOUR_KEY 替换为你的 Key）：

curl -X POST https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "HTTP-Referer: https://your-site.com" \
  -H "X-Title: My App" \
  -d '{
    "model": "openai/gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "用一句话介绍 OpenRouter"}
    ],
    "max_tokens": 100
  }'

成功会返回 JSON，choices[0].message.content 就是模型回复。HTTP-Referer 和 X-Title 非必填，但建议加上，方便 OpenRouter 统计来源、排查问题。

Step 3：Python 范例（OpenAI SDK 相容）

OpenRouter 完全相容 OpenAI Python SDK，只需改 base_url 和 api_key：

from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key="YOUR_KEY",  # 或从环境变数读取
)

response = client.chat.completions.create(
    model="anthropic/claude-3.5-sonnet",
    messages=[
        {"role": "system", "content": "你是一个乐于助人的助手。"},
        {"role": "user", "content": "用 Python 写一个冒泡排序"}
    ],
    max_tokens=500,
    temperature=0.7,
)

print(response.choices[0].message.content)
print(f"Tokens used: {response.usage.total_tokens}")

同理，Node.js 用 openai 套件、Go 用 go-openai、Rust 用 async-openai，都只需改 base URL 即可迁移。

Step 4：查即时定价 → 连结计算器

OpenRouter 官网 Models 页面提供即时定价表，但想快速试算“这个 prompt 大约多少钱”，用 Token 费用预估器 更直观：输入 prompt、选模型、即时看到 input/output token 数与预估费用，支援多模型并排比较。

费用试算：OpenRouter vs 直连 OpenAI

以下三个常见场景，对比 OpenRouter 价格与 OpenAI 官方直连价格（均以 2026-06 公开价格为准，实际以当时为准）：

结论：对主流闭源模型（GPT、Claude、Gemini），OpenRouter 价格与官方基本持平，偶尔略高 5%~20%。但 免费模型是 OpenRouter 独家优势——官方 API 没有免费额度的开源模型，在 OpenRouter 可零成本调用，适合副业项目、学习实验、低预算 MVP。若月调用量超过 $500，建议对比官方批次优惠或企业协议。