Appearance
错误码与排查
| HTTP 状态 | 常见原因 | 处理方式 |
|---|---|---|
400 | 参数或 JSON 不合法 | 检查模型、提示词、时长、分辨率和比例 |
401 | API Key 缺失、错误、禁用或过期 | 检查 Authorization: Bearer ... |
402 | 余额或额度不足 | 充值、兑换或调整令牌额度 |
409 | 幂等键冲突 | 不同请求体必须使用不同 Idempotency-Key |
429 | 请求过于频繁 | 降低频率并使用指数退避 |
5xx | 服务或上游暂时不可用 | 保存 request_id,稍后重试 |
任务长时间未完成
- 使用
GET /v1/videos/{task_id}查询,不要重复创建任务。 - 检查状态是否为
queued、running或in_progress。 - 每 3–5 秒查询一次,避免高频轮询。
- 如果任务最终失败,保存原始 JSON 和
request_id以便排查。
请求支持时请提供
- 请求时间与时区。
- RouterBee 对外模型名称。
task_id和request_id。- 已脱敏的请求体与原始响应 JSON。
请勿提供完整 API Key、管理员令牌或供应商密钥。