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 

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

脚本使用说明

generate（生成）

{baseDir}/scripts/gamma.sh generate "" [options]

选项：
  --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: 
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": "abc123",
  "status": "completed",
  "gammaUrl": "https://gamma.app/docs/xxxxx",
  "credits": {"deducted": 150, "remaining": 7500}
}

格式选项

注意事项

• 生成通常耗时 1–3 分钟
• 每次生成将扣除相应积分（每份演示文稿约 150–300 积分）
• 输入文本支持 Markdown 格式
• 使用 --wait 参数可阻塞等待直至完成，并直接获取 URL