本页目录导航
开发者接入文档
一个 API Key,无缝接入 Claude Code、Codex CLI、CC Switch、Cherry Studio、Cursor 以及 OpenAI / Anthropic 官方 SDK。点击文档内任意地址或模型名即可一键复制。
快速开始
接口地址与协议
| 协议类型 | Base URL(点击复制) | 适用工具 / SDK |
|---|---|---|
| OpenAI Chat Completions | https://api.openrouter.cloud/v1 |
OpenAI 官方 SDK、Cherry Studio、Cursor、LangChain 等 |
| OpenAI Responses API | https://api.openrouter.cloud/v1 (/v1/responses) |
Codex CLI、OpenAI Responses SDK |
| Anthropic Messages API | https://api.openrouter.cloud |
Claude Code、CC Switch (Claude)、Anthropic SDK |
sk- 密钥。OpenAI 协议通过 Authorization: Bearer $API_KEY 传参,Anthropic 协议支持 x-api-key 或 ANTHROPIC_AUTH_TOKEN。
可用模型清单
点击下方模型名称即可复制完整 Model ID:
| 模型名称(点击复制) | 厂商 | 适用场景说明 |
|---|---|---|
claude-sonnet-5-5 | Anthropic | 均衡旗舰,代码编写、Agent 与长文写作首选 |
claude-opus-5-5 | Anthropic | Claude 顶级推理模型,适合复杂架构设计与深度分析 |
claude-haiku-5-5 | Anthropic | Claude 轻量高速模型,支持文本与图像 |
gpt-6-astra | OpenAI | OpenAI 顶级旗舰,适合高难度推理与复杂编码 |
gpt-6.1-sol | OpenAI | 新一代全能主力旗舰,支持多模态输入 |
gpt-6-luna | OpenAI | 轻量极速模型,适合日常对话与高并发批处理 |
deepseek-v4.1-flash | DeepSeek | 超高性价比代码与推理模型 |
glm-5.3 | Zhipu GLM | 中文深度语义理解与长文本处理旗舰 |
glm-5.3-flash | Zhipu GLM | 智谱高性价比轻量多模态模型 |
Claude Code
本站原生支持 Anthropic Messages 协议,无需任何代理转换工具,直接在终端设置环境变量即可启动:
export ANTHROPIC_BASE_URL="https://api.openrouter.cloud"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
claude --model claude-sonnet-5-5
也可以写入 ~/.claude/settings.json 实现持久化配置:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.openrouter.cloud",
"ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
"ANTHROPIC_MODEL": "claude-sonnet-5-5"
}
}
Codex CLI
Codex CLI 使用 OpenAI 的 /v1/responses 接口,本站已完整支持。请编辑 ~/.codex/config.toml:
model_provider = "openrouter"
model = "gpt-6-luna"
[model_providers.openrouter]
name = "openrouter"
base_url = "https://api.openrouter.cloud/v1"
env_key = "OPENROUTER_API_KEY"
wire_api = "responses"
然后在终端设置环境变量并启动 Codex:
export OPENROUTER_API_KEY="sk-你的密钥"
codex
wire_api = "responses",仅支持 /chat/completions 的旧版中转无法直接接入 Codex。
CC Switch
使用 CC Switch 可通过图形界面一键管理 Claude Code 与 Codex 服务商配置:
| 目标应用 | 接口地址(点击复制) | API Key |
|---|---|---|
| Claude Code | https://api.openrouter.cloud |
控制台生成的 sk- 密钥 |
| Codex | https://api.openrouter.cloud/v1 |
控制台生成的 sk- 密钥 |
Cherry Studio
https://api.openrouter.cloud/v1,API 密钥填入你的 sk- 令牌。Cursor / 通用 OpenAI 客户端
任何支持自定义 OpenAI Base URL 的客户端(如 Cursor、Windsurf、NextChat、LobeChat、沉浸式翻译等)均按以下参数配置:
- Base URL / API Host:
https://api.openrouter.cloud/v1 - API Key: 你在控制台创建的 sk- 密钥
- Model:
claude-sonnet-5-5/deepseek-v4.1-flash/gpt-6-luna
Python SDK
from openai import OpenAI
client = OpenAI(
base_url="https://api.openrouter.cloud/v1",
api_key="sk-你的密钥",
)
resp = client.chat.completions.create(
model="deepseek-v4.1-flash",
messages=[{"role": "user", "content": "你好,请介绍一下你自己"}],
)
print(resp.choices[0].message.content)
Node.js / TypeScript
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.openrouter.cloud/v1",
apiKey: "sk-你的密钥",
});
const resp = await client.chat.completions.create({
model: "claude-sonnet-5-5",
messages: [{ role: "user", content: "Hello!" }],
});
console.log(resp.choices[0].message.content);
cURL
curl https://api.openrouter.cloud/v1/chat/completions \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-luna",
"messages": [{"role": "user", "content": "你好"}]
}'
常见错误码排查
| 状态码 / 错误标识 | 原因分析与解决方法 |
|---|---|
401 Unauthorized |
API Key 填写错误、已被停用或已过期。请前往控制台「API 密钥」页面核对。 |
model_not_found |
模型名称拼写错误,或当前令牌设置了「模型白名单」未包含该模型。 |
insufficient_quota |
账户可用余额或令牌额度不足,请前往控制台「钱包」充值或调整令牌限额。 |
404 Not Found |
Base URL 路径填写有误。OpenAI 兼容客户端请填到 /v1 结尾,Anthropic 客户端填根域名。 |
计费与日志说明
所有模型均按实际消耗的输入(Prompt)与输出(Completion)Token 数量分别计费。你可以随时在控制台的「使用日志」页面查看每一次请求的模型、Token 数量、耗时与扣费金额。当账户余额耗尽时请求会自动停止,绝不会产生透支费用。
帮助与官方技术支持(QQ:188712194)
如果在接入 Claude Code、Codex CLI、Cursor 或 SDK 调用过程中遇到任何问题,或者需要企业级高并发配额、大额充值与专属兑换码,请直接联系官方客服:
188712194
(点击号码即可复制,支持 1 对 1 远程排查与账单核对)
AI 搜索引擎 / 编程助手索引地址:
你可以直接将 https://api.openrouter.cloud/llms.txt 或 https://api.openrouter.cloud/llms-full.txt 发给 Cursor、Claude Code 或 ChatGPT,让 AI 自动读取本站最新接口与模型价格完成配置。