错误与限制

精简说明；限流阈值、配额与错误体细节以控制台与现网响应为准。

鉴权

现象	说明
401	缺少 / 错误 / 已禁用的密钥
余额 / 额度不足	控制台充值与账单；具体状态码以现网为准

文本

现象	说明
model 不存在 / 无权限	核对控制台可用模型与 GET /v1/models
400 / 429	见响应 error.message / type / param / code
上游超时 / 5xx	保留时间与响应体，经控制台或企业渠道反馈

视频

现象	说明
400 missing_prompt / invalid_size / invalid_seconds	检查 prompt、model、seconds（自营视频须为 4–15 整数）、size
400 multipart_not_allowed	出片勿再 multipart 传文件；先 POST /v1/files 再传返回的 https url
409 not_ready	成片未就绪就拉 /content；等 completed
任务长期 queued	队列繁忙；保留 id 与时间反馈

限流与并发

RPM / TPM / 视频并发等公开文档未固化 → 待确认（以控制台与实际 429 为准）。

排查清单

1. Base 是否为 https://api.qingxiaocloud.com。
2. Header 是否为 Authorization: Bearer sk-…（Anthropic 另需 anthropic-version）。
3. model id 是否在控制台当前可用。
4. 视频是否已 completed 再下载 content。
5. 控制台余额与密钥状态是否正常。