鉴权与 API Key

所有模型请求都需要 API Key。

请求头

OpenAI 兼容协议：

Authorization: Bearer <API Key>

Anthropic Messages 协议支持两种写法：

x-api-key: <API Key>

Authorization: Bearer <API Key>

推荐使用客户端默认的鉴权方式。例如 OpenAI SDK 使用 Authorization，Anthropic SDK 使用 x-api-key。

创建与管理

在控制台的令牌管理中，可以：

• 创建和删除 API Key。
• 设置有效期。
• 设置累计消费限额与分组。
• 设置 IP 白名单。
• 查看累计消费、消费限额和最近使用时间。

请将您创建的密钥保存在安全的地方，避免泄露造成的财产损失。

常见鉴权错误

状态码	含义	处理方式
401	缺少密钥、密钥无效或已过期	检查请求头与密钥状态
403	没有权限使用该模型或功能	检查密钥的模型限制与账号状态
404	模型不存在或不可用	检查模型 ID，或查看模型广场

安全建议

• 只在服务端或可信客户端中使用 API Key。
• 不要提交到 Git 仓库。
• 不要发送到聊天工具或截图。
• 为不同应用创建不同的 API Key，便于单独撤销。

如果密钥泄露，请立即删除该密钥并创建新密钥。

高级设置与停用

创建表单默认只展开名称。 打开 高级设置 可修改有效期、消费限额、IP 白名单和分组。 已有非默认高级字段的 Key，在编辑时自动展开这些设置。 停用需要确认；使用该 Key 的请求会立即失败，但可随时重新启用。 删除无法撤销，客户端必须更换 Key。