Zilmac 博客
← 返回技术实践

OpenRouter API 教程 2026:注册、充值、API Key、模型选择与 GPT/Claude/Gemini 调用

API 与 Agent ·约 12 分钟阅读

OpenRouter 多模型 API 网关界面与开发者配置 GPT Claude Gemini 路由

OpenRouter 把 OpenAI、Anthropic、Google 等厂商的模型收敛到一条 OpenAI 兼容 API:改 base_url 和 model 就能在 GPT、Claude、Gemini 之间切换,不必为每个平台单独开户。本文是 2026 年实操向教程:从 openrouter.ai 注册、充值、创建 API Key,到在控制台选模型,并用 curl / Python 完成第一次调用。单价与月度账单推演见 OpenRouter 价格对比;若你主要用 Claude Code 订阅,可对照 Claude Code 2026 费用。

1
条 API:https://openrouter.ai/api/v1
300+
可路由模型(含多厂商 GPT / Claude / Gemini)
预充值
按 token 扣费;充值通道可能含手续费

OpenRouter 适合谁、和直连厂商 API 的区别

OpenRouter 是托管聚合商:你向 OpenRouter 预充值,请求经其路由到具体供应商;计费按各模型在 OpenRouter 上标注的输入/输出 token 单价扣余额。适合:

  • 想一个 Key、多模型试错(例如白天用便宜 Gemini Flash,晚上用 Claude Sonnet 写代码)
  • 所在地区不方便分别开通 OpenAI / Anthropic / Google 账单
  • 自建 Agent 或脚本,已按 openai SDK 写好,只想改 endpoint

不适合:强合规要求「数据绝不经过第三方中转」、或企业已与某一家签了独占折扣——那时应直连厂商或使用自托管网关(如 OmniRoute)。

和「只买 Claude Pro」怎么选?

Claude Code 的 Pro/Max 是固定月费 + 用量池,适合天天在终端里写代码。OpenRouter 是纯按量,适合脚本、多模型路由、或用量波动大的实验。两者可以并存:IDE 用订阅,CI/批处理走 OpenRouter。整月账单怎么叠,见 AI 编程一个月真实成本。

注册账号与登录方式

  1. 打开 openrouter.ai,点击 Sign in。
  2. 可用 Google、GitHub 或邮箱注册;团队建议用公司邮箱并开启 2FA(在 Account → Security)。
  3. 登录后进入 Dashboard,左侧可见 Credits、Keys、Activity。

注册本身不收费;未充值前部分免费模型可能可用,但生产环境应假设需要正余额才能稳定调用付费模型。

充值、余额与消费提醒

路径一般为 Settings → Credits 或 Dashboard 顶部的 Add Credits。支持信用卡等支付方式(以控制台当时选项为准)。

  • 预充值模型:余额不足时请求会失败,不会在事后寄账单。
  • 手续费:部分充值通道会加收约 5.5% 一类费用,实际到账 credits 少于支付金额——算单价时要把这层算进去,详见 价格对比文。
  • 用量查看:Activity / Usage 可按 Key、模型、时间筛选,便于对照日志排错。
开发者查看 OpenRouter API 用量仪表盘与多模型 token 计费曲线
养成习惯:每次调大 Agent 并发前先看 Credits 与 Activity,避免余额在周末跑批时耗尽

创建与管理 API Key

  1. 打开 Keys → Create Key。
  2. 为 Key 起名(如 cursor-dev、ci-nightly),便于在 Activity 里区分。
  3. 若控制台提供 限额 / 过期时间,给 CI 或实习生 Key 设上限。
  4. 复制 Key,只保存在密码管理器或密钥仓库;不要提交到 Git。

调用时在 HTTP Header 使用:

Authorization: Bearer <OPENROUTER_API_KEY>

可选但推荐同时带上(用于 OpenRouter 排行与策略,部分模型要求):

HTTP-Referer: https://your-app.example
X-Title: Your App Name

在模型目录里选 GPT / Claude / Gemini

打开 Models 页,搜索或按提供商筛选。请求里的 model 字段使用斜杠 ID,例如:

家族示例 model ID(2026 控制台常见写法)说明
Claudeanthropic/claude-sonnet-4.5编码与推理均衡;具体版本以目录为准
GPTopenai/gpt-5 或 openai/gpt-5-mini按任务选旗舰或 mini
Geminigoogle/gemini-2.5-pro、google/gemini-2.5-flashFlash 适合高吞吐、低成本

目录会显示每百万 token 的输入/输出价与上下文长度。同一逻辑名可能有多个路由(不同供应商副本);生产环境请固定 ID,不要依赖「自动最新」别名。

第一次调用:curl 与 Python

端点:

POST https://openrouter.ai/api/v1/chat/completions

Body 与 OpenAI Chat Completions 相同:model、messages,可选 stream: true。

调用 Claude(Anthropic)

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "HTTP-Referer: https://localhost" \
  -H "X-Title: Dev Test" \
  -d '{
    "model": "anthropic/claude-sonnet-4.5",
    "messages": [{"role": "user", "content": "用三句话解释 OpenRouter"}]
  }'

调用 GPT(OpenAI)

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5-mini",
    "messages": [{"role": "user", "content": "写一个 Python hello world"}]
  }'

调用 Gemini(Google)

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-2.5-flash",
    "messages": [{"role": "user", "content": "总结 REST 与 GraphQL 各一个优点"}]
  }'

Python(官方 openai SDK):

from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key=os.environ["OPENROUTER_API_KEY"],
)

resp = client.chat.completions.create(
    model="anthropic/claude-sonnet-4.5",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

若返回 402 或余额相关错误,先回 Dashboard 查 Credits;若 404 模型不存在,说明 ID 已更名——回到 Models 页复制最新 ID。

接入 Cursor、Claude Code 与其它客户端

  • Cursor / Cline / 自写 Agent:在「OpenAI 兼容」或「Override OpenAI Base URL」里填 https://openrouter.ai/api/v1,API Key 填 OpenRouter Key,Model 填上文的斜杠 ID。
  • Claude Code:官方默认走 Anthropic 订阅;若要用 OpenRouter,需按 Anthropic 兼容或项目文档配置自定义 endpoint(变更频繁,以你本机 claude CLI 帮助为准)。多数团队更倾向:终端用 Claude Code 订阅,脚本用 OpenRouter。
  • 环境变量:在云端 Mac 或 CI 里用 OPENROUTER_API_KEY,配合密钥注入,避免写进仓库。

常见问题

OpenRouter 的 Key 能代替 OpenAI 官方 Key 吗?

在兼容客户端里可以:把 base URL 指到 OpenRouter 即可。但计费、可用模型列表、数据路由策略都以 OpenRouter 为准,与 OpenAI 控制台无关。

流式输出怎么开?

请求 JSON 加 "stream": true,按 OpenAI SSE 格式读增量;SDK 通常有 stream=True 参数。

如何控制成本?

为每个环境单独 Key、设限额;默认用 Flash / mini 类模型,仅在评测通过后再切旗舰;长上下文任务先估算 token,对照 价格表。

和直连 Anthropic API 的 /v1/messages 一样吗?

OpenRouter 主路径是 /v1/chat/completions。若客户端只支持 Anthropic Messages,查 OpenRouter 文档是否提供对应兼容路由;否则用 OpenAI 兼容层或换 SDK。

限时优惠

Zilmac

云端 Mac、远程开发与 Mac VPS,为 iOS 与跨平台团队补齐 Apple 工具链。

返回首页
限时优惠 点击查看套餐