跳至主要內容

Gamma 有 API 嗎？

了解 Gamma API 的功能、如何取得 API 金鑰，以及如何用它程式化地建立、編輯和匯出簡報、文件、網頁和社群貼文。

什麼是 Gamma API？

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

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

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

💎 專業提示：任何人今天都能在任何方案下使用 API，包括免費方案，且有寬鬆的使用限制。

API 準備好了嗎？

Gamma API v1.0 自 2025 年 11 月 5 日起已正式推出（GA）。任何人今天都能在任何方案下使用 API，且有寬鬆的使用限制。

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

我該如何取得存取權？

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

步驟 1：產生 API 金鑰

前往帳戶中的 設定與成員，然後切換到 API 金鑰 分頁。點擊 建立 API 金鑰 以產生金鑰，接著複製並妥善保存你的 API 金鑰。

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

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

我可以用 OAuth 取代 API 金鑰進行驗證嗎？

你可以使用 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。

使用與速率限制

目前的 API 限制

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

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

API 可以做什麼

Gamma API 涵蓋 gamma 的完整生命週期，從建立到匯出。

生成內容：從你的文字建立簡報、文件、網頁和社群貼文。

從範本建立：從你在 Gamma 建立的範本生成新的 gamma，保留其版面和卡片結構。

編輯現有 gamma： POST /v1.0/agent/gammas/{gammaId}/edits 對單頁應用自然語言變更。

代理生成： POST /v1.0/agent/generations 從工作區範本、現有 gamma 或官方 Gamma 範本開始生成。

讀取、匯出與分析現有 gamma：取得、評論、匯出與分析端點。

獨立圖片生成：獨立於完整 gamma 生成個別圖片。

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

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

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

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

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

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

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

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

我可以用 API 生成獨立圖片嗎？

你可以使用 Gamma API 及模型上下文協定（MCP）生成獨立圖片。這讓你能程式化地生成個別圖片，獨立於完整簡報、文件或網頁的生成。要透過 API 或 MCP 生成圖片，請參考開發者文件中的 建立圖片生成 指南。MCP 的圖片生成可在 Claude、ChatGPT 及其他 MCP 用戶端使用。

➡️ developers.gamma.app/images/create-image-generation

我可以用 API 或 MCP 搜尋我的 gamma 嗎？

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

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

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

我可以用 API 做什麼？

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

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

範本支援

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

視覺主題： 您可以在 Gamma 中創建自訂主題來定義簡報的外觀與感覺，然後在 API 中使用其主題 ID 進行引用。使用 List Themes API (GET /v1.0/themes) 取得可用的主題 ID。

內容結構範本： 使用 從範本建立。在 Gamma 中建立範本，然後呼叫 POST /v1.0/generations/from-template 並帶入其 ID 與提示。範本的版面與卡片結構預設會保留，您的提示則用於更改內容、受眾或語言。範本必須是您工作區中的單頁 Gamma（一頁可包含多張卡片）。使用 GET /v1.0/templates/search 查找範本 ID。

代理生成： POST /v1.0/agent/generations 也可以從工作區範本、現有 Gamma 或官方 Gamma 範本 (templateId) 開始。

➡️ developers.gamma.app/guides/create-from-template-api-parameters-explained

取得幫助與支援

文件與資源

完整技術參考請參閱開發者文件。所有方案均包含 API 存取權限，包括免費方案。

開發者文件

除錯協助

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

每個 API 回應的標頭中都包含此唯一識別碼。對於 **Make.com 用戶，請在 輸出 → 捆綁包 → 標頭 中查找。對於 Zapier，請在任務歷史的 執行詳情 → 輸出資料 區段查看成功執行，或在 日誌 標籤 → 回應資訊（展開標頭）查看失敗請求。

💎 專業提示： 請在尋求支援時，務必提供您的請求 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 編輯現有的 Gamma 嗎？

  • 可以。POST /v1.0/agent/gammas/{gammaId}/edits 可對您可編輯的 Gamma 頁面套用自然語言指令，例如「更新定價卡片為新方案」。

  • 使用 GET /v1.0/agent/edits/{editId} 輪詢結果。

  • 編輯無法新增頁面，且同一頁面同時只能執行一個編輯。

  • 此功能同樣適用於 Claude、ChatGPT、Slack 及其他 MCP 用戶端。

我自己的 AI 代理可以使用 Gamma 嗎？

  • 可以。將任何 MCP 用戶端連接至 https://mcp.gamma.app/mcp 並使用您的 Gamma 帳號登入。所有方案均適用。

  • 自訂用戶端需先註冊其 OAuth 重定向 URI。

  • ➡️ developers.gamma.app/mcp/gamma-mcp-server

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

  • API 金鑰應妥善保管，切勿分享。

  • 如有需要，請為不同用途產生不同金鑰。

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

  • 出於安全考量，API 金鑰只會在產生時顯示一次。

  • 若遺失金鑰，您需要重新產生新的金鑰。

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

  • 可以，您可以透過帳號設定為不同專案或用途建立多個 API 金鑰。

哪些 Gamma 會出現在 API 或 MCP 搜尋結果中？

  • 搜尋只會回傳您已有權限存取的 Gamma，因此不會曝光您無法在 Gamma 中開啟的內容。

  • 結果依相關性排序，最符合查詢的結果會排在最前面。

  • 已封存的 Gamma 預設不會顯示，除非您選擇包含。

  • 您也可以依建立者及 Gamma 最後更新時間篩選。

  • ➡️ developers.gamma.app/management/search-gammas

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

  • 跨您的 Gamma 搜尋功能正在逐步推出，尚未對所有工作區開放。

  • 如果無法使用，請聯絡客服並提供您的 x-request-id，以便我們檢查您的工作區。

  • 編輯：若搜尋功能已完全確認，請刪除此常見問題。

如果我的點數用完會怎樣？

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

  • 透過 API 建立的簡報會出現在 Gamma 儀表板的 API Generated 區域，不會出現在您的主要 Gamma 清單（全部、最近查看或您建立的）。

  • 若要讓 API 產生的簡報出現在您的常用 Gamma 清單中，請打開該簡報並選擇 複製。複製品會被視為標準的網頁建立 Gamma，並會出現在所有常用檢視中。

相關文章
是否回答了您的問題？