用途:Gamma 未发布官方 SDK,所有交互通过 REST 接口 https://public-api.gamma.app/v1.0/ 完成。本技能提供生产级模式,用于类型化客户端、生成辅助、轮询、模板工作流与错误处理。
主要能力:类型化客户端单例(getGamma/createGammaClient),封装 generate、generateFromTemplate、poll、getFileUrls、listThemes、listFolders;自定义 GammaApiError 错误类,提供 isRateLimit、isAuth、isServerError 判断;pollUntilDone 轮询辅助(可配置间隔与超时);generateAndWait 生成并等待;基于模板的生成(模板 gamma 须恰好一页);withRetry 指数退避重试(仅对 429/5xx 重试,不重试鉴权与 4xx)。
接口参考:POST /v1.0/generations 从文本生成;POST /v1.0/generations/from-template 从模板生成;GET /v1.0/generations/{id} 轮询状态;GET /v1.0/generations/{id}/files 获取导出文件 URL;GET /v1.0/themes 列出主题;GET /v1.0/folders 列出文件夹。
使用方式:需先完成 gamma-install-auth 设置,使用 Node.js 18+ 且支持 fetch 的 TypeScript 项目,并理解生成-轮询-取回流程。请求头使用 X-API-KEY 与 Content-Type: application/json。
限制:输出为客户端校验回执,含契约/夹具版本、不透明操作 ID、schema 结果、幂等结果、负责人与脱敏失败引用;不得记录展示内容或令牌。验证应使用受限的暂存集成与虚构文档,在调用提供方前拒绝未知目标,仅保留聚合结果。资料未提供具体收费、价格与平台信息。