限流与额度
请求频率、大请求并发、余额和素材额度都可能让新请求被拒绝。
本页内容
请求频率、素材接入容量、存储额度、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 表示暂时不接受新任务;已经接受的请求原样重放仍返回原响应。稍后再试。