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