错误码
接口概述
调用出错时统一返回 {"detail": "说明文字"}；如果错误来自模型，则返回 502 并保留其原始错误正文，便于定位原因。
状态码
| 状态码 | 含义 | 处理方式 |
|---|---|---|
| 200 | 成功 | - |
| 400 | 参数错误 | 检查请求体（模型名、必填字段、类型） |
| 401 | 未认证 | 缺少、拼错或已禁用的 API Key（控制台里创建的 sk- 开头 Key） |
| 402 | 余额不足 | 联系管理员在控制台手工授信 |
| 403 | 无权限 | 访问了仅管理员可用的接口 |
| 404 | 不存在 | 模型未上架 / 已停用；视频任务 id 不属于当前账号 |
| 409 | 状态冲突 | 视频任务尚未完成就调用了取结果接口 |
| 500 | 服务内部错误 | 请联系管理员 |
| 502 | 模型错误 | 模型返回 4xx/5xx 或连接失败，正文为其原始错误 |
示例
未认证：
{ "detail": "API Key 无效或已禁用" }
余额不足：
{ "detail": "余额不足，请联系管理员授信" }
模型报参数错误（502，保留原始正文）：
{
"detail": "模型服务返回错误 400：{\"error\":{\"message\":\"Field required: input.query\"}}"
}
常见报错速查
| 报错关键字 | 常见原因 |
|---|---|
| InvalidParameter / InvalidApiKey | 参数不合法、密钥失效 |
| model not found / not supported | 模型名写错（用广场卡片上的名字） |
| RateLimitExceeded | 触发限流，稍后重试 |
| insufficient_quota | 平台额度不足，请联系管理员 |
| 403 / 拦截页面 | 请求被风控拦截，稍后重试或联系管理员 |