本地错误码说明

本文档列出客户可能在 error.code 中看到的网关本地错误码。上游供应商原始错误码不在此列表中；当上游错误被网关屏蔽时，响应消息会使用统一的公开错误信息。

错误响应格式

{
  "error": {
    "message": "prompt is required",
    "type": "new_api_error",
    "param": "",
    "code": "invalid_request"
  }
}

本地错误码

错误码	中文释义
`invalid_request`	请求参数错误，通常是缺少必填字段、字段类型错误或请求体格式不符合接口要求。
`sensitive_words_detected`	请求内容命中敏感词或内容安全规则，已被网关拦截。
`violation_fee.grok.csam`	请求命中特定违规内容计费规则，网关已按违规扣费策略处理。
`count_token_failed`	网关计算请求 Token 失败。
`model_price_error`	模型价格或计费配置异常，无法完成本次请求计费。
`invalid_api_type`	渠道 API 类型无效或当前接口不支持该 API 类型。
`json_marshal_failed`	网关序列化请求或响应数据失败。
`get_channel_failed`	网关选择或初始化可用渠道失败。
`gen_relay_info_failed`	网关生成请求转发上下文失败。
`read_request_body_failed`	网关读取请求体失败，常见原因是请求体过大或连接中断。
`convert_request_failed`	网关转换请求格式失败。
`access_denied`	访问被拒绝，通常是令牌、IP 白名单、权限或访问策略不满足要求。
`bad_request_body`	请求体内容无效或无法按目标接口解析。
`query_data_error`	网关查询本地数据失败。
`update_data_error`	网关更新本地数据失败。
`insufficient_user_quota`	用户额度不足，无法完成预扣费或本次请求。
`pre_consume_token_quota_failed`	预扣费失败，通常与用户额度、订阅额度或账户状态有关。
`api_not_implemented`	当前接口或路径暂未实现。
`model_not_found`	请求的模型不存在或当前用户不可访问。
`server_error`	网关本地服务处理失败。
`task_not_exist`	任务不存在，或当前用户无权访问该任务。
`task_channel_disable`	任务原始渠道已被禁用，无法继续使用该渠道查询或处理任务。
`channel_not_found`	任务关联渠道不存在或无法读取。
`invalid_api_platform`	任务平台类型无效，网关无法匹配对应适配器。
`model_mapping_failed`	模型映射失败，无法将请求模型映射到上游模型。
`invalid_relay_mode`	任务查询或提交模式无效。
`invalid_channel_id`	任务关联渠道 ID 无效，无法完成任务查询或格式转换。
`not_implemented`	当前任务平台暂不支持该功能或返回格式。
`setup_locked_channel_failed`	设置任务锁定渠道上下文失败。
`unsupported_model`	当前任务渠道不支持请求的模型。
`unsupported_resolution`	当前任务渠道或模型不支持请求的分辨率。
`invalid_channel_key`	渠道密钥格式或配置无效。
`task_failed`	任务在网关侧或已确认的任务处理阶段失败。
`empty_task_id`	上游或适配器未返回有效任务 ID。
`asset_error`	素材库相关接口处理失败。

说明

message 是面向客户展示的错误说明，可能包含更具体的失败原因。

code 为空或不在上表时，通常表示接口未提供明确本地错误码，或错误来自上游供应商并已按公开策略处理。

业务侧建议优先根据 HTTP 状态码和 error.code 做稳定判断，不要依赖完整 message 文本匹配。

错误响应格式#

本地错误码#

说明#

错误响应格式

本地错误码

说明