Essevin 资源中心报错速查
按错误信息快速排查协议、密钥、模型和环境问题。
按现象找到对应的一行。网关按请求头 Accept-Language 返回中文或英文等文案，未指定时为英文。
| 现象 | 原因 | 怎么做 |
|---|---|---|
| 401「缺少 API Key」「API Key 无效」「API Key 已过期」 | 没带密钥、复制不完整或多了空格，或密钥已删除、停用、过期 | 回控制台「API 密钥」重新完整复制，必要时新建一把 |
| 402「余额不足」「API Key 配额已用完」；视频提交返回「Insufficient balance: available …」 | 帐户余额、这把密钥的额度，或视频任务提交时的余额预留不足 | 充值或调整密钥额度后再发；402 不会自行恢复，不要循环重试 |
| 429「…当前受到限流，请稍后重试」 502「…服务暂时不可用，请稍后重试」 503「当前没有可用的…，请稍后重试」「请求暂时无法完成，请稍后重试」 504「…请求超时，请稍后重试」 | 该模型暂时不可用或响应超时 | 按 Retry-After 或指数退避重试，也可换同系列模型；持续超过 10 分钟，带上响应头里的 X-Request-ID 联系我们 |
| 请求中途断开，记录为 499 | 客户端在完成前主动断开：手动中断，或客户端读超时先到（openai-python 默认 600 秒，其他客户端各不相同） | 长输出改用流式，并调大客户端读超时 |
| 流式输出到一半收到错误事件（如「Response stream interrupted, please retry」）或连接断开 | 已开始输出后出错，无法在同一条流里续传 | 丢弃已收到的片段，整条请求重新发起 |
| 404「当前分组不支持所请求的模型：X」「该 API Key 所属分组未提供所请求的模型…」；400「… is not a valid model ID」 | 模型 ID 不在这把密钥的分组里、拼写不完整，或客户端配置里残留已下架的 ID | 用该密钥调 GET /v1/models 复制完整 ID；列表里没有就换对应分组的密钥；不要自动重试 |
| 404「Model "X" is not supported by any configured account in this group」 | 该模型暂时无法处理这个分组的请求 | 先用这把密钥调 GET /v1/models：列表里有，按上面的 502 / 503 处理；列表里没有，换模型 ID 或换分组密钥 |
| 404「当前平台不支持该 API 路径」 | 路径不属于这把密钥的分组：Claude 密钥调了 OpenAI 协议接口；Anthropic Base URL 多写 /v1（变成 /v1/v1/messages）；或调了平台不提供的接口，如 /v1/dashboard/billing/*、/v1/files、/v1/batches、/v1/embeddings、Codex 联网搜索的 /v1/alpha/search | Claude 改用 Anthropic 协议，Base URL 不带 /v1；查余额用 GET /v1/usage 或控制台；Codex 联网搜索的 404 不影响对话 |
| 400「读取请求体失败」；413「请求体超过大小限制（60 MB）」 | 请求体不完整，或超过 60 MB（多为 base64 图片、视频） | 检查 JSON 与 Content-Type；大文件先压缩，或在模型支持时改传 URL |
| 400 输入超出上下文长度（原文因模型而异） | 对话历史、附件与 max_tokens 合计超过模型上下文 | 裁剪历史或开新会话，调小 max_tokens |
400「Invalid signature in thinking block」「duplicate thinking.signature」 | Claude 的 thinking 历史被改写、拼接或重复 | 原样回传上一轮 assistant 的 thinking 块（含 signature），不要改写、合并或跨模型复用；修不好就从不含 thinking 的历史重新开始 |
| 400「No tool call found for function call output」「No tool output found for function call」 | 工具结果与工具调用没有成对：tool_call_id / call_id 对不上，或少了一方 | 每个工具调用都回传一条结果并原样带回 ID；删历史时成对删除 |
| 400「Unsupported parameter: …」 | 模型不接受某个参数 | 删掉该参数；Responses 接口限制输出长度用 max_output_tokens，不要用 max_tokens |
| 400 内容被安全策略拒绝（如「Your request was rejected by the safety system.」） | 提示词或参考素材触发模型的内容安全策略 | 修改提示词或素材后再发，原样重试仍会被拒 |
| 400 图片参数错误（如「size … is not valid」） | 尺寸、档位或张数不在该模型支持范围 | 按图片 API 里对应模型的取值修改 |
| 400「media_download_failed」 | 参考图片的 URL 无法公开访问 | 换成不需要登录就能下载的 HTTP(S) URL |
| 404「该 API Key 所属分组已下线，不再处理请求…」 | 密钥绑定的分组已下架 | 在控制台用在售分组创建新密钥并替换 |
| 「node / npm 不是内部或外部命令」 | Node.js 没装好或没进 PATH | 到 nodejs.org 重装（Windows 保持默认勾选），装完关掉终端重新开启 |
| PowerShell 提示「禁止执行脚本」 | Windows 脚本执行策略限制 | 优先用控制台「一键接入」的命令；或以系统管理员执行 Set-ExecutionPolicy RemoteSigned |
按表排查后仍未解决？请带上客户端名称、模型 ID、发生时间、HTTP 状态码、响应头里的 X-Request-ID 和已隐藏密钥的截图，联系我们。