错误码

HOYOAI 错误响应一般为 JSON。OpenAI 兼容路径常见形态：

{
  "error": {
    "message": "...",
    "type": "...",
    "code": "..."
  }
}

部分路径可能带 request id，排查时请一并提供。

HTTP 状态

状态	含义	建议
400	参数错误	检查 JSON、必填字段、模型名
401	未授权	检查 Bearer Key
403	禁止访问	检查账号 / 令牌权限
404	路径或资源不存在	检查 Base URL 与路径
429	限流	退避重试、降低并发
5xx	上游或网关异常	稍后重试；持续失败联系支持

业务侧建议

• 对 429 / 5xx 做有限次指数退避
• 记录 request id、模型名、时间戳便于对账
• 不要把完整 Key 打进日志