鉴权认证
所有端点均需 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/messages | x-api-key: sk-... |
Gemini /v1beta/* | x-goog-api-key: sk-... |
鉴权失败
密钥无效或缺失时返回 401:
{
"error": {
"code": "",
"message": "Invalid token (request id: ...)",
"type": "new_api_error"
}
}