认证
除 GET /v1/models 外,所有端点都需要 API 密钥。用以下任一请求头发送。两者在所有端点上都有效,用你的客户端默认发送的那个即可:
Authorization: Bearer $YOUR_KEY,OpenAI SDK 和大多数工具发送的是这个。x-api-key: $YOUR_KEY,Anthropic SDK 发送的是这个。
占位符:
$API_BASE为https://api.abliteratedllm.dev/v1,$API_ORIGIN为https://api.abliteratedllm.dev,$YOUR_KEY为你的 API 密钥。
# OpenAI style
curl $API_BASE/balance -H "Authorization: Bearer $YOUR_KEY"
# Anthropic style
curl $API_BASE/balance -H "x-api-key: $YOUR_KEY"API 密钥
在 API 密钥页面中创建、重命名、编辑和撤销密钥,该页面还会显示每个密钥的最后使用时间(精确到几分钟内)和已消费金额。
- 密钥由
sk-加上 48 个字母和数字组成。 - 密钥只在创建时显示一次。我们只存储它的带密钥哈希,因此无法再次显示。控制台通过前 10 个字符识别密钥。
- 每个账户最多可有 20 个有效密钥。撤销一个才能腾出名额创建新的。
- 每个账户每小时最多尝试创建 30 次密钥。超出后的尝试会收到 429
rate_limit_exceeded,并附带Retry-After响应头。 - 撤销密钥会在 30 秒内生效。
- 密钥可以设置过期日期。密钥会在该日期的 00:00 UTC 失效,之后的请求会收到 401
invalid_api_key,消息为This API key expired on 2026-12-31 00:00 UTC.。在撤销之前,你可以给已过期的密钥设置一个更晚的日期,让它重新可用。 - 在线体验使用自己的密钥,该密钥由系统为你管理,不会出现在列表中。
消费上限
每个密钥都可以设置每日上限、每月上限和累计预算,可任意组合。日和月均按 UTC 计算;累计预算统计的是自推出累计预算以来该密钥的消费(对于较早的密钥,此前的部分只计入其最近 30 天的用量)。请求转发之前,其最高可能费用(即速率限制与试用中描述的预扣)会加到该密钥在当期已消费的金额上。如果总额超过某项上限,请求会以 402 key_spend_cap_reached 失败,不产生任何费用;错误消息会指明是哪项上限(每日、每月或累计)。要给脚本或团队成员一个固定预算的密钥,上限是个好办法。GET /v1/balance 会报告每项上限的剩余额度。
账户号码与 API 密钥相互独立
16 位账户号码用于登录网站。它永远不能当作 API 密钥使用,API 密钥也无法登录网站。两者都要保密:任何持有账户号码的人都能控制该账户及其额度。
错误
处理请求时,最先检查的是账户状态。
| 状态码 | 错误码 | 含义 |
|---|---|---|
| 401 | invalid_api_key | 未发送密钥,或密钥格式错误、不存在、已撤销或已过期。 |
| 403 | account_suspended | 账户已被暂停。暂停结束前,该账户的所有密钥都会被拒绝。 |
| 403 | account_banned | 账户已被封禁。其密钥已被撤销,剩余额度作废。 |
完整列表见错误页面。
请求 ID
每个响应(包括错误响应)都带有 x-request-id 响应头。联系支持或报告问题时,附上这个 ID。凭它我们可以找到该请求的元数据(时间、密钥、模型、token 数、费用、状态和延迟),这些元数据保留 30 天。我们不存储提示词或输出内容(见《隐私政策》),所以请求 ID 是定位某个具体请求的唯一方式。