你的工具，一把密钥即可接入。

密钥泄露

当你的某把密钥出现在 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:
    if chunk.choices:
        print(chunk.choices[0].delta.content or "", end="")

流式请求与非流式请求采用相同的计费规则。按 token 计费的模型包含服务商报告的输入、输出及模型思考用量；usage 中的数值不是美元扣费金额。最终费用请查看「计费与上限」及用量记录。

图片输入

可识别图片的模型支持在用户消息中附带图片：将文字与每张图片分别作为 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..." } }
    ]
  }]
}

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

当前计费规则读取中，请在发送前确认模型价格。

其他接口

同一把密钥还可以调用下列接口，按其他服务商请求格式编写的工具也能直接接入本站。以下接口均使用 POST 方法；除表中另有说明外，密钥均以 Bearer 形式放在 Authorization 请求头中。

视频

POST /v1/videos 根据一句话生成带声音的短视频。请求体为 JSON，字段如下：

curl "/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "A lighthouse on a cliff at dusk, waves breaking below",
    "seconds": 5,
    "size": "1280x720"
  }'

接口会立即返回，内容包括视频编号、状态 in_progress 和进度 0：

{
  "id": "video_abc123",
  "object": "video",
  "model": "MODEL_ID",
  "status": "in_progress",
  "progress": 0,
  "created_at": 1760500000,
  "seconds": 5,
  "size": "1280x720"
}

之后反复请求 GET /v1/videos/{id}，直到 status 变为 completed（返回中另含 url 和 completed_at）或 failed（返回中含 error，内有 code 与 message）。生成可能需要数分钟，请持续查询原任务状态，不要重复提交。GET /v1/videos/{id}/content 用于下载 MP4 文件。

curl "/v1/videos/video_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -L "/v1/videos/video_abc123/content" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o video.mp4

视频按秒从余额扣费，单价取决于分辨率，仅在视频生成成功后扣费；生成失败不收费。当前可用的模型与价格：

可用模型

以下为当前可调用的模型。免费模型不收费，按调用次数限制；其余模型的花费为实测数据，并非承诺：取单次回答在 30 天内的平均花费，以美元计，回答较长时花费更多，较短时更少。

模型由不同第三方服务商提供，但请求格式一致，切换模型只需修改代码中的模型名。模型列表可能随时调整，请勿将模型名硬编码在代码中，建议运行时从接口读取。

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

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

计费与上限

当前计费规则读取中，请在发送前确认模型价格。

各模型的价目见价格页

余额可随时在「我的」页查看，也可在代码中查询。返回的 balance 为本站内部计量单位，除以 GET /api/info 中的 money.unitsPerUsd 即为美元：

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

错误码

所有失败均返回 JSON，其中含固定的 code 字段。请以 code 作为判断依据，不要依赖 message 字段，后者面向阅读，措辞可能调整。错误返回中的数量以本站内部计量单位表示；带有 need 或 balance 时，另附 needUsd 或 balanceUsd，为同一数量的美元值。原样重发仍会失败时（如密钥无效、余额不足、份额用完），响应另带 x-should-retry: false 头；仅 408、409、429 与 5xx 适合重试。遇到拒绝仍会重发的工具（Codex、omp，以及被拒后几秒内原样重发的流式请求）会收到一条写明原因的普通回复，以便其停止重发。

{
  "error": {
    "code": "not_enough_credit",
    "balance": 6000,
    "balanceUsd": 0.01,
    "need": 15000,
    "needUsd": 0.025,
    "reservation": true,
    "message": "Insufficient balance: the reservation ceiling for this request is $0.025 and your available balance is $0.01. Top up or reduce the request size and output limit."
  }
}

常见问题