# Gamma

> Create beautiful presentations, documents, and social media content using AI. Generate gammas from text with customizable themes, layouts, and images.

Source: https://cotera.co/docs/reference/tools/individual-tools/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](https://developers.gamma.app/docs/get-access).

***

## 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:**

```json
{
  "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:**

```json
{
  "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