错误码

所有接口的错误响应统一为一个 error 对象，含 message、type、code 三个字段。排查问题时请提供 error.message 末尾括号里的 request id。

错误响应格式

模型接口：

{
  "error": {
    "message": "模型 gpt-5.4-mini-typo 当前不可用：请核对调用名是否与模型广场一致（区分大小写）；名称无误则为线路暂时故障，请稍后重试。 (request id: 2026092121260443445983882)",
    "type": "new_api_error",
    "code": "model_not_found"
  }
}

鉴权失败时（Key 缺失、写错或已删除）返回 401，type 为 new_api_error、code 为空字符串，message 为中文提示「本次请求鉴权未通过…」并带本次请求 ID：

{
  "error": {
    "code": "",
    "message": "本次请求鉴权未通过；仅凭此错误无法确认是 本站令牌还是上游凭据问题，也不能据此判断 云上创造 API Key 已失效。请核对请求鉴权配置，具体以错误 code 与控制台令牌状态为准；持续失败请联系站方。 (request id: 202610040133100287101778268d9d6esaiHA3z)",
    "type": "new_api_error"
  }
}

常见错误码

会话绑定错误码（session_*）

只在使用会话绑定（请求头 X-CA-Session-ID，见 会话亲和；本站已开启）时出现。都是在发往上游之前返回，不扣费，会话绑定本身保持不变：

常见中文提示

下面几种情况，error.message 会是固定的中文提示（末尾仍带 (request id: …)），状态码、type、code 不变：

排查建议

• ·收到 400 时先看 error.message，会说明出错的字段或该怎么改
• ·400 多数是请求本身有误，重试不会成功；个别 400（「暂未开放调用」）需联系站方开通。429 与 5xx 可按指数退避重试（upstream_acceptance_unknown 除外：先确认上一次是否已生效）
• ·流式请求的错误分"流开始前"与"流开始后"两种，见 流式输出
• ·找站方排查时，把 error.message 末尾的 (request id: …) 一起发来，能直接定位到那一次请求
• ·换通道试试：连不上、超时、响应明显变慢或收到空响应时，把 Base URL 在国内通道 https://api.acapi.top 与国外通道 https://acapi.top 之间换一个再试（API Key、模型名不用改，两个地址模型完全一样），见 协议选择 的「通道选择」