什么是 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 v0.2 已弃用,将于 2026 年 1 月 16 日停止服务。如果你当前使用的是 v0.2,请在此日期前迁移到 v1.0。
有关具体 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 令牌格式)。
💎 专业提示:使用你喜欢的自动化工具开始使用 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:新增端点列出你的主题和文件夹。
搜索 Gamma:搜索你可访问的 Gamma 标题和全文,并在打开前筛选结果。
更好的输入限制:支持最多 100,000 令牌(约 400,000 字符)。
🌀 提示:随着 API 发展,我们将持续添加更多选项,支持以编程方式修改和重混 Gamma。
我可以用 API 生成独立图片吗?
你现在可以通过 Gamma Generate API 和模型上下文协议(MCP)生成独立图片。这允许你单独编程创建图片,而非生成完整演示文稿、文档或网页。通过 API 或 MCP 生成图片,请参阅开发者文档中的 创建图片生成 指南,网址为 developers.gamma.app/images/create-image-generation。MCP 图片生成功能现已在 Claude 和其他 MCP 客户端可用,ChatGPT 尚未支持。
我可以用 API 或 MCP 搜索我的 Gamma 吗?
你可以通过 Gamma API 或连接到 Gamma 的 AI 助手使用模型上下文协议(MCP)搜索你的整个 Gamma 库。搜索涵盖每个 Gamma 的标题和全文,并按相关性排序,最匹配的结果优先显示。每个结果包含直接链接,可直接从响应中打开 Gamma。
你可以按创建者和最后更新时间缩小搜索范围。默认排除归档的 Gamma,你也可以选择包含它们。
🔷 注意:搜索功能正在逐步推出,尚未在所有工作区可用。如果搜索端点或 MCP 搜索工具无法使用,说明你的工作区尚未获得该功能。
完整搜索参数和示例请求,请参阅开发者文档中的 搜索 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。
内容结构模板:我们正在努力在未来更新中添加严格的内容结构支持。
获取帮助和支持
文档和资源
完整的技术参考,请访问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参考和示例。
➡️ 阅读开发者文档
常见问题与常见问题解答
我可以与他人共享我的API密钥吗?
API密钥应保持安全,切勿共享。
如有需要,可为不同用途生成不同密钥。
为什么我不能再次复制我的API密钥?
出于安全原因,API密钥只在生成时显示一次。
如果丢失密钥,您需要生成新的密钥。
我可以生成多个API密钥吗?
是的,您可以通过账户设置为不同项目或用途创建多个API密钥。
哪些Gamma会出现在API或MCP搜索结果中?
搜索仅返回您已有访问权限的Gamma,因此不会暴露您无法在Gamma中打开的内容。
结果按相关性排序,最匹配您的查询的结果排在最前。
归档的Gamma除非您选择包含,否则不会显示。
您还可以按创建者和Gamma的最后更新时间进行筛选。
为什么我的工作区搜索不起作用?
跨Gamma搜索正在逐步推出,尚未对所有工作区开放。
如果不可用,请联系客户支持并提供您的
x-request-id,以便我们检查您的工作区。
我需要从v0.2迁移到v1.0吗?
是的,v0.2将于2026年1月16日停止服务。
迁移很简单:将基础URL从
/v0.2/更新为/v1.0/。将
themeName参数更改为themeId(ID可通过List Themes API获取)。更新输入限制——v1.0使用10万个令牌,替代75万个字符。
查看API文档,了解完整的v1.0端点详情。
v0.2和v1.0的主要区别是什么?
v1.0提供更宽松的速率限制(每小时数百次,vs每天50次)。
v1.0支持网页格式。
更好的输入限制(10万个令牌,vs 75万个字符)。
主题和文件夹的文件夹组织及列表API。
如果我的积分用完了会怎样?
在 gamma.app/settings/billing 的计费设置中启用自动充值,确保API访问不中断。
API生成的演示文稿会显示在Gamma仪表板的哪里?
通过API创建的演示文稿会显示在Gamma仪表板的API生成部分,而不会出现在您的主Gamma列表(全部、最近查看或您创建的)中。
要让API生成的演示文稿出现在您的常规Gamma列表中,请打开它并选择复制。复制品被视为标准的网页创建Gamma,并会显示在所有常用视图中。
