到目前為止，我們已經能做出一個簡單的聊天機器人，甚至能記住上下文。
但在實際開發時，你一定會遇到各種報錯的狀況。

今天我們就來整理一些 常見錯誤與解決方法，幫你少踩坑。

1. API Key 錯誤

錯誤訊息：
AuthenticationError: No API key provided
忘了設定 API Key、Key 打錯了、Key 已經被刪除
解決方法：

• 確認 .env 裡有正確的 OPENAI_API_KEY
• 程式裡要用 load_dotenv() 載入環境變數
• 不要直接把 Key 寫死在程式碼裡

2. Rate Limit（超出速率限制）

錯誤訊息：
RateLimitError: You exceeded your current quota, please check your plan and billing details.
原因：

• 呼叫 API 太頻繁
• 免費額度用完了
• 方案不夠大

解決方法：

• 減少 API 呼叫次數（例如合併訊息再發送）
• 加上 retry 機制，錯誤時延遲幾秒再試
• 到 Billing 頁面 確認方案或儲值

3. Timeout（連線逾時）

錯誤訊息：
Timeout: The request took too long
原因：

• 網路不穩
• 回覆內容太長

解決方法：

• 檢查網路
• 調整 max_tokens，避免回覆太大
• 在 API 呼叫時設定 timeout 參數（官方 Python SDK 支援）

4. 模型名稱錯誤

錯誤訊息：
InvalidRequestError: The model 'xxx' does not exist

原因：

• 打錯模型名稱
• 使用了不支援的舊模型

解決方法：

• 確認模型拼字正確，例如：
  • gpt-4o-mini
  • gpt-4o
  • gpt-5
• 建議直接參考官方文件的 Models 列表

5. Unexpected Error（其他奇怪錯誤）

有時候會出現一些沒有看過的錯誤訊息，這時候可以：

• 印出完整錯誤：加上 try...except，把錯誤訊息印出來
• Google + 官網文件：大部分問題都有人遇過
• 檢查套件版本：確保 pip install -U openai 是最新的

今天我們整理了 API 常見錯誤：
Key 錯誤、Rate Limit、Timeout、模型拼字錯誤、其他奇怪錯誤
雖然今天內容有點無聊，但先帶大家認識一些常遇到的報錯。
只要遇到問題，先讀錯誤訊息，通常就能找到原因。
明天我們要進入進階功能Function Calling讓 AI 可以自己叫外掛!