疑難排解指南

本指南可協助您診斷並解決呼叫 Gemini API 時如果您遇到 API 金鑰問題，請確認您已完成設定按照 API 金鑰設定指南正確設定 API 金鑰。

錯誤代碼

下表列出您可能會遇到的常見錯誤代碼，以及原因和疑難排解步驟：

HTTP 代碼	狀態	說明	解決方案
400	INVALID_ARGUMENT	要求主體格式錯誤。	如要瞭解要求格式、範例和支援的版本，請參閱 API 參考資料。在舊版端點上使用新版 API 的功能可能會造成錯誤。
400	FAILED_PRECONDITION	Gemini API 免費方案不適用於你的國家/地區。請在 Google AI Studio 中啟用專案的計費功能。	如要使用 Gemini API，請務必透過 Google AI Studio 設定付費方案。
403 個	PERMISSION_DENIED	您的 API 金鑰沒有必要權限。	請確認 API 金鑰已設定完成，且具備適當的存取權。
404 年	NOT_FOUND	找不到要求的資源。	檢查要求中的所有參數是否適用於您的 API 版本。
429 人	RESOURCE_EXHAUSTED	你的比率已超出上限。	確認您符合模型的頻率限制。如有需要，您可以申請提高配額。
500 人	INTERNAL	Google 端發生未預期的錯誤，	請稍後再重試要求。如果重試後問題仍未解決，請使用 Google AI Studio 中的「提供意見」按鈕回報問題。
503	無法使用	服務可能會暫時超載或停機。	請稍後再重試要求。如果重試後問題仍未解決，請使用 Google AI Studio 中的「提供意見」按鈕回報問題。

請確認模型參數位於下列值內：

模型參數	值 (範圍)
候選人數量	1-8 (整數)
溫度	0.0 至 1.0 版
輸出符記數量上限	使用 `get_model` (Python) 來判斷所用模型的符記數量上限。
TopP	0.0 至 1.0 版

除了檢查參數值之外，也請確認您使用正確的 API 版本 (例如/v1 或 /v1beta) 和支援您需要的功能舉例來說，假設某項功能仍為 Beta 版版本，只有 /v1beta API 版本提供此版本。

請確認您使用的是 Google Cloud 支援的模型模型頁面。

如果提示訊息因 API 呼叫中安全性設定而遭到封鎖，查看您在 API 呼叫中設定的篩選器相關提示。

如果看到「BlockedReason.OTHER」，表示該查詢或回應可能違反相關條款或不受支援。

想取得更高品質的模型輸出內容，不妨瞭解如何撰寫更有條理的提示。「提示設計簡介」頁面一些基本概念、策略和最佳做法，協助您快速上手。

如果有數百種良好的輸入/輸出組合範例考慮調整模型。

詳閱權杖指南，進一步瞭解計算符記及其限制