错误码

响应示例

{
  "error": {
    "message": "Invalid or missing API key",
    "code": "unauthorized"
  }
}

响应仅用于说明结构；ID、用量、价格和结果以实际请求为准。

输出字段

400 · invalid_request

HTTP

请求体或参数取值不合法

401 · unauthorized

HTTP

缺少或无效的 API Key

402 · insufficient_credits

HTTP

积分不足

403 · invalid_request

HTTP

密钥或项目不允许调用该模型、供应商或请求来源。

404 · not_found

HTTP

模型或任务不存在

409 · not_cancelable

HTTP

任务无法取消（已结束，或该供应商不支持取消）

429 · rate_limited / concurrency_limit

HTTP

请求过于频繁，请稍后重试 · 该 API Key 进行中的任务过多，等部分任务完成后再提交

502 · upstream_error

HTTP

所有供应商都拒绝了任务（积分已退回）

503 · no_provider / upstream_error

HTTP

没有供应商支持这些参数

504 · timeout

HTTP

等待超时但图片仍在生成，请轮询 GET /generations/:id

使用说明

• 轮询间隔至少 3 秒。同步生图接口返回 504 时，任务可能仍在进行，应使用 error.id 查询，避免重复创建。