认证

所有 API 请求需通过 API Key 进行身份验证。

API Key 格式

在请求头中携带 API Key：

Authorization: Bearer sk-your-api-key

安全特性

密钥哈希

API Key 使用 SHA-256 哈希后存储，完整密钥仅在创建时展示一次。

IP 白名单

限制 API Key 只能从指定 IP 地址使用：

每个 Key 最多配置 10 个 IP 地址或 CIDR 段
白名单为空 = 不限制（所有 IP 可用）
在 Dashboard > API Keys 中管理

消费限额

设置消费上限，防止意外扣费：

限制	说明
每小时	每小时最大消耗积分数
每天	每天最大消耗积分数
总量	该 Key 累计最大消耗积分数

Key 管理

禁用：临时停用，不删除
删除：永久删除
轮换：创建新 Key，禁用旧 Key

错误响应

状态码	错误码	说明
401	`invalid_api_key`	Key 无效、已禁用或已删除
403	`ip_not_allowed`	请求 IP 不在白名单中
429	`spend_limit_exceeded`	超出 Key 消费限额