API 文档
错误
稳定的错误包装、错误码和 HTTP 状态
错误使用固定包装,绝不会包含私有诊断信息:
{
"success": false,
"error": {
"code": "INVALID_REQUEST",
"message": "The request is invalid.",
"request_id": "req_012345"
}
}| HTTP | 错误码 | 含义 |
|---|---|---|
| 400 | INVALID_REQUEST | 请求体、表单字段、请求头或图片无效 |
| 400 | CONTENT_POLICY_VIOLATION | 请求无法处理 |
| 401 | UNAUTHORIZED | API 密钥缺失或无效 |
| 402 | INSUFFICIENT_CREDITS | 可用积分不足 |
| 403 | FORBIDDEN | 缺少所需权限或测试资格 |
| 404 | JOB_NOT_FOUND | 任务不存在或属于其他账户 |
| 409 | IDEMPOTENCY_CONFLICT | 同一幂等键对应不同内容 |
| 409 | JOB_CANCELED | 任务已取消 |
| 429 | RATE_LIMIT_EXCEEDED | 超过请求限制 |
| 500 | JOB_FAILED | 图片任务未能完成 |
| 500 | INTERNAL_ERROR | 请求未能完成 |
上传大小超限使用 HTTP 413,错误码仍为 INVALID_REQUEST。429 和非终态任务可按
文档延迟重试。其他错误应修改请求,或携带 request_id 联系支持;程序逻辑不要依赖
人类可读的 message。

API 文档