如果你尚未新增 API 金鑰，請先參考使用自己的 AI API 金鑰。使用自己的 API 金鑰時若發生錯誤，請依照以下步驟檢查。
1. 確認目前使用的 AI 來源
先確認發生錯誤的請求使用的是自己的 API 金鑰，而不是 Heptabase AI 或 ChatGPT Plan。使用自己的 API 金鑰時，模型權限、用量限制與費用由該 API 金鑰的供應商管理，不是由 Heptabase 管理。
請注意：
ChatGPT 訂閱與 OpenAI API 的 billing 和 usage limits 是分開的。
Google 的消費者 Gemini 方案不會提供 Gemini API project 的額度。
請確認 dashboard 顯示的帳號、project 或 organization 就是建立這組 API 金鑰的來源。
API 金鑰顯示為 Verified，只代表 Heptabase 在驗證當下能使用這組憑證，不代表所有模型都可以使用，也不代表該帳號目前仍有足夠額度。
2. 根據錯誤訊息進行排解
API 金鑰無效、過期或已停用
請前往 AI 服務供應商的設定頁面，確認金鑰仍然有效。如果無法確認，請建立新的 API 金鑰，然後在 Heptabase 中重新連接。請勿將 API 金鑰傳送給 Heptabase 客服。
Rate limit、quota 或 billing 錯誤
使用自己的 API 金鑰時，rate limits 由供應商依照帳號、模型與 usage tier 設定，不是 Heptabase 的用量限制。Free tier 或較低的 usage tier 通常有更嚴格的限制，因此即使是簡短的請求也可能被拒絕。Heptabase 無法調高或重設這些限制。
請在 AI 服務供應商的 dashboard 中檢查：
Usage
Rate limits
Billing 或 credit balance
API 金鑰所屬的帳號、project 或 organization
所選模型是否能在目前的 usage tier 使用
Rate limits 可能依 project、模型與時間區間分開計算。如果已達限制，請等待額度重設、調整供應商的 billing 或 limits，或改用另一個可用模型。如果 dashboard 看起來正常，但相同錯誤持續發生，請聯絡 Heptabase 客服。
模型無法使用、Access denied 或 Organization verification
請確認 API 金鑰所屬的帳號、project 或 organization 有權使用該模型。你可以：
改用另一個可用模型
在 AI 服務供應商的 dashboard 中檢查 model access
只有在錯誤訊息明確要求時，才進行 organization verification
確認相關 API 已啟用
Temporarily overloaded、unavailable 或 internal error
這類錯誤表示 AI 服務供應商當下無法處理請求，不一定代表 API 金鑰或 Heptabase 設定有誤。
使用自己的 Gemini API 金鑰時，Google 會根據這組金鑰的 usage tier、rate limits 與當下服務狀態決定是否接受請求。Free tier 或較低的 usage tier 較容易遇到 overloaded 或 rate limit 錯誤，Heptabase 無法調高或重設這些限制。
如果相同請求改用 Heptabase AI 後可以正常執行，請在 Google AI Studio 檢查自己的 Gemini API 金鑰，包括 quota、billing 與 usage tier。你也可以稍後重試，或暫時改用其他模型或 AI 來源。如果錯誤持續發生，請聯絡 Heptabase 客服。
Request too large、context window 或 token limit
目前的對話、附件或請求可能超過模型的限制。你可以：
縮短最新的訊息
移除大型附件
開始新的對話
改用支援較大 context window 的模型
Something went wrong
如果只看到一般性的錯誤訊息：
再試一次。
在新的空白對話中傳送簡短訊息。
嘗試另一個可用模型。
嘗試另一個 AI 來源，例如 Heptabase AI。
如果問題可以持續重現，請聯絡 Heptabase 客服。
聯絡 Heptabase 客服
請提供：
完整錯誤訊息或截圖
使用的 AI 服務供應商與模型
使用自己的 API 金鑰、Heptabase AI，還是 ChatGPT Plan
發生時間與時區
是否能在新的空白對話中重現
其他模型或 AI 來源是否可以正常使用
請勿提供你的 API 金鑰。