跳转到主要内容
排查失败时，先保存 HTTP 状态码和脱敏后的响应正文；响应中有 X-Maxx-Request-ID 时一并保留。错误可能包含 error.message、error.type、error.code 和 retryable，但不同接口的错误结构不完全相同，不要依赖每次都返回全部字段。
APIONE 请求日志错误排查入口

先在请求明细中定位失败记录，再结合状态、耗时、模型和请求 ID 排查。

按状态码处理

表格依据 APIONE 错误说明，具体判断以响应正文为准。模型参数接口也可能返回 {"error":"model not found"}，不能只读取 error.code。

定位顺序

  1. 确认 HTTPS 请求发往 api.apione.ai，按接口地址检查路径拼接。
  2. 用相同协议发送最小文本请求，核对模型 ID、密钥权限和余额。
  3. 最小请求成功后，逐项恢复可选参数，定位不兼容字段。
  4. 如果 cURL 成功而项目失败，检查环境变量、SDK 实际地址、重复的 /v1 和代理设置，见SDK 接入。

常见错误标识

重试原则

先修正配置、权限和余额错误。只对可恢复错误做有次数上限的重试，并核对 SDK 是否已自动重试，避免叠加请求。 流开始后仍可能失败，HTTP 200 不足以证明生成已完成。保留已收到的内容和错误，避免静默重发导致重复生成；见流式处理。

联系支持前

提供请求时间与时区、协议与端点、模型 ID、HTTP 状态、请求 ID、SDK 或客户端版本、脱敏错误正文及已重试次数。不要发送完整密钥或敏感业务内容。可直接使用反馈模板。