常見錯誤排查
大部分失敗的請求都落在以下五種情況。對照你看到的訊息處理即可，通常不需要聯絡客服。
Invalid key! Your api-key is invalid or expired（401）
請求已到達本站，但金鑰沒被接受。
- 複製時前後帶了空格——回到 API Keys 重新複製。
- 金鑰已被刪除或超過設定的過期時間，建立新的即可。
- CLI 讀到的不是你以為的那把金鑰：用工具自帶的檢查指令（例如
claude /status、opencode auth list），或印出你匯出的環境變數確認。
404 page not found（或回傳 HTML 而不是 JSON）
幾乎都是base URL 多了 /v1。正確的端點只到這裡：
1 https://www.codebyai.net/api/agent
https://www.codebyai.net/api/agent/v1/chat/completions 會被原樣轉發上游並回 404。
移除 base URL 結尾的 /v1，把它留給 SDK 自己拼接路徑。
CLI 提供某個模型卻回 400
各協定端點只服務屬於自己的模型：
openai-compatible端點服務 GPT 系列（Codex 模型）。anthropic-messages端點服務 Claude 系列。- Gemini 模型走自己的路由，見 Gemini 設定頁。
到模型廣場核對完整的模型 id；不存在的 id 會直接回錯，不會被悄悄替換。
Insufficient balance
金鑰沒問題，是餘額用完了。到錢包 充值即可，流程見充值與餘額。
Service Unavailable in Your Region
來自受限區域的請求會在邊緣節點被拒絕。若你判斷是誤判（例如公司 VPN 出口在其他國家），請附上你的對外 IP 聯絡我們。
仍然無法解決？
把失敗請求的狀態碼、模型 id，以及你使用的工具與版本， 寄到 cfjwlchangji@gmail.com。 通常這樣就足以定位問題，不需要另外通話。