跳转到主要内容

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 令牌格式）。

💎 专业提示：使用你喜欢的自动化工具开始使用 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 进行引用。使用列表主题 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，以便我们检查您的工作区。

  • 编辑：如果搜索已确认100%，请删除此常见问题。

如果我的积分用完了会怎样？

API生成的演示文稿会显示在Gamma仪表板的哪里？

  • 通过API创建的演示文稿会显示在Gamma仪表板的API生成部分，而不会出现在您的主要Gamma列表（全部、最近查看或您创建的）中。

  • 要让API生成的演示文稿出现在您的常规Gamma列表中，请打开它并选择复制。复制品将被视为标准的网页创建Gamma，并会显示在所有常用视图中。

相关文章
这是否解答了您的问题？