Gamma Presentations

核心用法

Gamma API 是一项面向开发者的程序化内容生成服务，支持四种输出格式：演示文稿（presentation）、文档（document）、社交媒体内容（social）和网页（webpage）。用户通过 HTTP POST 请求提交 inputText，选择 textMode（generate/condense/preserve）控制内容处理方式，并指定格式参数即可触发异步生成任务。系统返回 generationId 后需轮询状态直至完成，最终获取可分享的 Gamma 链接。

关键特性包括：

• 智能内容处理：generate 模式基于输入扩写完整内容，condense 自动摘要提炼，preserve 严格保留原文不变
• 灵活卡片控制：支持 1-75 张幻灯片（视套餐等级），可通过 \n---\n 分隔符手动控制分页
• 多媒体集成：内置 AI 图像生成（Imagen-4 Pro/Flux-1 Pro）、Unsplash/Giphy 图库接入，或完全禁用图片
• 精细化文本调优：可指定文本量（brief 到 extensive）、语气风格、目标受众及语言
• 导出选项：支持 PDF 和 PPTX 格式导出

显著优点

1. 官方原生接口：直接对接 Gamma 平台核心能力，生成内容与在线编辑器体验一致
2. 异步架构设计：长时生成任务不阻塞调用方，适合集成到自动化工作流
3. 多模态输出：单一 API 覆盖从社交媒体短图到完整网页的多元场景
4. 品牌一致性：可通过 themeId 绑定预设主题，确保输出符合企业视觉规范

潜在局限

• 轮询依赖：无 webhook 推送机制，需自行实现 10-20 秒间隔的状态轮询逻辑
• 配额限制：卡片数量上限因订阅等级而异（Pro 60 张/Ultra 75 张），大篇幅内容需分段处理
• 保留模式限制：当 textMode 设为 preserve 时，tone 和 audience 参数被忽略，精细化调控失效
• 内容可控性：AI 生成内容的准确性、合规性需人工复核，不适合直接用于高风险场景

适合人群

• 需要将内容生成嵌入内部系统的开发团队
• 追求批量、自动化制作营销材料、培训课件的内容运营者
• 希望以代码方式统一品牌视觉输出的企业用户

常规风险

• API 密钥泄露：密钥以明文环境变量或 TOOLS.md 形式存储，存在误提交至版本控制的风险
• 内容合规风险：AI 生成的图像和文本可能涉及版权、偏见或事实错误，商用前需法律审核
• 服务依赖性：生成结果托管于 Gamma 平台，长期可访问性受平台政策约束
• 额度消耗：每次调用消耗账户积分，高频自动化场景需监控配额避免服务中断

核心用法

Gamma Skill 是一个纯文档型技能，提供 Gamma AI 平台的 API 集成指南，用于程序化创建专业级演示文稿、文档、社交媒体内容和网页。

主要功能流程：
1. 配置 API 密钥（环境变量 $GAMMA_API_KEY 或 TOOLS.md）
2. 调用 /generations 端点提交内容，支持 generate（扩写）、condense（精简）、preserve（保留原文）三种文本模式
3. 轮询查询生成状态，获取可分享的 Gamma 链接
4. 可选导出 PDF/PPTX 格式

关键特性：

• 支持 presentation（演示文稿）、document（文档）、social（社媒帖子）、webpage（网页）四种输出格式
• AI 图像生成（Imagen-4 Pro/Flux-1 Pro）或 Unsplash/GIPHY 图库集成
• 丰富的文本自定义：篇幅（brief 到 extensive）、语气、受众定位、多语言支持
• 灵活分卡：自动拆分或手动用 \n---\n 控制分页

显著优点

1. 官方可信 API：所有端点均归属 Gamma 官方域名（public-api.gamma.app），TLS 加密传输，API 密钥不硬编码
2. 零代码安全风险：纯 Markdown 文档，无可执行代码、无危险函数、无依赖文件，供应链攻击面为零
3. 创作效率极高：一句话即可生成完整幻灯片，支持 1-75 页（Ultra 套餐），大幅压缩制作时间
4. 输出多样性：从内部汇报 PPT 到公开网页、从 Twitter 帖子到长文文档，一套 API 覆盖

潜在局限

1. 外部服务依赖：完全依赖 Gamma 平台可用性与 API 配额，无本地降级方案
2. 异步轮询模式：需 10-20 秒间隔轮询状态，实时性较弱，不适合同步阻塞场景
3. 成本不透明：文档未说明 Gamma 平台本身的订阅费用与 API 调用计费规则
4. 社区维护：Skill 由个人开发者贡献（mrgoodb），非官方维护，文档更新可能滞后于 Gamma API 变更
5. 内容可控性：AI 生成内容的风格一致性需多次调参，复杂排版仍需人工后期调整

适合人群

• 商务人士：快速制作投资人路演、季度汇报、培训材料
• 内容运营：批量生成社媒图文、博客长文、落地页
• 教育工作者：课件、教案、学生作业模板
• 开发者：构建自动化报告生成工作流

常规风险

• API 密钥泄露：若用户误将密钥写入日志或提交至版本控制，存在账户盗用风险
• 平台服务中断：Gamma 服务异常时将无法生成内容
• 生成内容版权：AI 生成图像与文本的版权归属需参考 Gamma 平台条款
• 隐私合规：输入内容上传至 Gamma 服务器，敏感商业数据需谨慎评估