API v1

限流与额度

请求频率、大请求并发、余额和素材额度都可能让新请求被拒绝。

查看 Markdown
本页内容

请求频率、素材接入容量、存储额度、API 密钥额度或余额都可能拒绝新请求。按错误码处理这些限制;文档不写死具体数字。

频率限制

请求太频繁时返回 429 rate_limited。响应可能带 Retry-After(1–3600 秒),等这么多秒后用同一个 Idempotency-Key 重试。

大请求并发

请求体大于 2 MiB 的创建请求,每个团队同时处理的数量有上限;满额时返回 429 rate_limited,这时不带 Retry-After,稍后重试即可。大请求体要在 120 秒内传完。

余额和 API 密钥额度

余额不够预留时返回 429 insufficient_balance,error.details 给出所需的预留金额;充值后用同一个键重试。API 密钥设有额度时,用完后新请求同样会被拒绝,按返回的错误码处理。

素材额度

  • 429 asset_storage_quota_exceeded:团队的素材存储额度已用完,Retry-After 不适用。
  • 429 asset_intake_rate_limit_exceeded:素材接入容量受限,稍后重试。

暂停接入

503 funding_intake_closed 表示暂时不接受新任务;已经接受的请求原样重放仍返回原响应。稍后再试。

下一步