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 和已隱藏金鑰的截圖，聯絡我們。