错误码 - 阿里云百炼

调用出错时，服务返回如下结构的错误响应，request_id 与响应头 x-request-id 一致：

{
  "type": "error",
  "error": {
    "code": "AGENT_001",
    "message": "智能体不存在"
  },
  "request_id": "35feaacc-7914-948f-a38e-010bf8095bc1"
}

常见错误码

code	HTTP 状态码	说明
AGENT_001	404	智能体不存在
400	400	参数校验失败，`message` 给出具体原因（如 `limit must be between 1 and 100`）
InvalidApiKey	401	未携带或 API Key 无效（网关层）
Endpoint.AccessDenied	403	工作空间不存在或无权限（网关层）
BadRequest.IllegalEndpoint	400	工作空间路由无效（网关层）

鉴权与工作空间路由类错误由网关直接返回，响应结构为扁平的 {"request_id", "code", "message"}；业务错误由服务返回，error.code 为业务错误码。

排查问题时，可使用 request_id 定位具体请求；继续调用请对照概览的接口清单。