Gamma

使用说明

Integrate Gamma into the workflow. Can generate presentations, documents, webpages, and social posts from text, create from templates, check generation status, and browse themes and folders.

工具

`gamma_generate`

Generate a new Gamma presentation, document, webpage, or social post from text input.

输入

参数	类型	必填	描述
`apiKey`	string	是	Gamma API key
`inputText`	string	是	Text and image URLs used to generate your gamma (1-100,000 tokens)
`textMode`	string	是	How to handle input text: generate (AI expands), condense (AI summarizes), or preserve (keep as-is)
`format`	string	否	Output format: presentation, document, webpage, or social (default: presentation)
`themeId`	string	否	Custom Gamma workspace theme ID (use List Themes to find available themes)
`numCards`	number	否	Number of cards/slides to generate (1-60 for Pro, 1-75 for Ultra; default: 10)
`cardSplit`	string	否	How to split content into cards: auto or inputTextBreaks (default: auto)
`cardDimensions`	string	否	Card aspect ratio. Presentation: fluid, 16x9, 4x3. Document: fluid, pageless, letter, a4. Social: 1x1, 4x5, 9x16
`additionalInstructions`	string	否	Additional instructions for the AI generation (max 2000 chars)
`exportAs`	string	否	Automatically export the generated gamma as pdf or pptx
`folderIds`	string	否	Comma-separated folder IDs to store the generated gamma in
`textAmount`	string	否	Amount of text per card: brief, medium, detailed, or extensive
`textTone`	string	否	Tone of the generated text, e.g. "professional", "casual" (max 500 chars)
`textAudience`	string	否	Target audience for the generated text, e.g. "executives", "students" (max 500 chars)
`textLanguage`	string	否	Language code for the generated text (default: en)
`imageSource`	string	否	Where to source images: aiGenerated, pictographic, unsplash, webAllImages, webFreeToUse, webFreeToUseCommercially, giphy, placeholder, or noImages
`imageModel`	string	否	AI image generation model to use when imageSource is aiGenerated
`imageStyle`	string	否	Style directive for AI-generated images, e.g. "watercolor", "photorealistic" (max 500 chars)

输出

参数	类型	描述
`generationId`	string	The ID of the generation job. Use with Check Status to poll for completion.

`gamma_generate_from_template`

Generate a new Gamma by adapting an existing template with a prompt.

输入

参数	类型	必填	描述
`apiKey`	string	是	Gamma API key
`gammaId`	string	是	The ID of the template gamma to adapt
`prompt`	string	是	Instructions for how to adapt the template (1-100,000 tokens)
`themeId`	string	否	Custom Gamma workspace theme ID to apply
`exportAs`	string	否	Automatically export the generated gamma as pdf or pptx
`folderIds`	string	否	Comma-separated folder IDs to store the generated gamma in
`imageModel`	string	否	AI image generation model to use when imageSource is aiGenerated
`imageStyle`	string	否	Style directive for AI-generated images, e.g. "watercolor", "photorealistic" (max 500 chars)

输出

参数	类型	描述
`generationId`	string	The ID of the generation job. Use with Check Status to poll for completion.

`gamma_check_status`

Check the status of a Gamma generation job. Returns the gamma URL when completed, or error details if failed.

输入

参数	类型	必填	描述
`apiKey`	string	是	Gamma API key
`generationId`	string	是	The generation ID returned by the Generate or Generate from Template tool

输出

参数	类型	描述
`generationId`	string	The generation ID that was checked
`status`	string	Generation status: pending, completed, or failed
`gammaUrl`	string	URL of the generated gamma (only present when status is completed)
`credits`	object	Credit usage information (only present when status is completed)
↳ `deducted`	number	Number of credits deducted for this generation
↳ `remaining`	number	Remaining credits in the account
`error`	object	Error details (only present when status is failed)
↳ `message`	string	Human-readable error message
↳ `statusCode`	number	HTTP status code of the error

`gamma_list_themes`

List available themes in your Gamma workspace. Returns theme IDs, names, and keywords for styling.

输入

参数	类型	必填	描述
`apiKey`	string	是	Gamma API key
`query`	string	否	Search query to filter themes by name (case-insensitive)
`limit`	number	否	Maximum number of themes to return per page (max 50)
`after`	string	否	Pagination cursor from a previous response (nextCursor) to fetch the next page

输出

参数	类型	描述
`themes`	array	List of available themes
↳ `id`	string	Theme ID (use with themeId parameter)
↳ `name`	string	Theme display name
↳ `type`	string	Theme type: standard or custom
↳ `colorKeywords`	array	Color descriptors for this theme
↳ `toneKeywords`	array	Tone descriptors for this theme
`hasMore`	boolean	Whether more results are available on the next page
`nextCursor`	string	Pagination cursor to pass as the after parameter for the next page

`gamma_list_folders`

List available folders in your Gamma workspace. Returns folder IDs and names for organizing generated content.

输入

参数	类型	必填	描述
`apiKey`	string	是	Gamma API key
`query`	string	否	Search query to filter folders by name (case-sensitive)
`limit`	number	否	Maximum number of folders to return per page (max 50)
`after`	string	否	Pagination cursor from a previous response (nextCursor) to fetch the next page

输出

参数	类型	描述
`folders`	array	List of available folders
↳ `id`	string	Folder ID (use with folderIds parameter)
↳ `name`	string	Folder display name
`hasMore`	boolean	Whether more results are available on the next page
`nextCursor`	string	Pagination cursor to pass as the after parameter for the next page

Gamma

On this page