错误码

以下是使用 Muxla API 时最常见的错误与排查方向。

常见错误

错误或现象	可能原因	处理方式
401 Unauthorized	Token 错误、缺失或已失效	检查 Authorization: Bearer 你的 Muxla Token 是否正确，必要时前往 Muxla 控制台 重新创建 Token
404 Not Found	Base URL、接口路径错误，或遗漏 /v1	确认 Base URL 使用 https://mux.la/v1，并检查请求路径是否正确
429 Too Many Requests	请求过快，触发频率限制	降低请求频率，加入重试和退避逻辑，稍后再试
502 / 503	上游模型或网关暂时不可用	稍后重试，并关注 Muxla 控制台 中的可用模型与渠道状态
模型不存在	模型名称填写错误，或模型当前不可用	从 Muxla 控制台 的模型列表中复制完整模型名称，不要手动猜测
余额不足	账户余额不足，无法继续请求	前往 Muxla 控制台 查看余额并充值后重试

排查顺序

建议按以下顺序检查：

1. Base URL 是否为 https://mux.la/v1
2. Token 是否有效
3. 模型名称是否从模型列表直接复制
4. 账户余额是否充足
5. 当前是否遇到 429、502 或 503 等临时性问题