故障定位
常见错误
先保存 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。