如果你在 Heptabase 使用自己的 API 金鑰搭配 OpenAI GPT-5.x 或 Google Gemini 3，卻持續看到「Something went wrong, please try again later or contact support.」訊息，本指南會介紹最常見的原因與解決方式。
使用以下步驟前，請先檢查對話輸入區選取的 AI 來源：
如果選擇自己的 OpenAI 或 Gemini API 金鑰，請繼續閱讀本指南。
如果透過 ChatGPT Plan 登入，下方的組織驗證與 API 帳務步驟不適用。發生錯誤時，如有 Continue 可先使用，或切換模型，並聯絡客服，提供模型名稱、大約發生時間與時區，以及問題影響單一還是多個對話。
常見症狀
以下情況可能適用：
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 Agent 使用這些模型仍失敗。
如果使用自己的 API 金鑰且情況相似，請繼續以下檢查。
可能原因
這些問題通常由下列一項或多項原因造成：
OpenAI 組織尚未完成驗證
OpenAI 要求你的組織（即使是個人帳戶）完成身分驗證，才能透過 API 使用 GPT-5.x。Gemini API 專案尚未設定帳務或處於受限等級
只有網頁介面的 Google AI Pro 或類似訂閱並不足夠。Gemini 金鑰所屬的 API 專案必須啟用帳務，且等級足以存取 Gemini 3。模型特有的限制或不穩定
較新的模型（尤其 Gemini 3）可能比 Gemini 2.5 更不穩定或有較多限制。
如何解決
檢查 OpenAI 組織驗證
如果 GPT-5 模型失敗，但 API 金鑰在 Heptabase 顯示已驗證：
開啟 OpenAI Platform，前往 Settings → Organization → General → Verifications，驗證組織以存取受保護模型。
如果系統要求驗證，請依照平台顯示的步驟操作。OpenAI 可能使用第三方身分驗證服務。
完成驗證後稍候，再回到 Heptabase 嘗試 GPT-5。
如果組織已完整驗證且帳務已啟用，通常不需更換 API 金鑰，GPT-5 就能開始使用。
檢查 Gemini 帳務與存取權限
如果 Gemini 2.5 可用，但即使有付費 Google AI 方案，Gemini 3 Pro 仍失敗，問題通常在 API 專案，而非消費者訂閱。
開啟 Google AI Studio，前往 API keys。
確認貼入 Heptabase 的金鑰屬於你打算使用的專案，而且仍有效，未被刪除或停用。
確認該 API 專案已連結帳務帳戶。新專案可能需要先完成帳務設定，才能使用 Gemini 3。
檢查專案的使用等級與配額，例如 Tier 1 或以上。免費或受限等級可能無法使用 Gemini 3 Pro，即使 Gemini 2.5 可以使用。
必要時重新將金鑰貼入 Heptabase。先使用 Gemini 2.5 提問以確認金鑰有效，再測試 Gemini 3 Pro。
如果正確設定帳務後，Gemini 2.5 可用但 Gemini 3 仍失敗，建議以 Gemini 2.5 為主要模型，因為目前較穩定。
何時聯絡客服
若已檢查 OpenAI 組織驗證或 Gemini API 的帳務與存取等級，並重新加入 API 金鑰，使用 GPT-5 或 Gemini 3 時仍出現相同錯誤，請聯絡客服並提供：
使用的模型。
哪些操作成功、哪些失敗。例如：「Gemini 2.5 可用，但 Gemini 3 失敗」，或「部分提問成功，但摘要 PDF 失敗」。
Heptabase 錯誤訊息，以及 OpenAI 或 Google AI Studio 相關設定頁面的截圖。
團隊會調查問題並協助你解決！