错误码

本文列举您调用火山方舟 API 可能会涉及的错误码信息，包含方舟错误码和公共错误码。

推理错误码#

精调错误码#

本部分将介绍模型精调相关的错误码信息及其建议的解决方案。

Managed Agent 错误码#

本部分列举 Managed Agent 相关接口的错误码信息。Managed Agent 的错误按下发通道分为两类：

• HTTP 阶段错误码：由 HTTP 请求同步返回，携带 HTTP 状态码与结构化错误体，适用于所有同步接口（如 POST create、POST events）。
• SSE 阶段错误码：请求已进入事件流后由服务端通过 data.type = "session.error" 事件下发，无 HTTP 状态码，仅在 RunFailed / SessionError 与 SSE resume/lag 场景出现。

HTTP 阶段错误码#

SSE 阶段错误码#

请求进入事件流后发生的错误，以 data.type = "session.error" 事件通过已建立的 SSE 通道下发，不携带 HTTP 状态码。仅在以下场景出现：runtime 判定 RunFailed / SessionError，或 SSE resume / lag 通道自身错误。事件示例（SSE wire format，片段）：

1
2
3
4
5
6...

id: sevt-...
data: {"type": "session.error", "id": "sevt-...", "processed_at": "2026-07-17T15:02:00+08:00", "error": {"type": "unknown_error", "message": "Tool execution failed due to a runtime issue."}}

...

其中 data: 后的 JSON 负载展开如下：

1
2
3
4
5
6
7
8
9{
  "type": "session.error",
  "id": "sevt-...",
  "processed_at": "2026-07-17T15:02:00+08:00",
  "error": {
    "type": "unknown_error",
    "message": "Tool execution failed due to a runtime issue."
  }
}

客户端分类规则：以 error.type 作为程序判别的唯一字段——所有分支都会携带该字段。error.message 仅供展示，不作为程序分类依据。

公共错误码#

查询火山引擎的 公共错误码。