Gamma API 故障排除指南
虽然我们乐于协助所有API相关事宜,但请注意我们的支持团队无法构建工作流、调试您的后端代码(FastAPI、Express、Django等)或排查平台特定问题。
我们可以协助解答关于Gamma端点和参数、API认证、错误排查、积分及验证请求是否符合文档的Gamma特定问题。
有关Gamma API的更多信息,请参见:developers.gamma.app
常见错误代码
400 错误请求
参数无效
请检查您的请求:
缺少必填字段(
inputText,textMode)参数值无效
字符/令牌限制超出
查看错误信息以获取具体验证细节。
401 未授权
API密钥无效
您的API密钥无效或未关联Pro账户。
确认您使用的是
X-API-KEY头(非Authorization)在gamma.app/settings/billing生成新的API密钥
确认您的账户拥有有效的Pro、Ultra、Teams或Business计划
403 禁止访问
无可用积分
您的账户API积分已用尽。
请在gamma.app/settings/billing解决此问题:
启用自动充值(推荐)
按需购买积分
升级到更高级别计划
404 未找到
生成ID无效
生成ID不存在或属于其他用户。
请确认您使用的是POST响应中的正确generationId。
422 失败
生成未完成
生成结果为空。
请检查您的请求:
确保
inputText内容充足检查参数是否与输入匹配
如有需要,简化复杂指令
429 请求过多
超出速率限制
您已达到速率限制(每小时50次生成)。
注意:API容量充足,大多数用户正常使用时不会遇到此限制。
解决方案:
联系Gamma支持申请更高容量
实施指数退避策略
分散请求时间
500 服务器内部错误
意外的服务器错误
发生了临时服务器问题。
请稍候重试
如持续出现,请携带
x-request-id联系支持
502 错误网关
临时网关问题
发生了临时连接问题。
请稍候重试您的请求。
我的API生成的演示文稿未出现在我的Gammas列表中
API生成的演示文稿显示在Gamma仪表板的API生成部分,而非您的主Gammas列表(全部、最近查看或您创建)。这是预期行为——重命名演示文稿不会改变其分类。
解决方法:打开演示文稿并选择复制。复制品将作为常规网页创建的Gamma处理,并显示在您的主Gammas列表中。
仍需帮助?
常规支持: 如何联系Gamma支持
API社区: 加入Gamma API Slack
SSO问题:联系您组织的IT管理员
