文档概述

• 本文档适用于平台所有模型 API 接口，包括OpenAI 兼容接口、Anthropic 兼容 Messages 接口。

• 错误分为三层：HTTP 状态码 + 协议层错误类型 + 平台自定义业务错误码。

• 流式接口重要特性：HTTP 返回 200 不代表业务调用成功；推理过程异常会在 SSE 流内部返回错误事件。

• 不同兼容协议对外返回的 JSON 结构不一样，但底层平台业务错误码语义统一。

错误响应通用约定

非流式错误响应格式

OpenAI 兼容格式示例

{
    "error": {
        "type:": "Invalid_request",
        "code": "missing_parameter",
        "message": "Missing required parameters"
    }
}

Anthropic 兼容格式示例

{
    "type:": "Invalid_request",
    "error": {
        "code": "missing_parameter",
        "message": "Missing required parameters"
    }
}

流式 SSE 错误响应格式

OpenAI 兼容格式示例

data: {"error": {...}}\n\n

Anthropic 兼容格式示例

data: {"type":"error","error":{...}}\n\n

备注：HTTP Status=200，SSE 流中返回错误事件，不会走到正常结束事件，随后返回data: [DONE]关闭流。

公共返回字段说明

http状态码总览表

业务错误码对照表

请求参数类错误（400状态码）

认证失败（401状态码）

无权限（403状态码）

找不到模型/请求内容（404状态码）

限流/限额（429状态码）

内部软件异常（500状态码）

过载/超时（503/504状态码）