疑难杂症

按报错整理的排查方法。每个报错末尾都带有 request id，联系客服时附上它可以最快定位问题。

建议的排查顺序

1. 先用 curl 直接测（命令见使用教程 · OpenAI 格式）：curl 能通，说明密钥和接口正常，问题在工具配置；
2. 再查工具配置：接口地址、密钥、模型名、分组是否对应；
3. 最后看控制台：「使用日志」和余额、密钥额度。

401 · 无效的令牌

{"error":{"message":"无效的令牌 (request id: ...)"}}

• 密钥复制不完整，或漏了 sk- 前缀；
• 密钥已被删除、禁用或已过期，到API 密钥页面查看状态；
• 请求头写错：OpenAI 格式用 Authorization: Bearer sk-...，Anthropic 格式用 x-api-key: sk-...；
• Claude Code：确认环境变量已生效，或改用 settings.json 配置。

403 · 额度不足

{"error":{"message":"token quota is not enough, token remain quota: ...","code":"pre_consume_token_quota_failed"}}

• 该密钥设置的额度上限已用完：在API 密钥中调高额度或设为无限额度；
• 账户余额不足：请先充值。

503 · 无可用渠道

{"error":{"code":"model_not_found","message":"分组 claude-max 下模型 gpt-6-sol 无可用渠道 ..."}}

• 分组不对：例如用 claude-max 分组的密钥调用 GPT 模型，或用 deepseek 分组的密钥调用 GLM 模型。换用对应分组的密钥，或使用 default 分组；
• 模型名写错：模型 ID 必须与模型列表完全一致，例如 claude-sonnet-5、gpt-6-sol、deepseek-v4-pro、glm-5.3。

404 · 接口地址错误

{"error":{"message":"Invalid URL (POST /v1/v1/messages)"}}

• Claude Code / Anthropic SDK：地址填 https://aixvaro.com，不要带 /v1，否则会变成 /v1/v1/...；
• Codex / OpenAI SDK / 大多数客户端：地址填 https://aixvaro.com/v1，需要带 /v1；
• Codex 还需在配置中设置 wire_api = "responses"。

429 / 5xx · 请求过多或上游繁忙

• 短时间内请求过多触发限流，稍后重试，或降低并发；
• 模型服务商临时繁忙（如 529 Overloaded、500），通常片刻后恢复，建议在代码中加入重试；
• 持续出现请联系客服，并附上 request id 和发生时间。

请求超时或回复中断

• 检查本地网络与代理，确认能正常访问 https://aixvaro.com；
• 长回复建议使用流式输出（"stream": true），避免一次性等待过久被客户端或代理断开；
• 客户端自身的超时设置过短时，适当调大。

DeepSeek / GLM

视频生成（MiniMax-H3）

{"error":{"message":"MiniMax-H3 only accepts public http(s) media URLs; file uploads and data: URLs are not supported"}}

• 素材必须是公网链接：不支持直接上传文件或 data: Base64。请先把图片 / 视频 / 音频上传到图床或对象存储，再填入 https:// 链接；
• duration must be an integer between 4 and 15 seconds：seconds 只能是 4–15 的整数；
• supports up to 768P：目前只支持 768P，size 改成 768P 或省略；
• cannot mix frame images with reference media：首尾帧与参考素材不能同时使用；
• 任务状态变为 failed：常见原因是素材链接无法公开访问（需要登录、防盗链、已过期）、图片尺寸过小或提示词未通过内容审核。失败任务不扣费，调整后重新提交即可；
• 下载视频报错：只有 status 为 completed 的任务才能下载，请先查询任务状态；未完成或已失败的任务没有视频文件。

客户端相关

以上都无法解决？请到获取支持联系我们。