> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexusapi.link/llms.txt
> Use this file to discover all available pages before exploring further.

# 常見 API 錯誤

> 依錯誤碼、模型協定與 Request ID 排查 NexusAPI 請求問題。

發生錯誤時，先保留錯誤原文、Request ID、時間、模型與端點。參數、協定和會話相容性問題不會因高頻重試而自動恢復。

## `status_code=500, not implemented`

若以 `/v1/responses` 呼叫目前 Anthropic 類 Claude 渠道而出現這個訊息，這是**協定不相容**，不是暫時性上游故障。

1. 自建程式請使用 `/v1/chat/completions`。
2. Claude Code 請依[Claude Code 教學](/zh-TW/tools/claude-code)使用原生 Messages 設定。
3. 不要原樣重送請求。

## HTTP 狀態碼

| 狀態          | 常見原因                   | 第一個動作                    |
| ----------- | ---------------------- | ------------------------ |
| 400         | 模型、端點、參數或會話格式不正確       | 確認協定後用新會話做最小測試。          |
| 401         | Key 缺失、無效、到期或停用        | 重新複製 Key，檢查 Bearer 格式。   |
| 403         | 群組、模型限制、IP 白名單、帳戶或上游拒絕 | 檢查 Key 設定與群組。            |
| 404         | 路徑錯誤或 `/v1` 重複         | 查看實際請求 URL 與用戶端教學。       |
| 429         | 頻率或併發限制                | 降低併發並遵循 `Retry-After`。   |
| 500／502／503 | 暫時處理或上游問題              | 等待 10–30 秒後只重試一次。        |
| 504／524     | 請求或上游等待超時              | 適當縮短內容或輸出，保存 Request ID。 |

## 其他常見訊息

* **`no available channel`**：目前 Key 群組沒有此模型的啟用路由。檢查精確模型 ID、群組和模型廣場，不要靠重建 Key 或重複充值解決。
* **`Concurrency limit exceeded for user`**：現有請求尚未完成，請等待並降低用戶端併發。
* **`Content block not found`**：常見於長會話、工具呼叫或中斷的串流。請看[Content block not found](/zh-TW/faq/content-block-not-found)。
* **圖片模型錯誤或超時**：確認模型、圖片端點和參數；不要立即重送相同圖片任務。

如懷疑重複扣費，請比對同一時間範圍的 Request ID 和使用紀錄。不要假設平台會替一般請求自動重試。