POST /generations

Generate a presentation, document, website, or social post from text.

Start an asynchronous generation from text. Use this endpoint when Gamma should determine the layout from your input and generation settings.

Create async generation

post

Creates an asynchronous generation job from provided text input. Returns a generation ID that can be used to poll for status.

Authorizations

api-key

X-API-KEYstringRequired

API key for authentication

Body

application/json

inputTextstring · min: 1 · max: 400000Required

Input text for generation — a topic, outline, or full content. Max 400,000 characters.

Example: Quarterly sales report for Q3 2024

additionalInstructionsstring · max: 5000Optional

Additional context or instructions for AI

Example: Focus on year-over-year growth metrics

textModestring · enumRequired

How to interpret the input text

Example: generatePossible values:

formatstring · enumOptional

Output format

Example: presentationPossible values:

numCardsnumber · min: 1Optional

Target number of cards to generate. Limits vary by plan.

Example: 10

cardSplitstring · enumOptional

Content splitting strategy across cards

Example: autoPossible values:

themeIdstringOptional

Theme ID to apply. Get available IDs from the GET /themes endpoint.

Example: theme_abc123

folderIdsstring[] · max: 10Optional

Folder IDs to place the generated Gamma in. Get available IDs from the GET /folders endpoint.

Example: ["folder_abc"]

exportAsstring · enumOptional

Auto-export format after generation completes.

Example: pdfPossible values:

Responses

200

Generation job created successfully

application/json

generationIdstringRequired

Unique generation job identifier for status polling

Example: abc123xyz

warningsstringOptional

Warnings about ignored or adjusted request parameters

Example: Image model ignored when source is 'web'

201Success

application/json

400

Invalid request parameters

401

Invalid or missing API key

402

Insufficient credits

403

Access denied or feature not available

post

/v1.0/generations

HTTPcURLJavaScriptPython

POST /v1.0/generations HTTP/1.1
Host: public-api.gamma.app
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 1446

{
  "inputText": "Quarterly sales report for Q3 2024",
  "additionalInstructions": "Focus on year-over-year growth metrics",
  "textMode": "generate",
  "format": "presentation",
  "numCards": 10,
  "cardSplit": "auto",
  "themeId": "theme_abc123",
  "textOptions": {
    "amount": "auto",
    "tone": "professional",
    "audience": "marketing executives",
    "language": "en"
  },
  "imageOptions": {
    "model": "flux-kontext-fast",
    "style": "photorealistic, professional",
    "source": "aiGenerated"
  },
  "cardOptions": {
    "dimensions": "16x9",
    "headerFooter": {
      "topLeft": {
        "type": "text",
        "source": "themeLogo",
        "src": "https://example.com/logo.png",
        "value": "Confidential",
        "size": "md"
      },
      "topCenter": {
        "type": "text",
        "source": "themeLogo",
        "src": "https://example.com/logo.png",
        "value": "Confidential",
        "size": "md"
      },
      "topRight": {
        "type": "text",
        "source": "themeLogo",
        "src": "https://example.com/logo.png",
        "value": "Confidential",
        "size": "md"
      },
      "bottomLeft": {
        "type": "text",
        "source": "themeLogo",
        "src": "https://example.com/logo.png",
        "value": "Confidential",
        "size": "md"
      },
      "bottomCenter": {
        "type": "text",
        "source": "themeLogo",
        "src": "https://example.com/logo.png",
        "value": "Confidential",
        "size": "md"
      },
      "bottomRight": {
        "type": "text",
        "source": "themeLogo",
        "src": "https://example.com/logo.png",
        "value": "Confidential",
        "size": "md"
      },
      "hideFromFirstCard": true,
      "hideFromLastCard": false
    }
  },
  "sharingOptions": {
    "workspaceAccess": "view",
    "externalAccess": "noAccess",
    "emailOptions": {
      "recipients": [
        "[email protected]"
      ],
      "access": "view"
    }
  },
  "folderIds": [
    "folder_abc"
  ],
  "exportAs": "pdf"
}

{
  "generationId": "abc123xyz",
  "warnings": "Image model ignored when source is 'web'"
}

For parameter guidance, see Generate from text.

Related

• Generate from text for parameter-by-parameter guidance

• GET /generations/{id} for the polling step after creation