CloudCareEE IT服务管理
公告通知
关于 Gemini 2.5 Flash / Flash-Lite 模型下线的公告
关于 云上甄选系统(原 CloudCarePro 系统)升级公告
更新日志
产品简介
基础概念
账号体系
注册登录
密码重置
用户名找回
工作空间
基础信息
功能模块
首页看板
系统管理
账号管理
角色管理
配置管理
多云账号管理
公有云账号
观测云工作空间
观测云云巡检
CloudLinker账号
资产管理
资产组
资产同步
资产分类
资产成员
项目管理
项目计划
项目列表
项目成员
情报管理
情报概览
情报团队
情报策略(已废弃)
调度规则
情报汇总
情报设置
报告管理
报告列表
报告版本
定期报告
报告成员
流程审批
流程列表
流程模板
流程成员
云上甄选
账单详情
发票管理
知识库
知识库列表
知识库成员
回收站
OKR管理
目标概览
目标管理
目标对齐
周期管理
OKR成员
AI Hub
快速上手
概览
模型列表
API 密钥
调用记录
账户流水
账单管理
AI Hub成员
CloudCare助手
常见问题
H5微应用
钉钉群添加H5酷应用
飞书群H5卡片鉴权
钉钉消息卡片
钉钉消息卡片显示异常
报告说明
DMS运维报告
报告附加内容
阿里云资产全览报告(word)
配置文档
SSO单点登录配置
模型 API Key 配置
Workbuddy(腾讯)
CodeBuddy(腾讯)
TRAE Work(字节跳动)
TRAE SOLO(字节跳动)
LobsterAI(网易有道)
Dify 配置
使用 CC Switch 配置
AI Hub中转接口文档
错误响应汇总
API 接口清单
图片生成
图片生成调用文档
图片编辑调用文档
文本对话
Google 原生协议调用文档
OpenAI Chat Completions 调用文档
OpenAI Responses 调用文档
-
+
首页
错误响应汇总
# 错误响应汇总 本文汇总客户端可见的错误响应、提示文案及处理建议。 ## 1. 错误响应格式 OpenAI、Responses、Anthropic 入口及模型、账户、用量、任务查询等接口,使用统一错误输出时返回: ```json { "error": { "message": "invalid api key", "type": "ee_proxy_error", "code": "invalid_api_key" }, "request_id": "ee-ai-proxy-..." } ``` | 字段 | 说明 | | --------------- | ------------------------------------------------------------ | | HTTP 状态码 | 本次接口响应的 HTTP 状态 | | `error.code` | 字符串错误码,用于调用方判断错误类型 | | `error.message` | 用户可见提示,可能包含动态内容,不建议按完整文案匹配 | | `error.type` | 默认为 `ee_proxy_error`;渠道错误使用 `source_channel_error` | | `request_id` | 与响应头 `X-EE-Response-ID` 一致,存在时写入正文;反馈问题时请提供此值 | | `error.details` | 可选的错误详情,包含具体错误码 `code`、原因 `message` 和相关参数 `param` | 渠道错误包含具体原因时,`error.message` 会显示 `[具体错误码] 具体原因`,也可能只显示错误码或原因。可结合 `error.details` 查看详细提示。 以下表格中的 `{model}`、`{protocol}` 分别表示实际模型名和协议名,`{capabilities}` 表示接口要求的能力列表。未单独列出 `error.type` 的表格均使用 `ee_proxy_error`。 ## 2. 用户端错误码 ### 2.1 请求参数与调用方式 | HTTP 状态码 | `error.code` | `error.message` | 含义与处理 | | ----------- | ----------------------- | ------------------------------------------------------------ | ----------------------------------------------------------- | | 400 | `invalid_request` | 具体参数解析或请求规范化错误 | 检查请求体、模型字段和参数格式 | | 404 | `invalid_request` | `unsupported Google API method` | Google 模型接口路径或方法动作不受支持,检查 URL;正文使用 Google 原生格式 | | 400 | `model_capability_not_supported` | `model "{model}" does not support required capabilities: {capabilities}` | 模型不支持当前入口要求的能力,更换模型或使用匹配的接口 | | 400 | `invalid_async_mode` | `X-EEProxy-Async must be true or false` | 任务接口的异步模式请求头无效,使用单个 `true` 或 `false` 值 | | 400 | `unsupported_sync_mode` | `synchronous mode is currently supported only for image generation` | 请求了暂不支持的同步媒体模式,改用异步模式 | | 400 | `unsupported_protocol` | `unsupported relay protocol "{protocol}"` | 不支持该入口协议 | | 405 | `method_not_allowed` | `method not allowed` | 代理入口 HTTP 方法错误 | ### 2.2 身份认证与权限 | HTTP 状态码 | `error.code` | `error.message` | 含义与处理 | | ----------- | ------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | | 401 | `invalid_api_key` | `api-key is missing` 或 `invalid api key` | 凭证缺失或无效,检查 API Key | | 403 | `ip_not_allowed` | `client IP is not allowed for this api key` | 当前 IP 不在 API Key 白名单内,检查白名单配置 | | 403 | `model_not_allowed` | `model "{model}" is not allowed for this api key` 或 `model "{model}" is not enabled for this workspace` | API Key 无模型权限,或工作空间未启用模型,联系管理员调整授权 | | 403 | `workspace_not_available` | `workspace is not available` | 工作空间不可用,联系管理员检查配置 | | 404 | `model_not_found` | `model "{model}" not found` | 模型不存在或无法解析,检查模型名称;模型名为空时返回 `model "" not found` | ### 2.3 钱包、额度与限流 | HTTP 状态码 | `error.code` | `error.message` | 含义与处理 | | ----------- | ------------------------------- | ------------------------------------------------------------ | -------------------------------------------------------- | | 400 | `workspace_wallet_not_exit` | 工作空间未开通【ai-hub】账户或钱包,请联系管理员开通。 | 联系管理员开通账户或钱包 | | 402 | `insufficient_balance` | ⚠️ 空间账户余额不足,请及时充值后重试。 | 余额不足以完成预扣,充值后重试 | | 402 | `balance_below_threshold` | ⚠️ 空间账户余额不足,请及时充值后重试。 | 余额低于最低阈值,充值后重试 | | 429 | `api_key_amount_quota_exceeded` | `api key amount quota exceeded` | API Key 金额额度耗尽,调整额度或等待重置 | | 429 | `api_key_token_quota_exceeded` | `api key token quota exceeded` | API Key Token 额度耗尽,调整额度或等待重置 | | 429 | `monthly_money_quota_exceeded` | ⚠️ 本月配额已用尽,请联系空间管理员调整配额或等待次月自动重置。 | 月金额额度耗尽,调整额度或等待次月重置 | | 429 | `monthly_token_quota_exceeded` | ⚠️ 本月配额已用尽,请联系空间管理员调整配额或等待次月自动重置。 | 月 Token 额度耗尽,调整额度或等待次月重置 | | 429 | `workspace_rpm_rate_limited` | `workspace rpm quota exceeded` | 工作空间每分钟请求数达到限制,降低请求速率 | | 429 | `workspace_tpm_rate_limited` | `workspace tpm quota exceeded` | 工作空间每分钟 Token 用量达到限制,降低 Token 用量或并发 | ### 2.4 渠道与服务错误 | HTTP 状态码 | `error.code` | `error.type` | `error.message` | 含义与处理 | | ----------- | -------------------------- | ---------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | | 500 | `internal_error` | `ee_proxy_error` | `channel invocation error` | 未分类内部错误,提供 `request_id` 联系服务方 | | 503 | `no_channel` | `ee_proxy_error` | `no available channel for model` 或 `channel for model "{model}" does not support protocol "{protocol}"` | 没有满足模型、协议、额度等条件的可用渠道,联系管理员检查渠道 | | 503 | `service_draining` | `ee_proxy_error` | `service is draining` | 当前实例正在排空,稍后重试或切换健康实例 | | 503 | `channel_invocation_error` | `source_channel_error` | `channel invocation error` | 已选定渠道后发生普通调用异常,如网络或请求准备失败 | | 503 | `upstream_error` | `source_channel_error` | `channel invocation error` 或 `[具体错误码] 具体原因` | 上游响应异常,查看 `error.message` 和 `error.details` 中的具体提示,详见下文 | 遇到 `upstream_error` 时,先查看 `error.message`;如果响应中包含 `error.details`,可在这里查看具体原因和相关参数: | 字段 | 说明与处理 | | ---- | ---------- | | `error.details.code` | 具体原因的错误码,与外层 `error.code: upstream_error` 不同;可辅助区分参数、额度或内容限制等问题 | | `error.details.message` | 具体错误说明,优先按此提示排查 | | `error.details.param` | 与错误有关的参数名,存在时检查该参数的取值、格式或是否受模型支持 | 例如,某个参数不受支持时,可能返回以下响应(HTTP 状态码仍为 503): ```json { "error": { "code": "upstream_error", "type": "source_channel_error", "message": "[unsupported_parameter] Unsupported parameter: temperature", "details": { "code": "unsupported_parameter", "message": "Unsupported parameter: temperature", "param": "temperature" } }, "request_id": "ee-ai-proxy-..." } ``` 此时应检查模型是否支持 `temperature`,调整或移除参数后再试。 `error.details` 及其中的字段可能不完整或不存在。如果只收到 `channel invocation error`,没有具体原因,请按第 5 节提供信息联系我们。 ### 2.5 异步任务接口错误 | HTTP 状态码 | `error.code` | `error.message` | 含义与处理 | | ----------- | ------------------------ | ---------------------------------------------- | --------------------------------------------------- | | 403 | `async_task_not_allowed` | `async task is not accessible by this api key` | 当前 API Key 无权查询该任务,使用提交任务的 API Key | | 404 | `async_task_not_found` | `async task not found` | 任务不存在或任务 ID 格式无效,检查任务 ID | 任务提交和查询还可能返回上述鉴权错误或 `internal_error`。查询成功后,仍需检查任务执行结果,见第 3 节。 ## 3. 异步任务失败结果 `GET /v1/tasks/{task_id}` 返回 HTTP 200 表示查询成功,任务本身仍可能失败。客户端还需检查 `output.task_status` 和任务错误字段。 代理任务轮询超时的结果示例(任务正文还可能包含任务 ID 等字段): ```json { "output": { "task_status": "UNKNOWN", "code": "async_task_timeout", "message": "async task exceeded its query deadline" } } ``` 此处 `output.code: async_task_timeout` 表示任务轮询超时,`output.task_status` 为 `UNKNOWN`;查询接口仍返回 HTTP 200。 其他任务失败的错误码和提示由供应商定义,可能位于 `output.code`、`output.message` 或顶层 `code`、`message`,以实际任务响应为准。 ## 4. 报错后的排查步骤 1. 保存本次响应的 HTTP 状态码、完整错误正文和响应头 `X-EE-Response-ID`,再根据 `error.code` 对照上表排查。有 `error.details` 时,同时查看具体原因和参数名。 2. 请求参数或模型错误,检查请求地址、HTTP 方法、模型名、参数格式及模型支持的能力;鉴权或权限错误,检查 API Key、调用方出口 IP 和工作空间授权。 3. 余额或额度错误,先充值或调整额度再重试;RPM、TPM 限流,降低请求频率、并发或 Token 用量,间隔一段时间后重试,避免连续立即重试。 4. `no_channel` 联系管理员检查模型对应的渠道、协议和可用额度;渠道错误如有具体参数提示,先按提示修改。网络或服务临时异常可间隔后有限次重试,持续失败时联系我们。 5. 异步任务先查询已有任务的状态和错误字段,不要仅凭查询 HTTP 200 判断执行成功。任务状态未知、请求超时或流式响应中断时,先确认原请求或任务的执行结果,再决定是否重新提交,避免重复执行或计费。 ## 5. 联系我们时提供的信息 排查后仍无法解决,请联系我们并提供以下信息: | 信息 | 说明 | | ---- | ---- | | API Key 名称 | 提供使用的 API Key 名称,无需提供完整密钥 | | 使用场景和工具 | 简述使用场景,以及使用的工具或客户端名称 | | 问题描述 | 描述遇到的问题、操作步骤和预期结果 | | 报错截图 | 提供包含完整报错提示的截图,注意遮挡密钥和敏感信息 |
majianxin
2026年11月16日 11:27
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
分享
链接
类型
密码
更新密码