Gamma API 技能

通过 Gamma 的 API 以编程方式创建演示文稿和文档。

设置

1. 从以下网址获取 API 密钥https://developers.gamma.app
2. 存储在环境变量中：export GAMMA_API_KEY=sk-gamma-xxx或添加到 TOOLS.md 文件：Gamma API 密钥：sk-gamma-xxx

认证

Base URL: https://public-api.gamma.app/v1.0
Header: X-API-KEY: <your-api-key>

生成内容

curl -X POST https://public-api.gamma.app/v1.0/generations \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: $GAMMA_API_KEY" \
  -d '{
    "inputText": "Your content here",
    "textMode": "generate|condense|preserve",
    "format": "presentation|document|social|webpage"
  }'

响应： {"generationId": "xxx"}

检查状态

curl https://public-api.gamma.app/v1.0/generations/<generationId> \
  -H "X-API-KEY: $GAMMA_API_KEY"

响应（完成时）： {"status": "completed", "gammaUrl": "https://gamma.app/docs/xxx", "credits": {...}}

每 10-20 秒轮询一次，直到状态变为："completed"。

关键参数

可选参数

{
  "additionalInstructions": "Make titles catchy",
  "imageOptions": {
    "source": "aiGenerated|unsplash|giphy|webAllImages|noImages",
    "model": "imagen-4-pro|flux-1-pro",
    "style": "photorealistic, modern"
  },
  "textOptions": {
    "amount": "brief|medium|detailed|extensive",
    "tone": "professional, inspiring",
    "audience": "tech professionals",
    "language": "en"
  },
  "cardOptions": {
    "dimensions": "fluid|16x9|4x3|1x1|4x5|9x16"
  }
}

注意：textOptions.tone和textOptions.audience在textMode为preserve时将被忽略。

其他端点

• GET /themes— 列出可用主题（在生成时使用themeId）
• GET /folders— 列出文件夹（在生成时使用folderIds）

工作流程

1. 在环境中检查API密钥 ($GAMMA_API_KEY) 或 TOOLS.md
2. 构建输入文本包含内容（可以内联包含图片URL）
3. POST 到/generations→ 获取生成ID
4. 轮询/generations/{id}直到状态: "已完成"
5. 返回gammaUrl给用户