openrouter Docs
本页目录导航
DEVELOPER DOCUMENTATION

开发者接入文档

一个 API Key,无缝接入 Claude Code、Codex CLI、CC Switch、Cherry Studio、Cursor 以及 OpenAI / Anthropic 官方 SDK。点击文档内任意地址或模型名即可一键复制。

快速开始

01
前往 注册账号 并登录 管理控制台,在「钱包」页完成充值或兑换码充值,余额即时到账。
02
在控制台 API 密钥 页面点击新建令牌,获取形如 sk-xxxxxxxx 的密钥。可按需配置额度上限、过期时间和可用模型范围。
03
根据你使用的工具或 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-5Anthropic均衡旗舰,代码编写、Agent 与长文写作首选
claude-opus-5-5AnthropicClaude 顶级推理模型,适合复杂架构设计与深度分析
claude-haiku-5-5AnthropicClaude 轻量高速模型,支持文本与图像
gpt-6-astraOpenAIOpenAI 顶级旗舰,适合高难度推理与复杂编码
gpt-6.1-solOpenAI新一代全能主力旗舰,支持多模态输入
gpt-6-lunaOpenAI轻量极速模型,适合日常对话与高并发批处理
deepseek-v4.1-flashDeepSeek超高性价比代码与推理模型
glm-5.3Zhipu GLM中文深度语义理解与长文本处理旗舰
glm-5.3-flashZhipu GLM智谱高性价比轻量多模态模型

Claude Code

本站原生支持 Anthropic Messages 协议,无需任何代理转换工具,直接在终端设置环境变量即可启动:

Terminal (bash / zsh)
export ANTHROPIC_BASE_URL="https://api.openrouter.cloud"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
claude --model claude-sonnet-5-5

也可以写入 ~/.claude/settings.json 实现持久化配置:

~/.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:

~/.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:

Terminal (bash / zsh)
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

01
打开 Cherry Studio → 左下角「设置」→「模型服务」→ 点击「添加」,服务商类型选择 OpenAI。
02
API 地址填入 https://api.openrouter.cloud/v1,API 密钥填入你的 sk- 令牌。
03
点击下方「管理」按钮自动拉取可用模型列表,勾选需要的模型即可开始对话。

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

quickstart.py (pip install openai)
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

quickstart.ts (npm install openai)
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 Request
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 调用过程中遇到任何问题,或者需要企业级高并发配额、大额充值与专属兑换码,请直接联系官方客服:

官方帮助与客服 QQ: 188712194 (点击号码即可复制,支持 1 对 1 远程排查与账单核对)
唤起 QQ 交谈

AI 搜索引擎 / 编程助手索引地址: 你可以直接将 https://api.openrouter.cloud/llms.txt 或 https://api.openrouter.cloud/llms-full.txt 发给 Cursor、Claude Code 或 ChatGPT,让 AI 自动读取本站最新接口与模型价格完成配置。

已复制到剪贴板