呼叫問題

API 呼叫的高頻問題。對照你的症狀，再循連結查看細節。

收到 401 Unauthorized？

• 金鑰錯誤：確認你使用的是建立時保存的完整金鑰（清單中的遮罩內容不是完整金鑰）；
• 金鑰已刪除或過期：在「API 金鑰」頁確認狀態，必要時重新建立；
• 標頭格式錯誤：OpenAI 相容協議要求 Authorization: Bearer <key>——不要漏掉 Bearer 前綴；
• 更多說明見鑑權方式。

出現「找不到模型」？

• 模型 ID 拼錯——請從模型市場複製完全一致的 ID，不要手動輸入；
• 該模型不存在於平台，或目前不可用——確認市場中有該卡片且狀態可用。

逾時或回應很慢？

• 長上下文 / 長輸出的請求本來就較慢；確認 max_tokens 是否設得沒必要地高；
• 為客戶端設定合理的逾時與指數退避重試；
• 互動式介面請使用 "stream": true——首批位元組更早到達，體感延遲會明顯下降。

頻繁出現 429？

你正在觸發速率限制。請降低併發數、加入退避間隔；若長期處於高負載，請聯絡平台討論配額。詳見錯誤碼說明。

回覆是空的或被截斷？

• finish_reason 為 length：回覆撞到 max_tokens 上限——請調高；
• 檢查 messages 中是否有項目的 content 是空的；
• 部分模型對輸入格式有要求（例如圖像模態的限制）——請見模型卡片上的說明。

怎麼確認呼叫真的成功？

兩個檢查點：HTTP 200 且回應中有 choices / usage；以及控制台日誌頁中對應的那筆記錄（含 Token 用量與成本）。兩者一致，這條鏈路就是健康的。