QUOTA
用量与配额
开放 API 目前通过「API Key 额度上限 + 账户余额」两道闸门控制用量，不限制单位时间内的请求频率。本文说明超额时的行为与客户端应有的调用习惯。
两道闸门
| 机制 | 控制对象 | 在哪里配置 | 超限表现 |
|---|---|---|---|
| 密钥额度上限 | 单个 API Key 的累计消费金额 | 创建 / 编辑密钥时设置，0 表示不限 | HTTP 402，错误码 190003 |
| 账户余额 | 整个账户的可消费金额 | 控制台钱包充值 | HTTP 402，错误码 120001 |
每次生成任务完成后，平台按实际成本（任务响应里的 cost_amount）扣减账户余额，并把金额累计到 提交任务的密钥的已用额度上。任一闸门超限，后续请求都会被拒绝。
超额时的响应
HTTP 402（密钥额度用尽）
{
"code": 190003,
"message": "API Key 额度已用尽",
"trace_id": "..."
}收到 190003 时在控制台调高该密钥的额度上限，或改用其他密钥；收到 120001 时先充值再重试。两者都不是临时性错误，不要无脑重试。
关于频率限制
目前开放 API 没有启用请求频率限制，不会因为调用快而返回 429。为保证你自己和平台其他用户的体验，仍建议遵循以下调用习惯：
- 轮询生成任务状态时间隔 ≥ 3 秒，任务进入终态后立即停止轮询。
- 模型列表等相对静态的数据在本地缓存，不要每次请求都拉。
- 批量任务控制并发，避免瞬时把大量任务同时提交。
- 对 5xx 类临时错误（如
130003暂无可用渠道、130004上游调用失败）用指数退避重试。
若后续上线频率限制，相关规则会提前在本文更新。全部错误码见 错误码说明。