Gamma.app — Presentations & Documents API#

Create presentations, documents, social posts, and web pages programmatically via the Gamma API.

Homepage: https://gamma.app API Docs: https://developers.gamma.app/docs/getting-started Runtime dependencies: curl, python3 (for JSON building/parsing)

Setup#

Set the environment variable before using:

bash

export GAMMA_API_KEY="sk-gamma-xxxxx"  # Get from https://gamma.app/settings

The script only makes network calls to https://public-api.gamma.app/v1.0. Your API key and inputText content are sent to Gamma's servers.

Quick Start#

Generate a presentation#

bash

bash scripts/gamma.sh generate "AI trends in 2026 for business leaders" \
  --format presentation --num-cards 10 --export pdf --wait

Generate a document#

bash

bash scripts/gamma.sh generate "Quarterly marketing report Q1 2026" \
  --format document --text-mode generate --amount detailed \
  --tone "professional" --audience "executive team" --export pdf --wait

Create from template#

bash

bash scripts/gamma.sh template "g_abcdef123" "Update this pitch deck for Twist Broadband client" \
  --export pdf --wait

Check status manually#

bash

bash scripts/gamma.sh status "generationId123"

List themes and folders#

bash

bash scripts/gamma.sh themes
bash scripts/gamma.sh themes "dark"
bash scripts/gamma.sh folders

Script Reference#

scripts/gamma.sh <command> [args] [options]

Commands#

CommandArgsDescriptiongenerate``"inputText"Create from scratchtemplate``"gammaId" "prompt"Create from existing templatestatus``"generationId"Check generation statusthemes``[query]List available themesfolders``[query]List workspace folders

Generate Options#

OptionValuesDefault--formatpresentation, document, social, webpagepresentation--text-modegenerate, condense, preservegenerate--num-cards1-60 (Pro) / 1-75 (Ultra)10--card-splitauto, inputTextBreaksauto--themetheme ID from themes command(Gamma picks)--exportpdf, pptx(none)--tonefree text(none)--audiencefree text(none)--languageISO code (en, es, fr...)(auto)--amountbrief, medium, detailed, extensive(auto)--image-sourceaiGenerated, pexels, noImages, etc.(auto)--image-modelflux-1-pro, imagen-4-pro, etc.(auto)--image-stylefree text ("photorealistic")(none)--instructionsadditional guidance (max 2000 chars)(none)--dimensionsfluid, 16x9, 4x3, 1x1, 4x5, 9x16, a4, letterfluid--workspace-accessnoAccess, view, comment, edit, fullAccess(default)--external-accessnoAccess, view, comment, edit(default)--folderfolder ID (comma-separated for multiple)(none)--wait(flag) Poll until generation completesfalse--poll-intervalseconds between polls5

Workflow#

1. Generate — POST creates the gamma, returns a generationId
2. Poll — Use --wait or manually check status until completed
3. Result — Completed response includes gammaUrl (live link) and export download URL if requested
4. Credits — Response shows credits.deducted and credits.remaining

Input Tips#

• Short prompts work ("AI trends 2026") but detailed structured text produces better results
• Insert image URLs directly in inputText where you want them placed
• Use \n---\n in inputText to force card breaks (set --card-split inputTextBreaks)
• To use only your images (no AI-generated ones), set --image-source noImages
• JSON-escape special characters in inputText

Credit Costs#

• Cards: 1-5 credits each
• AI images: 2 credits (basic) to 125 credits (ultra) per image
• Example: 10-card deck with basic AI images ≈ 20-60 credits

Full API Reference#

For complete parameter details, header/footer configuration, and sharing options, read references/api-reference.md.