Gamma API 疑難排解指南
雖然我們樂於協助所有 API 相關事宜，但請注意，我們的支援團隊無法建立工作流程、除錯您的後端程式碼（FastAPI、Express、Django 等），或排解平台特有問題。
我們可以協助解答有關 Gamma 特定端點與參數、API 認證、錯誤排解、點數及確認您的請求是否符合我們文件的問題。
欲了解更多 Gamma API 資訊，請參閱：developers.gamma.app
常見錯誤代碼
400 錯誤請求
參數無效
請檢查您的請求是否有：
缺少必要欄位（
inputText、textMode）。參數值無效。
超過字元或代幣限制。
對於
from-template：範本必須是單頁工作區 gamma。官方 Explore 範本及多頁 gamma 將被拒絕。
請查看錯誤訊息以獲得具體驗證細節。
401 未授權
API 金鑰無效
您的 API 金鑰無效或未與 Pro 帳戶關聯。
請確認您使用的是
X-API-KEY標頭（非 Authorization）。請至 gamma.app/settings/api-keys 產生新的 API 金鑰。
確認您的帳戶擁有有效的 Pro、Ultra、Teams 或 Business 計劃。
403 禁止訪問
點數不足
您的帳戶已用完 API 點數。
請至 gamma.app/settings/billing 解決此問題：
啟用自動充值（建議）。
臨時購買點數。
升級至更高階方案。
404 找不到
生成 ID 或 gamma ID 無效
生成 ID 不存在或屬於其他使用者。當您嘗試讀取、編輯或匯出無權限存取的 gamma 時，也會出現此錯誤。
請確認您使用的是 POST 回應中的正確 generationId，或您有權限存取目標 gamma。
422 失敗
生成無法完成
生成結果為空。
請檢查您的請求：
確保
inputText內容充足。確認參數與您的輸入相符。
如有需要，簡化複雜指令。
429 請求過多
超過速率限制
您已達到速率限制。限制是依 API 金鑰擁有者及工作區設定，詳細數值請參考錯誤代碼說明。
🔷 注意： API 容量充足，大多數使用者正常使用時不會遇到此限制。
解決方案：
聯絡 Gamma 支援 申請更高容量。
實施指數退避。
分散請求時間。
500 內部伺服器錯誤
意外的伺服器錯誤
發生暫時性伺服器問題。
請稍候再試。
若持續發生，請提供您的
x-request-id聯絡支援。
502 錯誤閘道
暫時性閘道問題
發生暫時性連線問題。
請稍候再試您的請求。
我的 API 生成簡報不在我的 Gammas 清單中
API 生成的簡報會出現在 Gamma 儀表板的API Generated區段，而非您的主要 Gammas 清單（全部、最近查看或您建立）。這是預期行為，重新命名簡報不會改變分類。
解決方法：開啟簡報並選擇複製。複製品會被視為一般網頁建立的 gamma，並會出現在您的主要 Gammas 清單中。
還需要幫助嗎？
一般支援： 如何聯絡 Gamma 支援。
API 社群： 加入 Gamma API Slack。
SSO 問題：請聯絡您組織的 IT 管理員。