错误码
统一错误体 {"error": {"code", "message"}},响应带 X-Request-Id。限流三层(请求频率 / 并发分析 / 机构配额),超出返回 429 与 Retry-After。
| HTTP | code | 处理 |
|---|---|---|
| 400 | invalid_request | 检查参数 Schema |
| 401 | invalid_credentials / token_expired | 检查凭证 / 重新取 Token |
| 403 | scope_denied / entitlement_suspended | 联系运营开通 |
| 404 | not_found / algorithm_not_found | ID 不存在或未开放 |
| 409 | idempotency_conflict / interaction_conflict / run_not_terminal | 按语义处理 |
| 410 | download_expired / cursor_expired | 重新获取 |
| 413 | file_too_large | 改用分片直传 |
| 422 | input_validation_failed / asset_integrity_mismatch | 校验文件类型/大小/摘要 |
| 429 | rate_limited | 按 Retry-After 退避 |
| 503 | service_unavailable | 退避重试 |