入门认证

认证

除 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 密钥。

bash
# 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 密钥也无法登录网站。两者都要保密:任何持有账户号码的人都能控制该账户及其额度。

错误

处理请求时,最先检查的是账户状态。

状态码错误码含义
401invalid_api_key未发送密钥,或密钥格式错误、不存在、已撤销或已过期。
403account_suspended账户已被暂停。暂停结束前,该账户的所有密钥都会被拒绝。
403account_banned账户已被封禁。其密钥已被撤销,剩余额度作废。

完整列表见错误页面。

请求 ID

每个响应(包括错误响应)都带有 x-request-id 响应头。联系支持或报告问题时,附上这个 ID。凭它我们可以找到该请求的元数据(时间、密钥、模型、token 数、费用、状态和延迟),这些元数据保留 30 天。我们不存储提示词或输出内容(见《隐私政策》),所以请求 ID 是定位某个具体请求的唯一方式。