跳至主要內容

Gamma API 疑難排解

支援範圍、常見錯誤代碼及疑難排解步驟。

Gamma API 疑難排解指南

雖然我們樂於協助所有 API 相關問題,但請注意,我們的支援團隊無法建立工作流程、除錯您的後端程式碼(FastAPI、Express、Django 等)或排解平台特有問題。

我們可以協助解答有關 Gamma 特定端點和參數、API 認證、錯誤排解、點數及確認您的請求符合我們文件的問題。

如需平台特定協助,請聯絡Zapier 支援、Make 支援或N8N 支援。

欲了解更多 Gamma API 資訊,請參閱:developers.gamma.app


常見錯誤代碼

400 錯誤請求

參數無效

請檢查您的請求是否有:

  • 缺少必要欄位(inputText、textMode)

  • 參數值無效

  • 超過字元/標記限制

請查看錯誤訊息以獲得具體驗證細節。


401 未授權

API 金鑰無效

您的 API 金鑰無效或未與 Pro 帳戶關聯。

  1. 請確認您使用的是 X-API-KEY 標頭(非 Authorization)

  2. 請至 gamma.app/settings/billing 產生新的 API 金鑰

  3. 確認您的帳戶擁有有效的 Pro、Ultra、Teams 或 Business 計劃


403 禁止訪問

點數不足

您的帳戶已用完 API 點數。

  • 啟用自動充值(建議)

  • 臨時購買點數

  • 升級至更高階方案


404 找不到

生成 ID 無效

生成 ID 不存在或屬於其他使用者。

請確認您使用的是 POST 回應中的正確 generationId。


422 失敗

生成無法完成

生成結果為空。

請檢查您的請求:

  • 確保 inputText 內容充足

  • 確認參數與您的輸入相符

  • 如有需要,簡化複雜指令


429 請求過多

超過速率限制

您已達到速率限制(每小時 50 次生成)。

注意: API 容量充足,大多數使用者正常使用時不會遇到此限制。

解決方案:

  1. 聯絡 Gamma 支援 以提升容量

  2. 實施指數退避策略

  3. 分散請求時間


500 內部伺服器錯誤

意外的伺服器錯誤

發生暫時性伺服器問題。

  1. 請稍候再試

  2. 若持續發生,請附上 x-request-id 聯絡支援


502 錯誤閘道

暫時性閘道問題

發生暫時性連線問題。

請稍候再試您的請求。



我的 API 生成簡報不在我的 Gammas 清單中

API 生成的簡報會出現在 Gamma 儀表板的 API Generated 區段,而非您的主要 Gammas 清單(全部、最近查看或您建立)。這是預期行為—重新命名簡報不會改變其分類。

解決方法:開啟簡報並選擇 複製。複製品會被視為一般網頁建立的 Gamma,並會出現在您的主要 Gammas 清單中。

仍需要幫助?

是否回答了您的問題?