OpenRouters API 使用文档

一个 Key 接入 Claude 与图像生成模型：OpenAI 与 Anthropic 双协议兼容，Claude 提供十一档分组（0.2x 低至 4.5x，同一模型按池选价），图像提供标准 / 保脸两档分组，按量计费、实时可查。

快速开始

1. 注册账号 — 打开 api.openrouters.work/register，填写用户名、邮箱、密码即可注册（当前无需邮箱验证码）。
2. 充值额度 — 登录后进入「钱包」查看余额。当前充值通过兑换码发放（联系管理员获取，见页面底部联系方式）；$1 余额 = 1 美元 API 额度，按实际用量扣费。
3. 创建 API 令牌 — 进入「控制台 → API 令牌 → 添加令牌」，选择分组（Claude 共 11 个池可选：日常推荐 Claude-Max-外接，省钱选 Claude-AWSQ；生图选 img-lite / img-pro，详见 Claude 专区），复制生成的 sk- 密钥。
4. 发起请求 — 把 Base URL 与密钥填入你的客户端（见下方「客户端配置」），或直接用 curl 调用。

注册与充值

• 注册地址：https://api.openrouters.work/register；
• 余额与消费记录在「钱包」与「日志」页面实时可查；扣费精确到每次请求（token 级 / 按张级）；
• 当前支付通道筹备中，充值发放兑换码；如有充值问题请联系管理员。

创建 API 令牌

1. 登录后进入「控制台 → API 令牌」；
2. 点击「添加令牌」，填写名称（建议写用途，如 my-claude-code）；
3. 选择分组：
   • 用 Claude 模型 → 共 11 个池任选（0.2x–4.5x，见 Claude 专区）；推荐默认 Claude-Max-外接；
   • 用图像模型 → img-lite / img-pro；
4. 建议同时设置：额度上限（可选，防超支）、过期时间（可选）、IP 白名单（可选）；
5. 保存后复制 sk- 开头的密钥——仅显示一次，请妥善保存。

第一个请求

curl https://api.openrouters.work/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的令牌" \
  -d '{
    "model": "claude-sonnet-5-5",
    "messages": [{"role": "user", "content": "你好，请用一句话介绍你自己。"}]
  }'

返回 OpenAI 格式的 JSON（含 usage 用量字段）。首次调用成功即代表账户与网络链路正常。

接口规则

Base URL 与鉴权

OpenAI 兼容接口

对话示例（流式）：请求体加 "stream": true，响应为 SSE。

生图示例：

curl https://api.openrouters.work/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-生图令牌" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只橘猫坐在未来城市的窗边，赛博朋克风格",
    "size": "1024x1024",
    "n": 1
  }'

响应为标准 OpenAI Images 格式（data[].url 或 b64_json，视模型支持）。生图为按张计费，每次成功生成一张扣一次费用（尺码/分辨率不同价格可能不同，以模型广场展示为准）。

Anthropic 兼容接口（Claude Code 直连）

curl https://api.openrouters.work/v1/messages \
  -H "x-api-key: sk-你的令牌" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'

支持流式（"stream": true）、工具调用（tools）、系统提示（system）等原生特性；Claude Code / Claude 兼容客户端请按此配置。

错误码

Claude 使用专区

初次使用 Claude 只需三步：选分组 → 建令牌 → 配客户端。本节把这三件事讲全。

一、先选分组：十一档号池总表

本站 Claude 提供 11 个号池分组，倍率从 0.2x 到 4.5x，同一模型在不同池价格最多差 20 倍。各池与上游源站名称、倍率一一对应：

• 倍率 = 价格系数：同一个模型，池倍率越高 → 单价越高。实际价格见下方价表；
• 一令一池：一把令牌只能属于一个分组；需要多档位就建多把令牌（例如一把 Max-外接 + 一把 AWSQ）；
• 部分池限客户端：Claude-Max 仅限 Claude Code（非 CC 请求会被上游自动转入外接组按 1.2x 计费）；其他池不限客户端。

二、Claude 模型与价格

提供 9 款 Claude 模型，按 Token 计费，单位：美元 / 每 100 万 tokens（输入 / 输出）。价格公式：

缓存计价（所有模型统一）：缓存读取 = 输入价 × 20%；缓存写入（5 分钟档）= 输入价 × 125%。

费用示例（输入 4,000 + 输出 1,000 tokens，claude-sonnet-5-5）：Claude-Max-外接 档 $0.0275；Claude-AWSQ 档 $0.0091。

长系统提示、文档反复问答等重复上下文场景，缓存机制会显著省钱。

三、客户端配置指南（以 Claude Code 为例）

任何 Claude 兼容客户端的配置都只有三个要素：Base URL、API Key、模型名：

第 1 步 · 安装 Claude Code（已安装可跳过）

npm install -g @anthropic-ai/claude-code

第 2 步 · 配置环境变量

macOS / Linux（写入 ~/.zshrc 或 ~/.bashrc 后 source 或重开终端）：

export ANTHROPIC_BASE_URL="https://api.openrouters.work"
export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"
export ANTHROPIC_MODEL="claude-sonnet-5-5"
export ANTHROPIC_SMALL_FAST_MODEL="claude-sonnet-5-5"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

Windows PowerShell（永久生效把 $env: 换成 setx 后重开终端）：

$env:ANTHROPIC_BASE_URL="https://api.openrouters.work"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的令牌"
$env:ANTHROPIC_MODEL="claude-sonnet-5-5"
$env:ANTHROPIC_SMALL_FAST_MODEL="claude-sonnet-5-5"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

Windows CMD（当前会话）：

set ANTHROPIC_BASE_URL=https://api.openrouters.work
set ANTHROPIC_AUTH_TOKEN=sk-你的令牌
set ANTHROPIC_MODEL=claude-sonnet-5-5
set ANTHROPIC_SMALL_FAST_MODEL=claude-sonnet-5-5
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

第 3 步 · （推荐）写进 settings.json 一劳永逸

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.openrouters.work",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-sonnet-5-5",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

文件位置：macOS / Linux ~/.claude/settings.json；Windows %USERPROFILE%\.claude\settings.json。

第 4 步 · 验证

claude
> 你好，请用一句话介绍你自己

能正常回复即配置成功；之后可在「控制台 → 日志」查看每次调用与扣费。

可选 · 用 CC Switch 管理多套配置

CC Switch 是常用的 Claude Code / Codex 配置切换工具：新增供应商 → 类型选 Claude → 填入上面的 Base URL / API Key / 模型名 → 应用即可，适合同时使用多个中转站、需要一键切换的用户。

其他客户端速配

• Cherry Studio：添加供应商 → 类型「Anthropic」→ API 地址 https://api.openrouters.work → 密钥填令牌 → 模型填三个 ID 之一；
• OpenAI 兼容客户端（LobeChat / NextChat / OpenWebUI / 各类 SDK）：Base URL 填 https://api.openrouters.work/v1（这个带 /v1），模型名同上；
• 自写代码：二选一——Anthropic 原生 POST /v1/messages（x-api-key 头），或 OpenAI 兼容 POST /v1/chat/completions（Authorization: Bearer 头）。

四、Claude 常见问题

全站分组速览

本站按「分组」组织模型与价格。创建令牌时选择分组，即锁定该 Key 的可用模型与计费档位。

图像系列价格

按张计费，单位为 美元 / 张（标准尺寸；高清 / 4K 档以模型广场实时价格为准）。

完整实时价格与模型详情见 模型广场（每个模型点开「详情」可查看全部分组的定价明细）。

其他客户端 · OpenAI 兼容接入

支持 Cherry Studio、NextChat、LobeChat、OpenWebUI、各类 SDK（OpenAI Python / Node）等所有 OpenAI 兼容客户端——把「API 地址」改为上面的 Base URL、「密钥」改为你的令牌即可。

其他客户端与通用要点

• Cherry Studio / LobeChat / NextChat：Claude 模型选「Anthropic」类型（地址用根域，见上方 Claude 专区）；图像模型选「OpenAI」类型（地址带 /v1）。如界面支持自定义模型名，直接填模型 ID。
• 生图客户端：把接口类型选为「图片生成 / Images」，不要用聊天模型类型（生图走 /v1/images/generations）。
• 注意 /v1 的取舍：Anthropic 协议用 https://api.openrouters.work（不带 /v1）；OpenAI 协议用 https://api.openrouters.work/v1（带 /v1），不要拼成 /v1/v1。

常见问题

Q：报「分组 X 下模型 Y 无可用渠道」？

该模型不在你令牌的分组里。Claude 模型要用 Claude 池分组的令牌（11 个池）；生图模型要用 img-* 分组令牌。另一个可能：你选中的池不覆盖该模型（各池模型覆盖见 总表）——到「控制台 → API 令牌」确认分组，或换用覆盖该模型的池。

Q：余额怎么计算？会乱扣吗？

所有扣费按请求实际用量计算并写入日志，分毫可查：「控制台 → 日志」可看到每次请求的模型、用量与扣费金额。Claude 按 token 计费，生图按张计费。

Q：旗舰和经济档区别大吗？

大。本站按号池分 11 档，倍率 0.2x–4.5x。Kiro（0.2x）最省但智商低、适合简单任务；AWSQ（0.4x）日常性价比；Max 系列（1.0–1.4x）满血稳定；官 key 系（2.2–4.5x）最高保真。详细对比见 Claude 专区总表，价格见 全模型价表。

Q：生图支持哪些尺寸 / 参数？

按 OpenAI Images 参数格式（size、n 等）。不同模型支持的分辨率不同（1K / 2K / 4K），部分档位按尺寸分价，详见模型广场。

Q：为什么 Claude 返回文字里带「缓存」字段？

Claude 的 prompt caching 特性默认开启计费口径：缓存读取按输入价的 20% 计费、缓存写入（5分钟档）按 125% 计费——大量重复上下文场景下能显著省钱。

Q：接口地址大陆能直连吗？

域名走全球加速解析，常规网络可直连；如遇超时，先换网络环境或稍后重试，持续异常请联系管理员。

条款与政策

• 服务仅面向合法用途；禁止将本服务用于任何违法、侵权、骚扰或恶意用途；
• 禁止转售至受制裁地区或用于违反上游供应商政策的行为；
• 账户余额与令牌请自行妥善保管；密钥泄露导致的损失由用户承担；
• 服务按「现状」提供，因上游波动导致的暂时不可用将尽力恢复；
• 具体服务条款以站点注册协议为准，如有疑问请联系管理员。