常见错误
401：认证失败
- 检查 API Key 是否完整。
- 检查请求头是否为
Authorization: Bearer <API_KEY>。 - 确认 Key 没有过期、禁用或删除。
403：没有权限
- 检查 API Key 分组是否支持目标模型。
- 检查额度、IP 和速率限制。
- 确认当前账户具有模型访问权限。
404：接口或模型不存在
- 文本请求使用
api.123uq.com。 - 生图和长任务使用
image.123uq.com。 - OpenAI 兼容客户端的 Base URL 包含
/v1。 - 模型名称与“可用渠道”页面完全一致。
- 避免拼成
/v1/v1。
429：请求过多或额度不足
- 检查账户余额和 Key 额度。
- 降低并发与请求频率。
- 使用带上限的指数退避重试。
500、502、503：服务异常
- 查看渠道状态和控制台公告。
- 稍后重试或切换备用分组。
- 记录请求 ID，不记录完整 API Key 或用户敏感内容。