🎉 每个积分包首次购买都有免费生成好礼 —— 最高 20 个 Lite 视频 + 20 张 Lite 图片 + 10 个 Medium 视频 + 10 张 Pro 图片 + 2 个 Pro 视频。

立即开始

错误与限制

每次失败都使用同一个信封。代码是稳定的;消息是英文回退内容,可以展示给用户。

响应
{
  "error": {
    "code": "insufficient_credits",
    "message": "You need more credits to generate."
  }
}

状态

  • 400

    典型代码
    invalid_request, prompt_too_long, invalid_reference_image
    该怎么办
    修复请求;不要原样重试
  • 401

    典型代码
    unauthorized
    该怎么办
    检查密钥;不要循环重试
  • 402

    典型代码
    insufficient_credits
    该怎么办
    充值积分;切勿重试
  • 403

    典型代码
    unauthorized
    该怎么办
    未付费创建密钥,或未开通高级版却请求音频
  • 404

    典型代码
    not_found
    该怎么办
    未知任务,或不属于此账户
  • 409

    典型代码
    invalid_request
    该怎么办
    Idempotency-Key 冲突;请使用新的密钥
  • 413 / 415

    典型代码
    invalid_request / unsupported_image_type
    该怎么办
    上传较小的 JPEG、PNG 或 WebP 文件
  • 429

    典型代码
    rate_limited
    该怎么办
    等待 Retry-After
  • 500 / 503

    典型代码
    internal
    该怎么办
    使用退避策略重试

一次失败的生成是一个 200 作业响应,带有 status: "failed" 和一个代码为 internal 的 error 对象。已完成的作业即终态:请勿重新提交。

重试策略

  • 仅重试 HTTP 429、timeout 和 internal 响应。
  • 永远不要重试 insufficient_credits,也永远不要重新提交已经以 failed 结束的任务。
  • 在创建操作中使用 Idempotency-Key,这样重试就不会重复扣费。
  • 以指数方式退避,并加入抖动,起始时间约为一秒。

速率限制

限额按密钥计算,采用固定的一分钟窗口,除非另有说明。默认值:

  • 每分钟60个请求(整体)。
  • 每分钟可生成10次。
  • 每分钟 5 次上传。
  • 120 GET /v1/models 请求/分钟 每个客户端 IP(该路由是公开的)。
  • 每个账户每小时可创建5次API密钥。

429 携带 X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset 和 Retry-After。

可用性

如果 /v1 暂时不可用,每个路由都会返回 503,代码为 internal。请稍后以退避策略重试。

© 2026 DreamUtopia。保留所有权利。