响应码 - Keevx API 文档

API 使用标准 HTTP 状态码表示请求是否成功。

重要：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	服务器内部错误

身份认证创建图生视频任务