cotera
Logo

Gamma

Authentication Type: API Key
Description: Create beautiful presentations, documents, and social media content using AI. Generate gammas from text with customizable themes, layouts, and images.

Authentication

To authenticate, you'll need a Gamma API key. Learn how to get access in the Gamma Developer documentation.

Generations

Create and manage Gamma generations (presentations, documents, social media content).

Create Generation

Generate a new Gamma presentation, document, or social media content from text. Supports extensive customization including themes, text mode, images, and sharing settings. Returns a generation ID that can be used to check status.

Operation Type: Mutation (Write)

Parameters:

  • inputText string (required): Text used to generate your gamma. Can be as little as a few words or up to 750,000 characters. Use \n---\n to control where cards are split
  • textMode string (nullable): How to modify inputText: "generate" (rewrite and expand), "condense" (summarize), or "preserve" (retain exact text). Defaults to "generate"
  • format string (nullable): Type of artifact to create: "presentation", "document", or "social". Defaults to "presentation"
  • themeName string (nullable): Theme from Gamma to use for the output. Standard or custom theme name. If not specified, uses workspace default
  • numCards number (nullable): Number of cards to create when cardSplit is "auto". Pro users: 1-60, Ultra users: 1-75. Defaults to 10
  • cardSplit string (nullable): How to divide content: "auto" (uses numCards) or "inputTextBreaks" (uses \n---\n breaks). Defaults to "auto"
  • additionalInstructions string (nullable): Additional specifications for the output (max 500 chars). Example: "Make the card headings humorous and catchy"
  • exportAs string (nullable): Export format: "pdf" or "pptx". If specified, returns download links in addition to Gamma URL
  • textAmount string (nullable): Amount of text per card: "brief", "medium", "detailed", or "extensive". Only relevant if textMode is "generate" or "condense". Defaults to "medium"
  • textTone string (nullable): Mood or voice of the output (max 500 chars). Example: "professional, upbeat, inspiring". Only relevant if textMode is "generate"
  • textAudience string (nullable): Intended viewers/readers (max 500 chars). Example: "outdoors enthusiasts, adventure seekers". Only relevant if textMode is "generate"
  • textLanguage string (nullable): Language code for generation (e.g., "en", "es", "fr"). Defaults to "en"
  • imageSource string (nullable): Image source: "aiGenerated", "pictographic", "unsplash", "giphy", "webAllImages", "webFreeToUse", "webFreeToUseCommercially", "placeholder", or "noImages". Defaults to "aiGenerated"
  • imageModel string (nullable): AI model for image generation (e.g., "imagen-4-pro", "flux-1-pro"). Only used if imageSource is "aiGenerated"
  • imageStyle string (nullable): Visual style for AI-generated images (max 500 chars). Example: "minimal, black and white, line art". Only used if imageSource is "aiGenerated"
  • cardDimensions string (nullable): Aspect ratio of cards. For presentation: "fluid", "16x9", "4x3". For document: "fluid", "pageless", "letter", "a4". For social: "1x1", "4x5", "9x16"
  • workspaceAccess string (nullable): Access level for workspace members: "noAccess", "view", "comment", "edit", or "fullAccess". Defaults to workspace share settings
  • externalAccess string (nullable): Access level for external users: "noAccess", "view", "comment", or "edit". Defaults to workspace share settings

Returns:

  • id string: Unique identifier for the generation
  • status string: Current status: "pending", "completed", or "failed"
  • gammaUrl string (nullable): URL to view the gamma (available when completed)
  • pdfUrl string (nullable): Download link for PDF export (if exportAs was "pdf", available when completed)
  • pptxUrl string (nullable): Download link for PPTX export (if exportAs was "pptx", available when completed)
  • error string (nullable): Error message if status is "failed"

Example Usage:

{
  "inputText": "Introduction to Machine Learning\n---\nWhat is Machine Learning?\nMachine learning is a subset of artificial intelligence that enables computers to learn and make decisions from data without being explicitly programmed.\n---\nTypes of Machine Learning\nSupervised Learning: Learning with labeled examples\nUnsupervised Learning: Finding patterns in unlabeled data\nReinforcement Learning: Learning through trial and error\n---\nApplications\nImage recognition, natural language processing, recommendation systems, autonomous vehicles, and predictive analytics.",
  "textMode": "generate",
  "format": "presentation",
  "themeName": "Modern",
  "numCards": 8,
  "cardSplit": "inputTextBreaks",
  "additionalInstructions": "Use engaging visuals and keep text concise for better readability",
  "exportAs": "pdf",
  "textAmount": "medium",
  "textTone": "professional, educational, engaging",
  "textAudience": "students and professionals new to machine learning",
  "textLanguage": "en",
  "imageSource": "aiGenerated",
  "imageModel": "imagen-4-pro",
  "imageStyle": "clean, modern, tech-focused illustrations",
  "cardDimensions": "16x9",
  "workspaceAccess": "view",
  "externalAccess": "view"
}

Get Generation Status

Check the status of a Gamma generation. Returns current status (pending, completed, or failed) and URLs for viewing or downloading the gamma when completed.

Operation Type: Query (Read)

Parameters:

  • generationId string (required): The ID of the generation to check (returned from createGeneration)

Returns:

  • id string: Unique identifier for the generation
  • status string: Current status: "pending", "completed", or "failed"
  • gammaUrl string (nullable): URL to view the gamma (available when completed)
  • pdfUrl string (nullable): Download link for PDF export (if requested, available when completed)
  • pptxUrl string (nullable): Download link for PPTX export (if requested, available when completed)
  • error string (nullable): Error message if status is "failed"

Example Usage:

{
  "generationId": "gen_abc123def456"
}

Common Use Cases

Content Creation:

  • Generate professional presentations from meeting notes or research
  • Create marketing materials and social media content from product descriptions
  • Transform long-form content into digestible presentation formats
  • Build educational materials and training presentations

Document Processing:

  • Convert text documents into visually appealing presentations
  • Create executive summaries and reports with custom themes
  • Generate social media carousels from blog posts or articles
  • Transform technical documentation into user-friendly formats

Workflow Automation:

  • Automatically generate presentations from CRM data or reports
  • Create branded content using custom themes and styling
  • Export presentations in multiple formats (PDF, PPTX) for distribution
  • Set up sharing permissions for team collaboration

Multi-language Support:

  • Generate content in different languages for global audiences
  • Create localized presentations for international teams
  • Adapt content tone and style for different cultural contexts
  • Maintain consistent branding across multilingual content