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