gamma_generate
Convert text into presentations, documents, webpages, or social posts. Submit your input, then poll for the finished share URL.
Instructions
Generate a Gamma presentation, document, webpage, or social post from text.
Generation is asynchronous. Returns a generationId; poll gamma_get_status until status is 'completed' or 'failed' to retrieve the share URL.
Args: input_text: Topic, outline, or full content (1-400000 chars). text_mode: How to interpret input — 'generate' (expand), 'condense', or 'preserve' (keep as-is). Default 'generate'. format: Output type — 'presentation', 'document', 'social', or 'webpage'. Omit to use Gamma's default. theme_id: Theme ID from gamma_list_themes. Omit for default theme. num_cards: Target card count (minimum 1, plan-dependent maximum). 0 = let Gamma decide. card_split: 'auto' or 'inputTextBreaks' (splits on blank lines in input). additional_instructions: Extra style/content guidance (max 5000 chars). export_as: Auto-export format — 'pdf', 'pptx', or 'png'. Empty for no export. folder_ids: Workspace folder IDs to place the output in (max 10). Use gamma_list_folders to discover IDs. text_options: Nested object with 'amount' (brief|medium|detailed|extensive), 'tone' (string, max 500 chars), 'audience' (string, max 500 chars), 'language' (ISO code, e.g. 'en', 'es', 'fr'). image_options: Nested object with 'source' (aiGenerated, pictographic, unsplash, webAllImages, webFreeToUse, webFreeToUseCommercially, giphy, pexels, placeholder, noImages, themeAccent), 'model' (e.g. 'dall-e-3', 'imagen-4-ultra', 'flux-2-pro'), 'style' (string, max 500 chars). card_options: Nested object with 'dimensions' (fluid, 16x9, 4x3, pageless, letter, a4, 1x1, 4x5, 9x16 — must match format) and 'headerFooter' (6-position layout with logos, card numbers, or text). sharing_options: Nested object with 'workspaceAccess' (noAccess, view, comment, edit, fullAccess), 'externalAccess' (noAccess, view, comment, edit), and 'emailOptions' ({recipients: [...], access: ...}).
Call gamma_describe_options to inspect accepted enum values.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| input_text | Yes | ||
| text_mode | No | generate | |
| format | No | ||
| theme_id | No | ||
| num_cards | No | ||
| card_split | No | ||
| additional_instructions | No | ||
| export_as | No | ||
| folder_ids | No | ||
| text_options | No | ||
| image_options | No | ||
| card_options | No | ||
| sharing_options | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |