Gamma API 演示与文档
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-gamma-2。
技能介绍
要解决什么问题
手上有结构化或半结构化的文字(提纲、纪要、长文),却要在 Gamma 里做成可分享的演示稿、文档或网页,又不想逐页在 UI 里粘贴排版时,唯一靠谱的路径往往是官方 API:一次提交 inputText,异步拿到 generationId,再轮询直到 status 为 completed,最后把 gammaUrl 交给协作者或读者。
技能如何工作
技能围绕 Gamma 的 生成 → 查询 工作流组织,并假定你已配置 GAMMA_API_KEY(环境变量或 TOOLS.md)。
- 发起生成:向
/generations发送POST,正文可内联图片 URL;常用参数包括textMode(generate扩写、condense摘要、preserve原样保留)、format(presentation/document/social/webpage)、numCards(幻灯片数量)、cardSplit(auto或按\n---\n手动分页)、可选exportAs(pdf/pptx)。 - 轮询状态:每 10~20 秒查询
/generations/{id},直至返回completed及gammaUrl(及credits等信息)。 - 辅助端点:
GET /themes选用themeId,GET /folders指定folderIds归档位置。
助手按上述顺序代你组参、发起请求并汇报链接,而不是替你构思幻灯片美学或品牌视觉。
边界与注意点
textMode为preserve时,textOptions.tone与textOptions.audience会被忽略;扩写/摘要才走 tone、audience。numCards上限取决于 Gamma 套餐(资料中 Pro 1~60、Ultra 1~75);超限需自行收敛提纲或分次生成。- 技能不替代 Gamma 账号计费与配额管理;API Key 需自行在 developers.gamma.app 申请并妥善保管。
使用场景
- 技术分享前把 Markdown 提纲和配图 URL 打成 Gamma 演示稿并拿到分享链接
- 内审材料需要从长文 condense 成固定页数的 document 并可选导出 pptx
- 社媒 Campaign 文案按 social 格式生成多 card 稿件并归档到指定 folder
- 客户交付物要求 preserve 原文、按 \n---\n 分页且不改动语气
适合人员
- 经常要把内部文档同步成对外演示链接的技术布道同学
- 用脚本跑内容流水、需要 themeId 与 exportAs 参数的产品运营
- 维护自动化报告管线、要把 API 轮询结果写回工单系统的后端工程师
- 代理客户做多版本 webpage/document,且需按套餐控制 numCards 的交付顾问