鉴权认证

所有端点均需 API Key。大多数接口使用 OpenAI 风格的 Bearer 鉴权；Claude 原生与 Gemini 原生协议使用各自专属的请求头。同一把 Key 在所有协议、所有端点上通用。

一、获取密钥

登录控制台后，在「API 密钥」页面创建密钥。密钥形如：

sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

创建时会选择路由方式（按厂家 / 按模型 / 全部模型与厂家），它决定这把 Key 能调用哪些模型，详见 API 密钥与路由。

妥善保管

密钥是消费账户余额的凭证。切勿写入前端代码、公开仓库或分发给终端用户。如怀疑泄露，立即在控制台删除并重新创建；也可以为 Key 设置 IP 白名单、过期时间与额度上限降低风险。

二、默认方式：Bearer Token

OpenAI 兼容端点（/v1/chat/completions、/v1/responses、/v1/images/*、/v1/embeddings 等全部 /v1/*）统一使用：

Authorization: Bearer sk-xxxxxxxx

使用官方 OpenAI SDK 时只需传 api_key，SDK 会自动加上这个请求头。

三、Claude 原生：x-api-key

使用 Anthropic 原生协议（POST /v1/messages）或 Anthropic SDK / Claude Code 时，改用以下请求头：

x-api-key: sk-xxxxxxxx
anthropic-version: 2023-06-01

环境变量写法：ANTHROPIC_BASE_URL=https://cn.chatapi.app、ANTHROPIC_API_KEY=sk-xxxxxxxx（Claude Code 也可用 ANTHROPIC_AUTH_TOKEN）。同一路径也接受 Authorization: Bearer。详见 Claude Messages。

四、Gemini 原生：x-goog-api-key

使用 Gemini 原生协议（/v1beta/* 路径）或 Google GenAI SDK 时：

x-goog-api-key: sk-xxxxxxxx

也可以通过查询参数 ?key=sk-xxxxxxxx 传递。详见 Gemini 原生。

五、请求头速查表

协议 / 路径鉴权请求头SDK 环境变量
OpenAI 兼容 /v1/*Authorization: Bearer sk-...OPENAI_API_KEY + OPENAI_BASE_URL=https://cn.chatapi.app/v1
Claude /v1/messagesx-api-key: sk-... + anthropic-versionANTHROPIC_API_KEY + ANTHROPIC_BASE_URL=https://cn.chatapi.app
Gemini /v1beta/*x-goog-api-key: sk-...GEMINI_API_KEY + GOOGLE_GEMINI_BASE_URL=https://cn.chatapi.app
Jev /v1/decisionsAuthorization: Bearer sk-...—

六、鉴权失败

密钥无效或缺失时返回 401：

{
  "error": {
    "code": "",
    "message": "Invalid token (request id: ...)",
    "type": "new_api_error"
  }
}
状态码常见原因处理
401Key 拼写错误、已删除、已过期、IP 不在白名单在控制台核对 Key 状态与白名单
403Key 的路由模式不包含该模型 / 厂家；或模型已下架换「全部模型」Key，或在「按模型」里勾选；用 GET /v1/models 看可用清单
429余额不足、Key 额度用尽或并发超限充值 / 调高额度 / 降低并发

全部文档