API 使用标准 HTTP 状态码表示请求是否成功。Documentation Index
Fetch the complete documentation index at: https://docs.keevx.cn/llms.txt
Use this file to discover all available pages before exploring further.
重要：HTTP 状态码表示传输层状态，具体业务结果以响应体中的
code 字段为准。请始终结合响应 JSON 中的 msg 字段查看具体错误信息和细节。HTTP 状态码
以下是 API 常用的 HTTP 状态码，用于表示连接或请求状态。| HTTP Code | 含义 | 说明 |
|---|---|---|
| 200 | OK | 请求成功（包括同步返回结果或异步任务提交成功）。 |
| 400 | Bad Request | 参数无效（如缺少必填字段、JSON 格式错误）。对应业务码 100xxx。 |
| 401 | Unauthorized | 认证失败（缺失、无效或已撤销的 API Key）。对应 401xxx。 |
| 402 | Payment Required | 配额不足、余额耗尽或套餐过期。对应 402xxx。 |
| 403 | Forbidden | 访问被拒绝（如账号冻结、App ID 被禁用或访问未授权资源）。 |
| 404 | Not Found | 资源不存在（API 路径无效）。对应 404xxx。 |
| 413 | Payload Too Large | 上传文件大小超过系统限制。 |
| 429 | Too Many Requests | 超过速率限制（QPS limit）。对应 429xxx。 |
| 500 | Internal Server Error | 系统内部错误。对应 5xxxx。 |
业务错误码
JSON 响应中的code 字段表示具体业务错误。
| Code | Message |
|---|---|
| 0 | Success（成功） |
| 100001 | 请求参数绑定失败 |
| 100002 | 参数校验失败（如 model 不存在、大小超限） |
| 130005 | 请求过于频繁 |
| 400001 | 路径格式无效 |
| 400002 | 版本无效 |
| 400003 | 模块名无效 |
| 400005 | 请求参数无效（缺少 auth 信息或 body） |
| 401001 | 缺少 Authorization 信息 |
| 401002 | Unauthorized（API Key/Token 无效） |
| 402000 | 配额冻结失败 |
| 500001 | 服务不可用 |
| 500002 | 数据库错误 |
| 500003 | 代理错误 |
| 500004 | 任务创建失败 |
| 530002 | 服务器繁忙 |
| 530003 | 服务器内部错误 |