名称： gamma
描述： 使用 Gamma.app API 生成 AI 驱动的演示文稿、文档和社交媒体帖子。当用户要求创建演示文稿、路演稿、幻灯片、文档或社交媒体轮播图时使用。触发条件包括“创建一个关于 X 的演示文稿”、“制作一个路演稿”、“生成幻灯片”或“创建一个关于 X 的 Gamma”。
元数据： {"clawdbot":{"requires":{"env":["GAMMA_API_KEY"]}}}

Gamma.app API

使用 AI 生成精美的演示文稿、文档和社交媒体帖子。

环境配置

export GAMMA_API_KEY="sk-gamma-xxxxx"

快速命令

# 生成演示文稿
{baseDir}/scripts/gamma.sh generate "您的内容或主题"

# 带选项生成
{baseDir}/scripts/gamma.sh generate "内容" --format presentation --cards 12

# 检查生成状态
{baseDir}/scripts/gamma.sh status <generationId>

# 列出最近的生成记录（如支持）
{baseDir}/scripts/gamma.sh list

脚本使用说明

生成内容

{baseDir}/scripts/gamma.sh generate "<内容>" [选项]

选项：
  --format       演示类型：presentation|document|social (默认：presentation)
  --cards        卡片/幻灯片数量 (默认：10)
  --instructions 额外的样式/语气指令
  --amount       内容详略：concise|detailed (默认：detailed)
  --tone         语气，如 "professional"、"casual"、"technical"
  --audience     受众，如 "investors"、"developers"、"general"
  --image-source 图片来源：aiGenerated|web|none (默认：aiGenerated)
  --image-style  图片风格：illustration|photo|mixed (默认：illustration)
  --wait         等待生成完成并返回 URL

示例

# 简单演示文稿
{baseDir}/scripts/gamma.sh generate "AI 自动化的未来" --wait

# 带特定样式的路演稿
{baseDir}/scripts/gamma.sh generate "$(cat pitch.md)" \
  --format presentation \
  --cards 15 \
  --instructions "制作面向投资者的专业路演稿" \
  --tone "professional" \
  --audience "investors" \
  --wait

# 社交媒体轮播图
{baseDir}/scripts/gamma.sh generate "5 个提高效率的技巧" \
  --format social \
  --cards 5 \
  --wait

# 文档/报告
{baseDir}/scripts/gamma.sh generate "2025 年第四季度业绩报告" \
  --format document \
  --amount detailed \
  --wait

API 参考

请求端点

POST https://public-api.gamma.app/v1.0/generations

请求头

X-API-KEY: <您的 API 密钥>
Content-Type: application/json

请求体

{
  "inputText": "您的内容 (1-750,000 字符)",
  "textMode": "generate",
  "format": "presentation|document|social",
  "numCards": 10,
  "additionalInstructions": "样式指令",
  "textOptions": {
    "amount": "concise|detailed",
    "tone": "professional",
    "audience": "目标受众"
  },
  "imageOptions": {
    "source": "aiGenerated|web|none",
    "model": "flux-kontext-pro",
    "style": "illustration|photo"
  },
  "cardOptions": {
    "dimensions": "fluid|16x9|4x3|1x1|4x5|9x16"
  }
}

响应

初始响应：

{"generationId": "abc123"}

轮询状态：

GET https://public-api.gamma.app/v1.0/generations/<generationId>

完成响应：

{
  "generationId": "abc123",
  "status": "completed",
  "gammaUrl": "https://gamma.app/docs/xxxxx",
  "credits": {"deducted": 150, "remaining": 7500}
}

格式选项

注意事项

• 生成通常需要 1-3 分钟
• 每次生成会消耗积分（约 150-300 积分/个演示文稿）
• 输入文本支持 Markdown 格式
• 使用 --wait 标志可阻塞进程直至生成完成，并直接获取 URL