什么是 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 令牌格式）。
💎 专业提示：使用你喜欢的自动化工具开始使用 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 和模型上下文协议（MCP）生成独立图片。这允许你单独编程创建图片，而非生成完整演示文稿、文档或网页。通过 API 或 MCP 生成图片，请参阅开发者文档中的 创建图片生成 指南，链接：developers.gamma.app/images/create-image-generation。MCP 图片生成功能现已在 Claude 和其他 MCP 客户端可用，ChatGPT 尚未支持。
我可以用 API 或 MCP 搜索我的 gammas 吗？
你可以通过 Gamma API 或连接 Gamma 的 AI 助手（使用模型上下文协议 MCP）搜索你的整个 gamma 库。搜索涵盖每个 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 默认被排除，除非你选择包含它们。
你还可以按创建者和最后更新时间筛选。
为什么我的工作区搜索不起作用？
跨 gammas 的搜索功能正在逐步推出，尚未为所有工作区启用。
如果不可用，请联系客户支持并提供你的
x-request-id，以便我们检查你的工作区。
如果我用完了积分会怎样？
在 gamma.app/settings/billing 的账单设置中启用自动充值，确保 API 访问不中断。
API 生成的演示文稿会出现在 Gamma 仪表盘的哪里？
通过 API 创建的演示文稿会出现在 Gamma 仪表盘的 API 生成 部分，而非你的主 Gammas 列表（全部、最近查看或你创建的）。
要让 API 生成的演示文稿出现在常规 Gammas 列表中，请打开它并选择 复制。复制品将作为标准网页创建的 gamma 处理，并显示在所有常用视图中。