有一個你喜愛的簡報？如果你能為全球不同觀眾個性化製作 100 個一模一樣的簡報呢？

Gamma Generate API 允許你程式化建立簡報、文件、網頁和社交貼文，無需直接使用 Gamma 應用程式。非常適合想用 Zapier、Make 或 n8n 等工具自動化工作流程、將美觀簡報生成功能整合到自家應用程式，或透過後端程式碼大規模建立簡報的使用者。

如果你是開發者，可以將 Gamma 整合到你的應用程式，賦予它設計超能力！

💎 專業提示：任何擁有 Pro 帳戶或以上的人今天即可使用 API，且有寬鬆的使用限制。

Gamma API v1.0 自 2025 年 11 月 5 日起正式推出（GA）。任何擁有 Pro 帳戶或以上的人今天即可使用 API，且有寬鬆的使用限制。

🔷 注意：API v0.2 已被淘汰，將於 2026 年 1 月 16 日 停用。如果你目前使用 v0.2，請在此日期前遷移至 v1.0。

有關特定 API 參數及其如何影響簡報生成的詳細資訊，請參閱我們的 API 文件。

要存取 Gamma API，請依照以下步驟操作。

你必須擁有 Gamma Pro、Ultra、Team 或 Business 帳戶。如果你目前不是 Pro 用戶或以上，請升級至 Pro 以存取 API。

在你的 Pro 帳戶中，前往 設定與成員，然後切換到 API 金鑰 標籤。點擊 建立 API 金鑰 以產生金鑰，然後複製並安全保存你的 API 金鑰。

🔷 注意：API 金鑰格式為 sk-gamma-xxxxxxxx，應使用 X-API-KEY 標頭傳遞（非 Bearer 令牌格式）。

💎 專業提示：使用你喜愛的自動化工具開始使用 API，或直接整合到你的後端程式碼。基本 URL 是 https://public-api.gamma.app/v1.0/

你可以使用 OAuth 2.0 來驗證 Gamma REST API，而非靜態 API 金鑰。OAuth 讓你能將 Gamma API 連接到應用程式，無需建立或儲存長期有效的 API 金鑰，適合整合和合作夥伴應用程式。靜態 API 金鑰仍完全支援，因此如果你偏好，可以繼續使用 X-API-KEY 標頭。要設定 OAuth，請參考開發者文件中的 使用 OAuth 驗證 指南，網址為 developers.gamma.app/get-started/authenticate-with-oauth。

Gamma 的 API 可隨你的需求擴展。無論你是生成少量簡報還是數百份，都應能根據使用需求建立，且在正常使用下不會遇到限制。

🌀 洞察：如果你遇到速率限制（HTTP 429 錯誤），請聯繫我們的支援團隊。我們會協助你確保 API 支援你的建置需求！

API v1.0 包含多項強大新功能：

網頁格式：除了簡報、文件和社交貼文外，還能生成網頁。

頁首與頁尾自訂：自訂內容的頁首與頁尾。

輸入中的圖片 URL：可直接在內容中引用圖片。

資料夾組織：將生成的內容整理到資料夾中。

電子郵件分享：可程式化透過電子郵件分享內容。

列表 API：新增端點以列出你的主題和資料夾。

搜尋 gammas：搜尋你可存取的 gammas 標題與全文，並在開啟前篩選結果。

更好的輸入限制：最高可達 100,000 代幣（約 400,000 字元）。

🌀 洞察：隨著 API 持續演進，我們將繼續新增更多選項，讓你能程式化修改與重混 Gammas。

你現在可以使用 Gamma Generate API 及模型上下文協議（MCP）生成獨立圖片。這讓你能程式化建立單張圖片，與生成完整簡報、文件或網頁分開。要透過 API 或 MCP 生成圖片，請參考開發者文件中的 建立圖片生成 指南，網址為 developers.gamma.app/images/create-image-generation。MCP 圖片生成功能目前在 Claude 及其他 MCP 用戶端可用；ChatGPT 尚未支援。

你可以透過 Gamma API 或連接 Gamma 的 AI 助手使用模型上下文協議（MCP）搜尋整個 gammas 資料庫。搜尋會涵蓋你可存取的每個 gamma 的標題與全文，並依相關性排序，最接近的結果會優先顯示。每個結果都包含直接連結，讓你能從回應中直接開啟該 gamma。

你可以依創建者及最後更新時間縮小搜尋範圍。預設會排除已封存的 gammas，你也可以選擇包含它們。

🔷 注意：搜尋功能正在逐步推出，尚未在所有工作區開放。如果搜尋端點或 MCP 搜尋工具無法使用，表示你的工作區尚未收到此功能。

完整搜尋參數與範例請參考開發者文件中的 搜尋 gammas 指南，網址為 developers.gamma.app/management/search-gammas。

利用 Gamma API 於 Make、Zapier、Workato 等自動化平台及其他工作流程工具。你也可以直接整合後端程式碼，打造自訂應用程式，程式化大量生成簡報，或大規模建立個人化內容。

🔷 注意：你的 inputText 應包含你想放在投影片上的實際內容，而非如何建立簡報的指示。主題必須先在 Gamma 中建立並以 ID 參考，無法透過 inputText 建立。

因為「範本」對不同使用者意義不同，以下是可用的範本類型。

視覺主題：你可以在 Gamma 中建立自訂主題，定義簡報的外觀與風格，然後在 API 中以主題 ID 參考它們。使用列出主題 API (GET /v1.0/themes) 取得可用主題 ID。

內容結構範本：我們正努力在未來更新中加入嚴格的內容結構支援。

完整技術參考請參閱 API 參考文件。您也可以查看我們的登陸頁面，了解概覽與入門指南。Pro、Ultra、Teams 和 Business 訂閱包含 API 存取權限。

當您需要 API 問題協助時，請先查看我們的錯誤文件了解常見問題與解決方案，然後聯絡客戶支援。請務必附上 API 回應中的 x-request-id。

每個 API 回應的標頭中都包含此唯一識別碼。對於 Make.com 用戶，可在 Output → Bundle → Headers 中找到。對於 Zapier，成功執行請查看任務歷史中的 Run Details → Data Out，失敗請查看 Logs 標籤 → Response information（展開標頭）。

💎 專家提示： 請在請求支援時，務必附上您的請求 ID、精確錯誤訊息及請求內容範例。

我們能協助處理 Gamma 專屬 API 問題、認證與 API 金鑰問題、錯誤訊息解讀、速率限制問題及點數使用問題。

我們無法除錯或撰寫自訂程式碼，無法在 Zapier、Make 或 N8N 中建立完整工作流程，無法除錯自訂應用程式，無法提供 Zapier、Make 或 N8N 使用指導，也無法設計自訂架構。

請求 API 協助時，請提供您的請求 ID、錯誤訊息、請求內容範例及您使用的自動化平台。

401 未授權：API 金鑰無效。請確保您使用的是 X-API-KEY 標頭（非 Authorization 或 Bearer）。

403 禁止：請檢查您的點數餘額並確保自動充值已啟用。

429 請求過多：您已達速率限制。請聯絡 Slack 支援以獲得更高容量選項。

422 失敗：生成無法完成。請檢查您的輸入參數。

針對基本故障排除與常見 API 問題，請參閱我們的綜合故障排除指南。您也可以查看完整開發者文件，了解詳細 API 參考與範例。

➡️ 查看 Gamma API 故障排除指南

➡️ 閱讀開發者文件

我可以與他人分享我的 API 金鑰嗎？

為什麼我無法再次複製我的 API 金鑰？

我可以產生多個 API 金鑰嗎？

API 或 MCP 搜尋結果會顯示哪些 gammas？

為什麼我的工作區搜尋功能無法使用？

我需要從 v0.2 遷移到 v1.0 嗎？

v0.2 與 v1.0 主要差異為何？

如果我的點數用完會怎麼辦？

API 產生的簡報會出現在 Gamma 儀表板的哪裡？