Gamma API Skill 用于通过 Gamma 的 AI API 以编程方式创建演示文稿和文档。
用途 该技能适用于需要程序化生成幻灯片、演示文稿、文档、社交帖子或网页的场景，通过调用 Gamma 公开 API 完成内容生成。
设置 从 https://developers.gamma.app 获取 API key。将其存入环境变量：export GAMMA_API_KEY=sk-gamma-xxx，或添加到 TOOLS.md：Gamma API Key: sk-gamma-xxx。
认证 基础地址：https://public-api.gamma.app/v1.0 请求头：X-API-KEY: <your-api-key>
生成内容 使用 POST 请求调用 https://public-api.gamma.app/v1.0/generations，请求头包含 Content-Type: application/json 与 X-API-KEY。请求体可包含 inputText、textMode、format。响应返回 generationId。
查询状态 使用 GET 请求访问 https://public-api.gamma.app/v1.0/generations/<generationId>，请求头包含 X-API-KEY。完成时响应包含 status: completed、gammaUrl 和 credits 信息。建议每 10-20 秒轮询一次，直到 status 为 completed。
主要参数 textMode：generate、condense、preserve，其中 generate 为扩展，condense 为概括，preserve 为保持原文。 format：presentation、document、social、webpage，指定输出类型。 numCards：Pro 为 1-60，Ultra 为 1-75，指定幻灯片或卡片数量。 cardSplit：auto、inputTextBreaks，使用 inputText 中的 \n---\n 进行手动分页。 exportAs：可选，pdf 或 pptx 导出格式。
可选参数 可传入 additionalInstructions、imageOptions（source 可包括 aiGenerated、unsplash、giphy、webAllImages、noImages；model 可包括 imagen-4-pro、flux-1-pro；style）、textOptions（amount 可包括 brief、medium、detailed、extensive；tone；audience；language）、cardOptions（dimensions 可包括 fluid、16x9、4x3、1x1、4x5、9x16）。注意：当 textMode 为 preserve 时，textOptions.tone 和 textOptions.audience 会被忽略。
其他端点 GET /themes：列出可用主题，可在生成时使用 themeId。 GET /folders：列出文件夹，可在生成时使用 folderIds。
工作流程 检查环境变量（$GAMMA_API_KEY）或 TOOLS.md 中是否存在 API key；构建包含内容的 inputText（可在其中内联图片 URL）；向 /generations 发送 POST 请求获取 generationId；轮询 /generations/{id} 直到 status 为 completed；将 gammaUrl 返回给用户。