#CODE & 错误码

调用汇飞智能 API 时，错误响应分两类：

• 模型调用接口（/v1/*）：采用 OpenAI 兼容的错误对象，返回 HTTP 状态码 + {"error": {...}}。
• 控制台管理接口（/api/*）：采用 {"success": ..., "message": ...} 结构，业务错误时 HTTP 仍为 200。

#一、模型调用接口（/v1/*）

错误响应体统一为：

{
  "error": {
    "code": "model_not_found",
    "message": "No available channel for model no/such-model under group 国模 (distributor) (request id: ...)",
    "type": "huifly_error"
  }
}

#常见错误码

type 为 upstream_error 时，表示错误来自上游模型服务，通常可重试。遇到 429 或 5xx 建议采用指数退避重试（如 1s、2s、4s），或切换到其他可用模型。

#请求失败是否计费

仅对成功返回的请求计费。失败请求（含 4xx / 5xx）不会扣除额度；如因平台服务异常导致请求失败，也不会计费。

#二、控制台管理接口（/api/*）

管理接口（密钥管理、额度查询等）成功时返回：

{ "success": true, "message": "", "data": {} }

业务失败时 HTTP 仍为 200，但 success 为 false，失败原因见 message：

{ "success": false, "message": "record not found" }

鉴权、权限类错误由中间件返回，附带错误码：

{ "success": false, "code": "AUTH_UNAUTHORIZED", "message": "Unauthorized, invalid access token" }

管理接口的响应结构详见 API 密钥管理接口 与 API 密钥与额度查询接口。

#需要帮助？

如持续遇到错误，请提供响应中的 request id 或错误信息，联系对应商务/技术支持排查。