gamma

Original：🇺🇸 English

Translated

Gamma API for creating presentations, documents, and websites from text. Use when user mentions "Gamma", "create presentation", "generate slides", "make a deck", "create a document with Gamma", or "generate a webpage".

4installs

Sourcevm0-ai/vm0-skills

Added on2026-05-03

NPX Install

npx skill4agent add vm0-ai/vm0-skills gamma

SKILL.md Content

View Translation Comparison →

Troubleshooting

If requests fail, run

zero doctor check-connector --env-name GAMMA_TOKEN

or

zero doctor check-connector --url https://public-api.gamma.app/v1.0/generations --method POST

Core APIs

1. Create Generation (from text)

Generates a presentation, document, website, or social post from text input. Generation is asynchronous — use the returned

generationId

to poll for status.

Write to

/tmp/gamma_request.json

:

json

{
  "inputText": "Your outline or topic text here",
  "textMode": "generate",
  "format": "presentation",
  "numCards": 10,
  "textOptions": {
    "amount": "medium",
    "language": "en"
  },
  "imageOptions": {
    "source": "pexels"
  }
}

bash

curl -s -X POST "https://public-api.gamma.app/v1.0/generations" --header "X-API-KEY: $GAMMA_TOKEN" --header "Content-Type: application/json" -d @/tmp/gamma_request.json

Response includes

generationId

. Use it to poll for status (see below).

textMode
options:

```
generate
```
— AI rewrites the input into polished content
```
condense
```
— compress verbose input
```
preserve
```
— keep the original text structure

format
options:

presentation

,

document

,

social

,

webpage

exportAs
options (optional):

pdf

,

pptx

,

png

2. Poll Generation Status

Poll every 5 seconds until

status

is

completed

or

failed

.

bash

curl -s "https://public-api.gamma.app/v1.0/generations/<your-generation-id>" --header "X-API-KEY: $GAMMA_TOKEN"

Pending response:

json

{ "generationId": "...", "status": "pending" }

Completed response:

json

{
  "generationId": "...",
  "status": "completed",
  "gammaId": "...",
  "gammaUrl": "https://gamma.app/docs/...",
  "exportUrl": "https://gamma.app/export/...",
  "credits": { "deducted": 5, "remaining": 195 }
}

gammaUrl

is the shareable link.

exportUrl

(when

exportAs

was set) is a signed download URL valid for ~1 week.

3. Create Generation from Template

Generate content using an existing Gamma template. The template must be a single-page document.

Write to

/tmp/gamma_template_request.json

:

json

{
  "prompt": "Describe what content to fill into the template",
  "gammaId": "<your-template-gamma-id>",
  "imageOptions": {
    "style": "professional photography"
  }
}

bash

curl -s -X POST "https://public-api.gamma.app/v1.0/generations/from-template" --header "X-API-KEY: $GAMMA_TOKEN" --header "Content-Type: application/json" -d @/tmp/gamma_template_request.json

Response includes

generationId

— poll with the same status endpoint.

4. List Themes

Retrieve available workspace themes to use as

themeId

in generation requests.

bash

curl -s "https://public-api.gamma.app/v1.0/themes" --header "X-API-KEY: $GAMMA_TOKEN"

With search filter:

bash

curl -s "https://public-api.gamma.app/v1.0/themes?query=dark&limit=10" --header "X-API-KEY: $GAMMA_TOKEN"

Use the

id

field value as

themeId

in generation requests.

5. List Folders

Retrieve workspace folders to use as

folderIds

in generation requests.

bash

curl -s "https://public-api.gamma.app/v1.0/folders" --header "X-API-KEY: $GAMMA_TOKEN"

Use the

id

field value in the

folderIds

array in generation requests.

Advanced Generation Options

With theme, folder, and sharing

Write to

/tmp/gamma_request.json

:

json

{
  "inputText": "Q1 2025 Product Roadmap\n---\nGoals\n---\nKey Initiatives\n---\nTimeline",
  "textMode": "preserve",
  "format": "presentation",
  "themeId": "<your-theme-id>",
  "folderIds": ["<your-folder-id>"],
  "exportAs": "pdf",
  "cardOptions": {
    "dimensions": "16x9"
  },
  "sharingOptions": {
    "externalAccess": "view"
  }
}

bash

curl -s -X POST "https://public-api.gamma.app/v1.0/generations" --header "X-API-KEY: $GAMMA_TOKEN" --header "Content-Type: application/json" -d @/tmp/gamma_request.json

Use

\n---\n

in

inputText

to manually split slides/cards.

Guidelines

Async pattern: Generation always returns a
```
generationId
```
first. Always poll
```
GET /v1.0/generations/<id>
```
until
```
status
```
is
```
completed
```
or
```
failed
```
. Poll every 5 seconds.
Credits: Text costs 1–3 credits per card; AI-generated images cost 2–125 credits per image. Check
```
credits.remaining
```
in the completed response.
Rate limits: Responses include
```
x-ratelimit-remaining
```
headers. On 429, pause 30+ seconds before retrying.
Export URLs: Signed
```
exportUrl
```
values expire in ~1 week. Download promptly if needed.
Image URLs in input: Any image URLs embedded in
```
inputText
```
must be long-lived (signed URLs need 7+ day expiration).
Plan requirement: API access requires Pro, Ultra, Teams, or Business plan.

gamma

NPX Install

Tags

SKILL.md Content

Troubleshooting

Core APIs

1. Create Generation (from text)

2. Poll Generation Status

3. Create Generation from Template

4. List Themes

5. List Folders

Advanced Generation Options

With theme, folder, and sharing

Guidelines