错误码(新版) 本文介绍星辰TokenHub平台新版错误码。 适用范围:接入域名使用 或 文档概述 本文档适用于平台所有模型 API 接口,包括OpenAI 兼容接口、Anthropic 兼容 Messages 接口。 错误分为三层:HTTP 状态码 + 协议层错误类型 + 平台自定义业务错误码。 流式接口重要特性:HTTP 返回 200 不代表业务调用成功;推理过程异常会在 SSE 流内部返回错误事件。 不同兼容协议对外返回的 JSON 结构不一样,但底层平台业务错误码语义统一。 错误响应通用约定 非流式错误响应格式 OpenAI 兼容格式示例 plaintext { "error": { "type:": "Invalidrequest", "code": "missingparameter", "message": "Missing required parameters" } } Anthropic 兼容格式示例 plaintext { "type:": "Invalidrequest", "error": { "code": "missingparameter", "message": "Missing required parameters" } } 流式 SSE 错误响应格式 OpenAI 兼容格式示例 plaintext data: {"error": {...}}nn Anthropic 兼容格式示例 plaintext data: {"type":"error","error":{...}}nn 备注:HTTP Status200,SSE 流中返回错误事件,不会走到正常结束事件,随后返回data: [DONE]关闭流。 公共返回字段说明 字段 说明 type 错误类型 code 错误码 message 人类可读错误描述,文案会迭代变更,不要用于代码判断 http状态码总览表 HTTP 状态码 含义 说明 400 Bad Request 请求体格式错误、参数校验失败、参数非法 401 Unauthorized APIKEY认证失败 403 Forbidden 权限不足,无空间 / 模型调用权限 404 Not Found 接口地址不存在、模型不存在 422 Unprocessable Entity 参数语义校验失败,模型不支持该能力 429 Too Many Requests 限流、RPM/TPM 超限、配额耗尽 500 Internal Server Error 平台内部未知错误 503 Service Unavailable 模型服务过载、实例不可用 504 Gateway Timeout 超时 业务错误码对照表