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.

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