用途：这是一份 Gamma API 常见错误的调试与解决参考指南，适用于遇到认证失败、速率限制、生成错误或异常 API 响应时使用。
主要能力：按访问、内容生成、发布/分享、集成、配额、可用性对故障分类；给出各类错误的处理建议。认证错误（401/403）需核对 Gamma 面板中的 API 密钥、检查环境变量 echo $GAMMA_API_KEY、确认密钥未被轮换及无尾部空格。速率限制（429）建议实现指数退避、查看 X-RateLimit-Remaining 头、排队请求。生成错误（400/500）建议简化提示词、减少幻灯片数量、去除特殊字符、检查内容长度、更换样式。超时错误可增大客户端超时或改用异步任务模式。导出失败需确认演示文稿完整、格式受支持、无待处理生成任务。
使用方式：在暂存环境安全复现，应用最小可逆修正，验证恢复与安全失败行为。可开启 debug 日志、调用 gamma.status() 检查 API 状态，并按错误类型分别处理。输出应包含关联 ID、错误类别、纠正措施、验证、负责人与后续跟进，且不得在证据中保留私密内容、查看者信息或凭据。
限制：资料未提供具体价格、平台支持范围或效果保证；权限、目标或隐私失败时应暂停分享/发布，瞬时错误使用有界重试，重放内容操作前先回滚。