什麼是 Gamma API？
有你喜愛的簡報？如果你能為全球不同觀眾個性化製作 100 份一模一樣的簡報呢？
Gamma Generate API 允許你程式化建立簡報、文件、網頁和社交貼文，無需直接使用 Gamma 應用程式。適合想用 Zapier、Make 或 n8n 等工具自動化工作流程、將美觀簡報生成功能整合到自家應用程式，或透過後端程式碼大規模建立簡報的用戶。
如果你是開發者，可以將 Gamma 整合到你的應用程式，賦予它設計超能力！
💎 專業提示：任何擁有 Pro 帳戶或以上等級的用戶，今天即可使用 API，且享有寬鬆的使用限制。
API 準備好了嗎？
Gamma API v1.0 自 2025 年 11 月 5 日起已正式推出（GA）。任何擁有 Pro 帳戶或以上等級的用戶，今天即可使用 API，且享有寬鬆的使用限制。
有關特定 API 參數及其如何影響簡報生成的詳細資訊，請參考我們的 API 文件。
我該如何取得存取權？
要存取 Gamma API，請依照以下步驟操作。
步驟 1：升級你的帳戶
你必須擁有 Gamma Pro、Ultra、Team 或 Business 帳戶。如果你目前不是 Pro 用戶或以上，請升級至 Pro 以存取 API。
步驟 2：產生 API 金鑰
在你的 Pro 帳戶中，前往 設定與成員，然後切換到 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 支援你的建置需求！
v1.0 有什麼新功能？
API v1.0 包含多項強大新功能：
網頁格式：除了簡報、文件和社交貼文外，還能生成網頁。
頁首與頁尾自訂：自訂內容的頁首與頁尾。
輸入中的圖片 URL：可直接在內容中引用圖片。
資料夾組織：將生成的內容整理到資料夾中。
電子郵件分享：可程式化透過電子郵件分享內容。
列表 API：新增端點以列出你的主題和資料夾。
搜尋 gammas：搜尋你可存取的 gammas 標題與全文，並在開啟前篩選結果。
更佳的輸入限制：最高可達 100,000 代幣（約 400,000 字元）。
🌀 洞察：隨著 API 持續演進，我們將繼續新增更多選項，讓你能程式化修改與重混 Gammas。
我可以用 API 生成獨立圖片嗎？
你現在可以使用 Gamma Generate API 及 Model Context Protocol (MCP) 生成獨立圖片。這讓你能程式化創建單張圖片，與生成完整簡報、文件或網頁分開。透過 API 或 MCP 生成圖片，請參考開發者文件中的 建立圖片生成 指南，網址為 developers.gamma.app/images/create-image-generation。MCP 圖片生成目前在 Claude 及其他 MCP 用戶端可用，尚未在 ChatGPT 中提供。
我可以用 API 或 MCP 搜尋我的 gammas 嗎？
你可以透過 Gamma API 或連接 Gamma 的 AI 助手（使用 Model Context Protocol，MCP）搜尋整個 gammas 資料庫。搜尋會涵蓋你可存取的每個 gamma 的標題與全文，並依相關性排序，最接近的結果會優先顯示。每個結果都包含直接連結，讓你能從回應中直接開啟該 gamma。
你可以依創作者及最後更新時間縮小搜尋範圍。預設會排除已封存的 gammas，你也可以選擇包含它們。
🔷 注意：搜尋功能正在逐步推出，尚未在所有工作區啟用。如果搜尋端點或 MCP 搜尋工具無法使用，表示你的工作區尚未收到此功能。
完整搜尋參數與範例請參考開發者文件中的 搜尋 gammas 指南，網址為 developers.gamma.app/management/search-gammas。
API 可以用來做什麼？
利用 Gamma API 於 Make、Zapier、Workato 及其他工作流程工具進行自動化。你也可以直接整合後端程式碼，打造自訂應用程式，程式化大量生成簡報，或大規模建立個人化內容。
🔷 注意：你的 inputText 應包含你想放在投影片上的實際內容，而非如何製作簡報的指示。主題必須先在 Gamma 中建立並以 ID 參考，無法透過 inputText 建立。
範本支援
因「範本」對不同用戶意義不同，以下說明可用的範本類型。
視覺主題：你可以在 Gamma 中建立自訂主題，定義簡報的外觀與風格，然後在 API 中以主題 ID 參考它們。使用列出主題 API (GET /v1.0/themes) 取得可用主題 ID。
內容結構範本：我們正努力在未來更新中加入嚴格的內容結構支援。
尋求協助與支援
文件與資源
完整技術參考請參閱 API 參考文件。你也可以查看我們的登陸頁面，了解概覽與入門指南。API 存取包含於 Pro、Ultra、Teams 及 Business 訂閱中。
除錯協助
遇到 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 參考與範例。
➡️ 閱讀開發者文件
常見問題與常見問題解答
我可以與他人分享我的 API 金鑰嗎？
API 金鑰應妥善保管，不可分享。
如有需要，請為不同用途產生不同金鑰。
為什麼我無法再次複製我的 API 金鑰？
出於安全考量，API 金鑰只會在產生時顯示一次。
如果遺失金鑰，需重新產生新的金鑰。
我可以產生多個 API 金鑰嗎？
是的，你可以透過帳戶設定為不同專案或用途建立多個 API 金鑰。
哪些 gammas 會出現在 API 或 MCP 搜尋結果中？
搜尋只會回傳你已有權限存取的 gammas，不會曝光你無法在 Gamma 開啟的內容。
結果依相關性排序，最接近查詢的結果優先顯示。
預設排除已封存的 gammas，除非你選擇包含。
你也可以依創作者及最後更新時間篩選。
為什麼我的工作區搜尋功能無法使用？
搜尋功能正在逐步推出，尚未在所有工作區啟用。
若尚未開放，請聯繫客服並提供
x-request-id，以便我們檢查你的工作區。
如果我用完點數會怎樣？
請在 gamma.app/settings/billing 的帳單設定中啟用自動充值，確保 API 存取不中斷。
API 生成的簡報會出現在 Gamma 儀表板的哪裡？
透過 API 生成的簡報會出現在 Gamma 儀表板的 API Generated 區段，不會出現在你的主要 Gammas 清單（全部、最近查看或你建立的）。
要讓 API 生成的簡報出現在你一般的 Gammas 清單中，請打開該簡報並選擇 複製。複製品會被視為標準的網頁建立 gamma，並會出現在所有常用檢視中。