Gamma

# Gamma.app API

Generate beautiful presentations, documents, and social posts with AI.

## Setup

```bash export GAMMA_API_KEY="sk-gamma-xxxxx" ```

## Quick Commands

```bash # Generate a presentation {baseDir}/scripts/gamma.sh generate "Your content or topic here"

# Generate with options {baseDir}/scripts/gamma.sh generate "Content" --format presentation --cards 12

# Check generation status {baseDir}/scripts/gamma.sh status <generationId>

# 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

```bash # 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

```json { "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: ```json {"generationId": "abc123"} ```

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

Completed response: ```json { "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