故障定位

常见错误

先保存 request_id,再根据状态码检查鉴权、余额、渠道和上游响应。

401 / invalid_api_key
原因

API Key 不存在、填错、被删除,或没有使用 Bearer 认证格式。

处理

重新复制令牌,确认请求头格式为 Authorization: Bearer sk-...。请求头前后的空格会被自动忽略。

403 / insufficient_user_quota
原因

用户余额或订阅额度不足,系统会在请求前做预扣费保护。

处理

充值、开通订阅、降低模型价格,或换用更低成本模型。

503 / No available channel
原因

当前分组下没有可用渠道支持该模型,或渠道被禁用、额度不足、上游分组无权限。

处理

检查渠道模型、分组、渠道优先级、渠道状态和上游账号权限。

400 / video_billing_rule_not_configured
原因

当前模型不支持请求中的输入类型、分辨率或时长组合。

处理

按错误信息列出的支持值修改参数,或在模型广场更换模型和分组。

400 / virtual_portrait_channel_unavailable
原因

素材绑定的原渠道已停用,或该渠道不再支持对应素材协议和类型。

处理

在素材库重新上传原文件,系统会自动选择可用渠道并生成新的素材 ID。

429 / rate limit
原因

上游限流或本系统限速触发。

处理

稍后重试,增加备用渠道,或调整渠道权重和频率限制。

bad_response_body
原因

上游返回了 HTML、损坏 JSON 或流式响应提前中断。

处理

检查 Base URL 是否正确、上游是否稳定,并在使用日志中查看 request_id。

开始接入

创建令牌、下载脚本,然后在客户端发起请求即可。