status_code=500, not implemented
若錯誤同時包含 status_code=500 和 not implemented，請先確認所選模型是否支援目前端點使用的協定。例如，/v1/responses 需要 supported_endpoint_types 包含 openai-response；缺少該類型時，這是協定不相容，不是等待即可恢復的上游故障。
- 自建程式請依
supported_endpoint_types選擇介面；包含openai時使用 Chat Completions：/v1/chat/completions。 - Claude Code 請依Claude Code 教學設定，並確認模型支援
anthropic。 - 請先改用相符的端點再測試；等待或換網路都不會修正協定不相容。
400 Bad Request／參數不相容
400 通常表示請求格式、參數或會話狀態不符合目前端點要求。請依序檢查：- 模型 ID 是否從模型廣場準確複製。
- 端點是否與模型和用戶端相符；請先看接入方式總覽。
- 是否帶入目前模型不支援的圖片、工具呼叫、推理或會話續接參數。
- 用戶端或 SDK 是否過舊。
- 新建會話後，以簡短文字是否仍會出現。
401 Unauthorized
常見原因是 API Key 缺失、填寫錯誤、已停用／到期，或鑑權標頭格式錯誤。403 Forbidden
403 表示這次請求被拒絕。常見原因包括：Key 無權使用所選群組、啟用了模型限制、IP 白名單不符合、帳戶狀態不可用；也可能由上游模型服務拒絕。 先核對 Key 的群組、模型限制與 IP 白名單，再用一條簡短文字驗證。若持續出現，請提供 Request ID、模型、時間和錯誤原文；高頻重試或不斷建立 Key 無法排除存取限制。404 Not Found／請求位址錯誤
優先檢查：- Base URL 是否被拼成
/v1/v1/...。 - 用戶端是否已自動補上
/v1或具體路徑。 - 路徑是否為平台支援的
/v1/chat/completions、/v1/responses、/v1/messages或/v1/images/generations。
503／no available channel。
429 Too Many Requests
429 可能來自平台的模型頻率限制，也可能是模型服務的短期限流。像Concurrency limit exceeded for user 的原文通常是上游或用戶端自身的並發限制，不能只憑狀態碼判斷 API Key 壞了。
- 降低並發；有
Retry-After時優先依它等待，沒有時再用含隨機抖動的指數退避。 - 不要讓多個程式以同一把 Key 同時高頻重試。
- 低頻仍持續出現時，提供 Request ID 以便確認服務可用性。
500、502、503、504 或 524
除前述not implemented 協定錯誤外，這些狀態通常代表處理失敗、連線中斷、服務繁忙或等候超時，不一定是 Key 或提示詞錯誤。
同一模型連續失敗時，請先暫停後續長任務，保留現場資訊後聯絡支援。
no available channel／目前模型沒有可用服務
這表示目前 Key 使用的群組下暫時沒有可用於該模型的服務。模型 ID 拼錯、模型未在群組提供、模型暫時不可用或服務維護都可能造成。
可稍後重試，或改用模型廣場中目前群組可見的其他模型。若持續出現，提交模型名、Request ID 與時間即可；此訊息與加值額度或重建 Key 無關。
Concurrency limit exceeded for user
帳戶目前的活躍請求數已達上限。等待進行中的請求結束、降低用戶端並發後再試；僅憑此錯誤不需要停用或重建 API Key。
長會話或工具呼叫錯誤
Invalid signature in thinking block
目前會話保存的推理內容無法再驗證，常見於長會話恢復、用戶端狀態改變或相容性變動。請新建會話、更新用戶端，並避免在多台裝置繼續同一會話；反覆重試原會話通常無法恢復。
previous_response_id is only supported on Responses WebSocket v2
用戶端正在以不支援的連線方式續接先前回應。請新建會話、關閉實驗性的會話續接／回應重用功能，或更新用戶端。
Content block not found
用戶端未收到預期的完整內容片段，常見於長會話、工具呼叫或串流中斷。請先新建會話、縮短輸入並發送簡單測試；若仍有異常，再暫時關閉非必要的工具呼叫，並向支援提供 Request ID、發生時間、模型與錯誤原文。我們會據此核查服務狀態。
圖片生成超時或能力不支援
圖片模型只能使用圖片端點，文字模型不能使用圖片生成端點。目前圖片生成是同步請求，可能比文字請求久；再次提交同一圖片任務前，請先確認第一次請求的結果。Image generation is not enabled／model not supported：確認模型、端點與參數相符。504／524／用戶端超時：保留 Request ID 和時間後，再決定是否重新生成。