Generate a gamma

post

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

Create a new gamma using this endpoint.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

We highly recommend you read Generate API parameters explained before delving into this page.

For parameters with a long list of accepted values, please reference:

imageOptions.model accepts values listed in Image model accepted values.
textOptions.language accepts values listed in Output language accepted values.
List Themes and List Folders endpoints can be used to find values for the themeId and folderIds parameters.

Generated gammas appear in a separate tab in your dashboard. This tab appears only after you have successfully created at least one gamma using the API.

Body Params

inputText

string

required

Text and image URLs used to generate your gamma. Can be as little as a few words or pages of text. Character limits: 1-100,000 tokens. Example: Pitch deck on deep sea exploration.

textMode

string

enum

required

How you want your inputText to be modified by Gamma, if at all.

Allowed:

format

string

enum

Defaults to presentation

The type of artifact you want to create.

Allowed:

themeId

string

The theme from Gamma that will be used for your creation. You can create custom themes in Gamma. If nothing is specified, the default theme for your workspace is chosen.

numCards

integer

Defaults to 10

How many cards you want to create when cardSplit is set to auto. Options: Pro users choose any integer between 1 and 60; Ultra users choose any integer between 1 and 75.

cardSplit

string

enum

Defaults to auto

How you want your content to be divided up.

Allowed:

additionalInstructions

string

Extra specifications about the desired content and layouts. Character limits: 1-2000. Example: Make the titles catchy.

folderIds

array of strings

The folder(s) where you want to store your gamma.

folderIds

exportAs

string

enum

Additional file types for saving your gamma.

Allowed:

textOptions

object

Attributes of the text you want to generate.

imageOptions

object

Attributes of the images you want to generate, if any.

cardOptions

object

Attributes of the cards you want to generate. Related to the format parameter.

sharingOptions

object

Determines how your gamma is shared with others.

Headers

X-API-KEY

string

required

Enter your API key here.

Responses

200Successful response

400Bad Request

401Unauthorized