错误码
错误响应和成功响应使用同样结构。
{
"code": 422,
"msg": "model is not supported",
"data": null
}常见错误
| HTTP | Code | Message | 含义 |
|---|---|---|---|
400 | 400 | invalid request | JSON 请求体或查询参数不合法 |
401 | 401 | authentication failed | API Key 缺失、无效或已禁用 |
402 | 402 | insufficient credits | 用户积分不足 |
404 | 404 | task not found | 任务不存在,或不属于当前 API Key |
422 | 422 | 参数校验错误 | 模型或输入字段不支持 |
429 | 429 | rate limit exceeded | API Key 超过当前等级限流 |
500 | 500 | 服务端错误 | 内部服务或供应商错误 |
重试处理
创建任务时建议传入 X-Request-ID。如果你的服务端因为网络问题重试,同一个 request ID 可以返回已有任务,避免重复创建任务。