Check generation status

{baseDir}/scripts/gamma.sh status

List recent generations (if supported)

{baseDir}/scripts/gamma.sh list


## Script Usage

### Generate

```bash
{baseDir}/scripts/gamma.sh generate "<content>" [options]

Options:
  --format       presentation|document|social (default: presentation)
  --cards        Number of cards/slides (default: 10)
  --instructions Additional instructions for styling/tone
  --amount       concise|detailed (default: detailed)
  --tone         e.g., "professional", "casual", "technical"
  --audience     e.g., "investors", "developers", "general"
  --image-source aiGenerated|web|none (default: aiGenerated)
  --image-style  illustration|photo|mixed (default: illustration)
  --wait         Wait for completion and return URL

Examples

# Simple presentation
{baseDir}/scripts/gamma.sh generate "The future of AI automation" --wait

# Pitch deck with specific styling
{baseDir}/scripts/gamma.sh generate "$(cat pitch.md)" \
  --format presentation \
  --cards 15 \
  --instructions "Make it a professional pitch deck for investors" \
  --tone "professional" \
  --audience "investors" \
  --wait

# Social carousel
{baseDir}/scripts/gamma.sh generate "5 tips for productivity" \
  --format social \
  --cards 5 \
  --wait

# Document/report
{baseDir}/scripts/gamma.sh generate "Q4 2025 Performance Report" \
  --format document \
  --amount detailed \
  --wait

API Reference

Endpoint

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

Headers

X-API-KEY: <your-api-key>
Content-Type: application/json

Request Body

{
  "inputText": "Your content (1-750,000 chars)",
  "textMode": "generate",
  "format": "presentation|document|social",
  "numCards": 10,
  "additionalInstructions": "Styling instructions",
  "textOptions": {
    "amount": "concise|detailed",
    "tone": "professional",
    "audience": "target audience"
  },
  "imageOptions": {
    "source": "aiGenerated|web|none",
    "model": "flux-kontext-pro",
    "style": "illustration|photo"
  },
  "cardOptions": {
    "dimensions": "fluid|16x9|4x3|1x1|4x5|9x16"
  }
}

Response

Initial response:

{"generationId": "abc123"}

Poll for status:

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

Completed response:

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

Format Options

Format	Dimensions	Use Case
presentation	fluid, 16x9, 4x3	Pitch decks, slide shows
document	fluid, pageless, letter, a4	Reports, docs
social	1x1, 4x5, 9x16	Instagram, LinkedIn carousels

Notes

Generation typically takes 1-3 minutes
Credits are deducted per generation (~150-300 per deck)
Input text can be markdown formatted
Use --wait flag to block until completion and get URL directly

gamma

Gamma.app API

Setup

Quick Commands