接口文档

密钥泄露

当你的某把密钥出现在 GitHub 的公开仓库中时，GitHub 会在数秒内通知本站，该密钥随即被停用，并向账号绑定的邮箱发送邮件，说明是哪一把密钥、在何处被发现。

被停用的密钥立即失效，仍携带该密钥的请求一律返回 401 未授权。账号、余额及其余密钥不受影响。

后续处理

1. 在控制台新建一把密钥，替换应用中正在使用的那一把。
2. 从代码中移除旧密钥。仅删除该行并不足够：密钥仍留存于仓库的历史记录中，需重写历史记录，或将该密钥视为已永久公开。
3. 不要将密钥写入源代码。请从环境变量或密钥管理服务中读取，并将存放密钥的文件写入 .gitignore。

自行发现泄露时

可在控制台自行停用该密钥，停用立即生效，随后新建一把替换。若怀疑该密钥已被他人使用，请联系我们，本站可与你一同核对该密钥的调用记录。

流式返回

将 stream 设为 true 即可边生成边返回（server-sent events），格式与 OpenAI 接口一致，各家官方客户端均直接支持。

from openai import OpenAI

client = OpenAI(api_key="YOUR_API_KEY", base_url="/v1")
stream = client.chat.completions.create(
    model="MODEL_ID",
    messages=[{"role": "user", "content": "Hello!"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

流式请求的计费方式相同：最后一个数据块携带用量数值，按你发送与收到的文字计算，并按该数值扣除。

图片输入

可识别图片的模型支持在用户消息中附带图片：将文字与每张图片分别作为 content 数组中的一项，图片使用 base64 编码的 data URL。

{
  "model": "MODEL_ID",
  "messages": [{
    "role": "user",
    "content": [
      { "type": "text", "text": "What is in this picture?" },
      { "type": "image_url",
        "image_url": { "url": "data:image/jpeg;base64,/9j/4AAQ..." } }
    ]
  }]
}

当前可识别图片的模型： 正在加载模型列表…

除文字外，每个请求中的每张图片另外消耗 300 额度。一次请求最多携带 8 张图片，格式须为 PNG、JPEG、WebP 或 GIF，单张不超过 3 MB。向无法识别图片的模型发送图片时，会返回 model_no_vision 错误，且不扣除额度。图片仅转交模型服务商用于生成回答，本站不保存。

可用模型

以下为当前可调用的模型。花费一列为实测数据，并非承诺：取单次回答在 30 天内的平均花费，回答较长时花费更多，较短时更少。

同一份列表（含各模型的服务商，以及一天的签到能用多久）也可在模型页面查看。如需在代码中获取列表，使用密钥调用模型列表接口：

curl "/v1/models" \
  -H "Authorization: Bearer YOUR_API_KEY"

额度与上限

额度按 token 计量，1 额度对应 1 token。每天签到一次即可领取，连续签到领取的数量逐日递增；在控制台完成问卷可在此基础上叠加，邀请好友双方另有奖励。

余额可随时在控制台查看，也可在代码中查询：

curl "/api/me" \
  -H "Authorization: Bearer YOUR_API_KEY"

错误码

所有失败均返回 JSON，其中含固定的 code 字段。请以 code 作为判断依据，不要依赖 message 字段，后者面向阅读，措辞可能调整。

{
  "error": {
    "code": "not_enough_credit",
    "balance": 120,
    "need": 1500,
    "message": "..."
  }
}

常见问题