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"
  }'

Response: {"generationId": "xxx"}

Check Status

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

Response (completed): {"status": "completed", "gammaUrl": "https://gamma.app/docs/xxx", "credits": {...}}

Poll every 10-20s until status: "completed".

Key Parameters

Parameter	Values	Notes
`textMode`	`generate`, `condense`, `preserve`	generate=expand, condense=summarize, preserve=keep exact
`format`	`presentation`, `document`, `social`, `webpage`	Output type
`numCards`	1-60 (Pro), 1-75 (Ultra)	Number of slides/cards
`cardSplit`	`auto`, `inputTextBreaks`	Use `\n---\n` in inputText for manual breaks
`exportAs`	`pdf`, `pptx`	Optional export format

Optional Parameters

{
  "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"
  }
}

Note: textOptions.tone and textOptions.audience are ignored when textMode is preserve.

Other Endpoints

GET /themes — List available themes (use themeId in generation)
GET /folders — List folders (use folderIds in generation)

Workflow

Check for API key in environment ($GAMMA_API_KEY) or TOOLS.md
Build inputText with content (can include image URLs inline)
POST to /generations → get generationId
Poll /generations/{id} until status: "completed"
Return gammaUrl to user

gamma

Gamma API Skill

Setup

Authentication

Generate Content