如果你在 Heptabase 中使用自己的 OpenAI GPT-5.x 或 Google Gemini 3 API 金鑰，並且經常看到「Something went wrong, please try again later or contact support.」
這篇指南會帶你檢查最常見的原因，以及如何逐步排除問題。
常見症狀
你的 OpenAI 或 Gemini API 金鑰在 Heptabase 中顯示為「Verified」，但：
使用 GPT-5 系列的模型時總是出錯
使用 Gemini 3 Pro 總是出錯
Gemini 2.5 可以正常使用，但 Gemini 3 不行
你已訂閱 ChatGPT Plus 或 Gemini Pro，並且可以在它們的網頁介面中使用 ChatGPT 5.1 或 Gemini 3，但在 Heptabase 的 AI Chat 中使用這些模型仍然失敗。
如果以上情況聽起來很熟悉，可以依照下面的檢查步驟進行。
可能原因
這些問題通常是由以下一個或多個原因造成的：
1. OpenAI 組織尚未完全驗證
OpenAI 要求你的組織（即便是個人帳號）完成身分驗證後，才能透過 API 使用 GPT-5.x。
2. Gemini API 專案未設定計費或處於受限方案
擁有 Google AI Pro 或類似的 UI 訂閱並不夠。
你用來產生 Gemini 金鑰的 API 專案，必須：
已啟用計費，且
具有足夠的層級（tier）來使用 Gemini 3。
3. 模型本身的限制或不穩定性
較新的模型（尤其是 Gemini 3）目前可能比 Gemini 2.5 更不穩定，或有更多使用限制。
如何修復問題
1. 檢查你的 OpenAI 組織驗證狀態（用於 GPT-5.x）
如果 GPT-5 模型失敗，但你的 API 金鑰在 Heptabase 中顯示為已驗證（Verified）：
前往 OpenAI Platform
造訪：https://platform.openai.com/settings/organization/general開啟路徑：
Settings → Organization → General → Verifications驗證你的組織以取得受保護模型的存取權
如果系統要求你進行驗證：
依照 OpenAI 平台上顯示的步驟操作（可能會使用第三方服務進行身分驗證）。
完成驗證之後，稍微等一段時間，再回到 Heptabase 嘗試使用 GPT-5。
✅ 在組織完成驗證、且計費狀態正常的情況下，通常不需要更換 API 金鑰，GPT-5 就應該可以開始正常運作。
2. 檢查你的 Gemini API 計費與層級（用於 Gemini 3）
如果符合以下情況：
Gemini 2.5 可以正常使用
Gemini 3 Pro 不行，即使你擁有付費 Google AI 方案
那通常問題會出在「API 專案」本身，而不是你的個人訂閱。
步驟一：開啟 Google AI Studio：https://aistudio.google.com/
步驟二：檢查 API 金鑰設定
進入 API keys 區域。
確認你貼到 Heptabase 的那組金鑰：
屬於你打算使用的那個專案，且
是啟用狀態（沒有被刪除或停用）。
步驟三：確認 API 專案已設定計費
確認該 API 金鑰所屬的專案已連結一個有效的計費帳戶。
如果你是剛建立專案，可能需要先完成整個計費設定流程，Gemini 3 才能使用。
步驟四：檢查你的使用層級 / 配額
查詢你的層級（例如：Tier 1 或更高）。
如果你僅使用免費或受限方案，可能無法使用 Gemini 3 Pro，即使 Gemini 2.5 可以正常運作。
步驟五：回到 Heptabase 再試一次
如有需要，重新在 Heptabase 貼上 Gemini API 金鑰。
測試：
先用 Gemini 2.5 發送一個請求（確認金鑰有效）。
再用 Gemini 3 Pro 發送一個請求。
💡 如果在計費已正確設定的情況下，Gemini 2.5 可以運作但 Gemini 3 仍然失敗，我們建議目前先以 Gemini 2.5 作為主要模型，因為它目前相對更穩定。
何時應聯繫客服支援
如果你已經：
驗證了你的 OpenAI 組織（或確認其已驗證），
為 Gemini API 專案設定了計費與正確的層級，
重新加入並更新 API 金鑰，
但在使用 GPT-5 或 Gemini 3 時，仍然看到
「Something went wrong, please try again later or contact support.」
請聯繫我們的客服團隊。
聯繫客服時，請提供以下資訊以加速排查：
你使用的模型是什麼
目前「哪些可以用、哪些不行」，例如：
「Gemini 2.5 正常，但 Gemini 3 會失敗」
簡單輸入 "Test" 可以成功，但是請他摘要 PDF 會失敗。
截圖：
Heptabase 中顯示錯誤訊息的畫面
OpenAI 或 Google AI Studio 中相關設定頁面的截圖
我們的團隊會盡快確認並協助你解決問題！