跳转到主要内容

Gamma API 故障排除

支持范围、常见错误代码及故障排除步骤。

Gamma API 故障排除指南

虽然我们乐于协助所有API相关事宜,但请注意我们的支持团队无法构建工作流、调试您的后端代码(FastAPI、Express、Django等)或排查平台特定问题。

我们可以协助解答关于Gamma端点和参数、API认证、错误排查、积分及验证请求是否符合文档的Gamma特定问题。

如需平台特定帮助,请联系Zapier支持、Make支持或N8N支持。

有关Gamma API的更多信息,请参见:developers.gamma.app


常见错误代码

400 错误请求

参数无效

请检查您的请求:

  • 缺少必填字段(inputText,textMode)

  • 参数值无效

  • 字符/令牌限制超出

查看错误信息以获取具体验证细节。


401 未授权

API密钥无效

您的API密钥无效或未关联Pro账户。

  1. 确认您使用的是X-API-KEY头(非Authorization)

  2. 在gamma.app/settings/billing生成新的API密钥

  3. 确认您的账户拥有有效的Pro、Ultra、Teams或Business计划


403 禁止访问

无可用积分

您的账户API积分已用尽。

请在gamma.app/settings/billing解决此问题:

  • 启用自动充值(推荐)

  • 按需购买积分

  • 升级到更高级别计划


404 未找到

生成ID无效

生成ID不存在或属于其他用户。

请确认您使用的是POST响应中的正确generationId。


422 失败

生成未完成

生成结果为空。

请检查您的请求:

  • 确保inputText内容充足

  • 检查参数是否与输入匹配

  • 如有需要,简化复杂指令


429 请求过多

超出速率限制

您已达到速率限制(每小时50次生成)。

注意:API容量充足,大多数用户正常使用时不会遇到此限制。

解决方案:

  1. 联系Gamma支持申请更高容量

  2. 实施指数退避策略

  3. 分散请求时间


500 服务器内部错误

意外的服务器错误

发生了临时服务器问题。

  1. 请稍候重试

  2. 如持续出现,请携带x-request-id联系支持


502 错误网关

临时网关问题

发生了临时连接问题。

请稍候重试您的请求。



我的API生成的演示文稿未出现在我的Gammas列表中

API生成的演示文稿显示在Gamma仪表板的API生成部分,而非您的主Gammas列表(全部、最近查看或您创建)。这是预期行为——重命名演示文稿不会改变其分类。

解决方法:打开演示文稿并选择复制。复制品将作为常规网页创建的Gamma处理,并显示在您的主Gammas列表中。

仍需帮助?

这是否解答了您的问题?