鉴权认证

所有端点均需 API 密钥。大多数端点使用 OpenAI 风格的 Bearer 鉴权;Claude 原生与 Gemini 原生协议使用各自专属的请求头。

获取密钥

登录控制台后,在API 密钥页面创建密钥。密钥形如:

sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
妥善保管

密钥是消费账户余额的凭证。切勿将其写入前端代码、公开仓库或客户端。如怀疑泄露,请立即在控制台删除并重新创建。

默认方式:Bearer Token

OpenAI 兼容端点(/v1/chat/completions/v1/images/* 等)统一使用:

Authorization: Bearer sk-xxxxxxxx

Claude 原生:x-api-key

使用 Anthropic 原生协议(POST /v1/messages)时,改用以下请求头:

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

详见 Claude Messages

Gemini 原生:x-goog-api-key

使用 Gemini 原生协议(/v1beta 路径)时:

x-goog-api-key: sk-xxxxxxxx

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

请求头速查表

协议 / 路径鉴权请求头
OpenAI 兼容 /v1/*Authorization: Bearer sk-...
Claude /v1/messagesx-api-key: sk-...
Gemini /v1beta/*x-goog-api-key: sk-...

鉴权失败

密钥无效或缺失时返回 401

{
  "error": {
    "code": "",
    "message": "Invalid token (request id: ...)",
    "type": "new_api_error"
  }
}