概述

Gamma.app — Presentations & Documents API

Create presentations, documents, social posts, and web pages programmatically via the Gamma API.

Homepage: https://gamma.app

API Docs: https://developers.gamma.app/docs/getting-started

Runtime dependencies: curl, python3 (for JSON building/parsing)

Setup

Set the environment variable before using:

export GAMMA_API_KEY="sk-gamma-xxxxx"  # Get from https://gamma.app/settings

The script only makes network calls to https://public-api.gamma.app/v1.0. Your API key and inputText content are sent to Gamma's servers.

Quick Start

Generate a presentation

bash scripts/gamma.sh generate "AI trends in 2026 for business leaders" \
  --format presentation --num-cards 10 --export pdf --wait

Generate a document

bash scripts/gamma.sh generate "Quarterly marketing report Q1 2026" \
  --format document --text-mode generate --amount detailed \
  --tone "professional" --audience "executive team" --export pdf --wait

Create from template

bash scripts/gamma.sh template "g_abcdef123" "Update this pitch deck for Twist Broadband client" \
  --export pdf --wait

Check status manually

bash scripts/gamma.sh status "generationId123"

List themes and folders

bash scripts/gamma.sh themes
bash scripts/gamma.sh themes "dark"
bash scripts/gamma.sh folders

Script Reference

scripts/gamma.sh [args] [options]

Commands

Command	Args	Description
---------	------	-------------
`generate`	`"inputText"`	Create from scratch
`template`	`"gammaId" "prompt"`	Create from existing template
`status`	`"generationId"`	Check generation status
`themes`	`[query]`	List available themes
`folders`	`[query]`	List workspace folders

Generate Options

Option	Values	Default
--------	--------	---------
`--format`	presentation, document, social, webpage	presentation
`--text-mode`	generate, condense, preserve	generate
`--num-cards`	1-60 (Pro) / 1-75 (Ultra)	10
`--card-split`	auto, inputTextBreaks	auto
`--theme`	theme ID from `themes` command	(Gamma picks)
`--export`	pdf, pptx	(none)
`--tone`	free text	(none)
`--audience`	free text	(none)
`--language`	ISO code (en, es, fr...)	(auto)
`--amount`	brief, medium, detailed, extensive	(auto)
`--image-source`	aiGenerated, pexels, noImages, etc.	(auto)
`--image-model`	flux-1-pro, imagen-4-pro, etc.	(auto)
`--image-style`	free text ("photorealistic")	(none)
`--instructions`	additional guidance (max 2000 chars)	(none)
`--dimensions`	fluid, 16x9, 4x3, 1x1, 4x5, 9x16, a4, letter	fluid
`--workspace-access`	noAccess, view, comment, edit, fullAccess	(default)
`--external-access`	noAccess, view, comment, edit	(default)
`--folder`	folder ID (comma-separated for multiple)	(none)
`--wait`	(flag) Poll until generation completes	false
`--poll-interval`	seconds between polls	5

Workflow

Generate — POST creates the gamma, returns a generationId
Poll — Use --wait or manually check status until completed
Result — Completed response includes gammaUrl (live link) and export download URL if requested
Credits — Response shows credits.deducted and credits.remaining

Input Tips

Short prompts work ("AI trends 2026") but detailed structured text produces better results
Insert image URLs directly in inputText where you want them placed
Use \n---\n in inputText to force card breaks (set --card-split inputTextBreaks)
To use only your images (no AI-generated ones), set --image-source noImages
JSON-escape special characters in inputText

Credit Costs

Cards: 1-5 credits each
AI images: 2 credits (basic) to 125 credits (ultra) per image
Example: 10-card deck with basic AI images ≈ 20-60 credits

Full API Reference

For complete parameter details, header/footer configuration, and sharing options, read references/api-reference.md.

版本历史

共 1 个版本

v1.0.1 当前

2026-05-01 19:42 安全安全

安全检测

腾讯云安全 (Keen)

安全，无风险

查看报告

腾讯云安全 (Sanbu)