Was ist die Gamma API?
Haben Sie ein Deck, das Sie lieben? Was wäre, wenn Sie 100 weitere genau wie dieses erstellen könnten, personalisiert für verschiedene Zielgruppen weltweit?
Die Gamma Generate API ermöglicht es Ihnen, Präsentationen, Dokumente, Webseiten und Social Posts programmatisch zu erstellen, ohne die Gamma-App direkt zu verwenden. Ideal für Nutzer, die ihre Workflows mit Tools wie Zapier, Make oder n8n automatisieren, schöne Präsentationen in eigene Anwendungen integrieren oder Präsentationen in großem Umfang über Backend-Code generieren möchten.
Und wenn Sie Entwickler sind, können Sie Gamma in Ihre Anwendung integrieren, um ihr Design-Superkräfte zu verleihen!
💎 Pro Tipp: Jeder mit einem Pro-Konto oder höher kann die API heute mit großzügigen Nutzungslimits verwenden.
Ist die API bereit?
Die Gamma API v1.0 ist seit dem 5. November 2025 allgemein verfügbar (GA). Jeder mit einem Pro-Konto oder höher kann die API heute mit großzügigen Nutzungslimits verwenden.
Für detaillierte Informationen zu spezifischen API-Parametern und deren Einfluss auf die Präsentationserstellung lesen Sie bitte unsere API-Dokumentation.
Wie erhalte ich Zugriff?
Um auf die Gamma API zuzugreifen, folgen Sie diesen Schritten.
Schritt 1: Upgrade Ihres Kontos
Sie müssen ein Gamma Pro-, Ultra-, Team- oder Business-Konto haben. Wenn Sie derzeit kein Pro-Nutzer oder höher sind, upgraden Sie auf Pro, um Zugriff auf die API zu erhalten.
Schritt 2: Generieren eines API-Schlüssels
Navigieren Sie in Ihrem Pro-Konto zu Einstellungen und Mitglieder, dann zum Tab API key. Klicken Sie auf Create API key, um Ihren Schlüssel zu generieren, und kopieren Sie ihn sicher.
🔷 Hinweis: API-Schlüssel haben das Format sk-gamma-xxxxxxxx und sollten mit dem Header X-API-KEY übergeben werden (nicht im Bearer-Token-Format).
💎 Pro Tipp: Beginnen Sie mit der API-Nutzung über Ihre bevorzugten Automatisierungstools oder integrieren Sie sie direkt in Ihren Backend-Code. Die Basis-URL ist https://public-api.gamma.app/v1.0/
Kann ich mich mit OAuth statt mit einem API-Schlüssel authentifizieren?
Sie können sich bei der Gamma REST API mit OAuth 2.0 anstelle eines statischen API-Schlüssels authentifizieren. OAuth ermöglicht es, die Gamma API mit einer Anwendung zu verbinden, ohne einen langzeitgültigen API-Schlüssel zu erstellen oder zu speichern, was für Integrationen und Partner-Apps nützlich ist. Statische API-Schlüssel werden weiterhin vollständig unterstützt, sodass Sie den X-API-KEY-Header weiterhin verwenden können, wenn Sie möchten. Um OAuth einzurichten, folgen Sie dem Authenticate with OAuth-Leitfaden in der Entwicklerdokumentation unter developers.gamma.app/get-started/authenticate-with-oauth.
Nutzung und Ratenbegrenzungen
Aktuelle API-Limits
Die Gamma API ist darauf ausgelegt, mit Ihren Anforderungen zu skalieren. Ob Sie wenige oder hunderte Präsentationen generieren, Sie sollten basierend auf Ihrem Nutzungsbedarf ohne Probleme während der normalen Nutzung erstellen können.
🌀 Hinweis: Wenn Sie auf Ratenbegrenzungen (HTTP 429 Fehler) stoßen, wenden Sie sich an unser Support-Team. Wir arbeiten mit Ihnen zusammen, damit die API Ihre Anforderungen unterstützt!
Was kann die API?
Die Gamma API deckt den gesamten Lebenszyklus eines Gamma ab, von der Erstellung bis zum Export.
Inhalte generieren: Erstellen Sie Präsentationen, Dokumente, Webseiten und Social Posts aus Ihrem eigenen Text.
Aus Vorlage erstellen: Generieren Sie neue Gammas aus einer Vorlage, die Sie in Gamma erstellt haben, und behalten Sie deren Layout und Kartenstruktur bei.
Bestehende Gammas bearbeiten: POST /v1.0/agent/gammas/{gammaId}/edits wendet eine Änderung in natürlicher Sprache auf eine Seite an.
Agent-Generierung: POST /v1.0/agent/generations startet eine Generierung aus einer Arbeitsbereichsvorlage, einem bestehenden Gamma oder einer offiziellen Gamma-Vorlage.
Bestehende Gammas lesen, exportieren und analysieren: Endpunkte für Abruf, Kommentare, Export und Analysen.
Standalone-Bilderzeugung: Erzeugen Sie einzelne Bilder separat von einem vollständigen Gamma.
Webseitenformat: Erstellen Sie neben Präsentationen, Dokumenten und Social Posts auch Webseiten.
Kopf- und Fußzeilenanpassung: Passen Sie die Kopf- und Fußzeilen Ihres Inhalts an.
Bild-URLs im Input: Verweisen Sie direkt auf Bilder in Ihrem Inhalt.
Ordnerorganisation: Organisieren Sie generierte Inhalte in Ordnern.
E-Mail-Teilen: Teilen Sie Inhalte programmatisch per E-Mail.
Listen-APIs: Endpunkte zum Auflisten Ihrer Designs und Ordner.
Gammas durchsuchen: Durchsuchen Sie die Titel und den gesamten Text der Gammas, auf die Sie Zugriff haben, und filtern Sie Ergebnisse vor dem Öffnen.
Großzügige Eingabelimits: Bis zu 100.000 Tokens (ca. 400.000 Zeichen).
Kann ich mit der API eigenständige Bilder generieren?
Sie können eigenständige Bilder mit der Gamma API und über das Model Context Protocol (MCP) generieren. So erstellen Sie einzelne Bilder programmatisch, getrennt von der Generierung einer vollständigen Präsentation, eines Dokuments oder einer Webseite. Folgen Sie dem Create image generation-Leitfaden in der Entwicklerdokumentation, um Bilder über die API oder MCP zu generieren. Die Bildgenerierung über MCP ist in Claude, ChatGPT und anderen MCP-Clients verfügbar.
Kann ich meine Gammas mit der API oder MCP durchsuchen?
Sie können Ihre gesamte Bibliothek von Gammas über die Gamma API oder einen KI-Assistenten, der mit Gamma über das Model Context Protocol (MCP) verbunden ist, durchsuchen. Die Suche umfasst sowohl Titel als auch den gesamten Text jedes zugänglichen Gammas und sortiert die Ergebnisse nach Relevanz, sodass die beste Übereinstimmung zuerst erscheint. Jedes Ergebnis enthält einen direkten Link, mit dem Sie das Gamma direkt aus der Antwort öffnen können.
Sie können Ihre Suche nach dem Ersteller des Gammas und dem Datum der letzten Aktualisierung eingrenzen. Archivierte Gammas sind standardmäßig ausgeschlossen, können aber einbezogen werden.
Für die vollständige Liste der Suchparameter und Beispielanfragen folgen Sie dem Search gammas-Leitfaden in der Entwicklerdokumentation unter developers.gamma.app/management/search-gammas.
Wofür kann ich die API verwenden?
Nutzen Sie die Gamma API für Automatisierungsplattformen wie Make, Zapier, Workato und andere Workflow-Tools. Sie können auch eigene Anwendungen mit direkter Integration in Backend-Code erstellen, um Ihre eigenen Apps zu betreiben, Präsentationen in großer Menge programmatisch zu generieren oder personalisierte Inhalte in großem Umfang zu erstellen.
🔷 Hinweis: Ihr inputText sollte den tatsächlichen Inhalt enthalten, den Sie auf Ihren Folien haben möchten, nicht Anweisungen zur Erstellung der Präsentation. Designs müssen in Gamma vorab erstellt und per ID referenziert werden. Sie können nicht über inputText erstellt werden.
Vorlagenunterstützung
Da "templates" für verschiedene Benutzer unterschiedliche Bedeutungen hat, hier eine Übersicht der verfügbaren Optionen.
Visuelle Designs: Sie können das Aussehen und Gefühl Ihrer Präsentationen definieren, indem Sie benutzerdefinierte Designs in Gamma erstellen und diese dann in der API mit ihrer Design-ID referenzieren. Verwenden Sie die List Themes API (GET /v1.0/themes), um verfügbare Design-IDs zu erhalten.
Vorlagen für Inhaltsstruktur: Verwenden Sie Create from template. Erstellen Sie eine Vorlage in Gamma und rufen Sie dann POST /v1.0/generations/from-template mit deren ID und einem Prompt auf. Das Layout und die Kartenstruktur der Vorlage bleiben standardmäßig erhalten, und Ihr Prompt ändert den Inhalt, das Publikum oder die Sprache. Templates müssen einseitige Gammas aus Ihrem Workspace sein (eine Seite kann viele Karten enthalten). Finden Sie Vorlagen-IDs mit GET /v1.0/templates/search.
Agent-Generierung: POST /v1.0/agent/generations kann auch von einer Workspace-Vorlage, einem bestehenden Gamma oder einer offiziellen Gamma-Vorlage (templateId) starten.
Hilfe und Support erhalten
Dokumentation und Ressourcen
Für vollständige technische Referenzen besuchen Sie die Entwicklerdokumentation unter developers.gamma.app. API-Zugang ist in den Abonnements Pro, Ultra, Teams und Business enthalten.
Fehlerbehebungshilfe
Wenn Sie Hilfe bei API-Problemen benötigen, prüfen Sie unsere Fehlerdokumentation für häufige Probleme und Lösungen und wenden Sie sich dann an den Kundensupport. Fügen Sie bei der Anfrage immer die x-request-id aus Ihrer API-Antwort bei.
Jede API-Antwort enthält diese eindeutige Kennung in den Headern. Für **Make.com-Benutzer finden Sie sie unter Output → Bundle → Headers. Für Zapier prüfen Sie den Bereich Run Details → Data Out in der Task-Historie für erfolgreiche Läufe oder den Tab Logs → Response information (Header erweitern) für fehlgeschlagene Anfragen.
💎 Profi-Tipp: Fügen Sie bei Supportanfragen immer Ihre Request-ID, die genaue Fehlermeldung und ein Beispiel Ihres Request-Bodys bei.
Supportumfang
Wobei wir helfen können
Wir können bei Gamma-spezifischen API-Problemen, Authentifizierungs- und API-Schlüssel-Problemen, dem Verständnis von Fehlermeldungen, Fragen zu Rate Limits und zur Kreditnutzung helfen.
Wobei wir nicht helfen können
Wir können keinen benutzerdefinierten Code debuggen oder schreiben, keine kompletten Workflows in Zapier, Make oder N8N erstellen, keine benutzerdefinierten Anwendungen debuggen, keine Anleitungen zur Nutzung von Zapier, Make oder N8N geben oder keine individuelle Architektur entwerfen.
Bitte geben Sie bei API-Hilfeanfragen Ihre Request-ID, Fehlermeldung, Beispiel des Request-Bodys und die von Ihnen genutzte Automatisierungsplattform an.
Häufige Fehlercodes
401 Unauthorized: Ungültiger API-Schlüssel. Stellen Sie sicher, dass Sie den X-API-KEY-Header verwenden (nicht Authorization oder Bearer).
403 Forbidden: Überprüfen Sie Ihr Guthaben und stellen Sie sicher, dass die automatische Aufladung aktiviert ist.
429 Too Many Requests: Sie haben das Rate Limit erreicht. Kontaktieren Sie den Slack-Support für Optionen mit höherer Kapazität.
422 Failed: Die Generierung konnte nicht abgeschlossen werden. Überprüfen Sie Ihre Eingabeparameter.
Brauchen Sie Hilfe beim Einstieg?
Für grundlegende Fehlerbehebung und häufige API-Probleme sehen Sie sich unseren umfassenden Troubleshooting-Guide an. Sie können auch unsere vollständige Entwicklerdokumentation für detaillierte API-Referenzen und Beispiele durchsehen.
FAQs & Häufige Probleme
Kann ich ein bestehendes Gamma mit der API bearbeiten?
Ja.
POST /v1.0/agent/gammas/{gammaId}/editswendet eine natürlichsprachliche Anweisung auf eine Seite eines editierbaren Gammas an, z. B. "aktualisiere die Preiskarte mit den neuen Stufen."Abfragen Sie
GET /v1.0/agent/edits/{editId}nach dem Ergebnis.Bearbeitungen können keine Seiten hinzufügen, und es läuft immer nur eine Bearbeitung pro Seite gleichzeitig.
Die gleiche Funktionalität ist in Claude, ChatGPT, Slack und anderen MCP-Clients verfügbar.
Kann mein eigener KI-Agent Gamma verwenden?
Ja. Verbinden Sie jeden MCP-Client mit
https://mcp.gamma.app/mcpund melden Sie sich mit Ihrem Gamma-Konto an. Es funktioniert in jedem Plan.Benutzerdefinierte Clients müssen zuerst ihre OAuth-Redirect-URIs registrieren.
Kann ich meine API-Schlüssel mit anderen teilen?
API-Schlüssel sollten sicher aufbewahrt und nicht geteilt werden.
Generieren Sie bei Bedarf separate Schlüssel für verschiedene Anwendungsfälle.
Warum kann ich meinen API-Schlüssel nicht erneut kopieren?
Aus Sicherheitsgründen werden API-Schlüssel nur einmal bei der Generierung angezeigt.
Wenn Sie Ihren Schlüssel verlieren, müssen Sie einen neuen generieren.
Kann ich mehrere API-Schlüssel generieren?
Ja, Sie können über Ihre Kontoeinstellungen mehrere API-Schlüssel für verschiedene Projekte oder Anwendungsfälle erstellen.
Welche Gammas erscheinen in API- oder MCP-Suchergebnissen?
Die Suche gibt nur Gammas zurück, auf die Sie bereits Zugriff haben, sodass niemals Inhalte angezeigt werden, die Sie in Gamma nicht öffnen können.
Die Ergebnisse werden nach Relevanz sortiert, wobei die beste Übereinstimmung zuerst angezeigt wird.
Archivierte Gammas werden ausgeschlossen, es sei denn, Sie wählen deren Einbeziehung.
Sie können auch nach Ersteller und dem Zeitpunkt der letzten Aktualisierung einer Gamma filtern.
Warum funktioniert die Suche in meinem Workspace nicht?
Die Suche über Ihre Gammas wird schrittweise eingeführt und ist noch nicht für jeden Workspace aktiviert.
Wenn sie nicht verfügbar ist, kontaktieren Sie den Customer Support und fügen Sie Ihre
x-request-idbei, damit wir Ihren Workspace überprüfen können.Editor: Löschen Sie dieses FAQ, wenn die Suche zu 100 % bestätigt ist.
Was passiert, wenn meine Credits aufgebraucht sind?
Aktivieren Sie die automatische Aufladung in Ihren billing Einstellungen unter gamma.app/settings/billing, um einen unterbrechungsfreien API-Zugang zu gewährleisten.
Wo erscheinen API-generierte Präsentationen im Gamma-Dashboard?
Präsentationen, die über die API erstellt wurden, erscheinen im Abschnitt API Generated des Gamma-Dashboards, nicht in Ihrer Hauptliste der Gammas (Alle, Kürzlich angesehen oder Von Ihnen erstellt).
Um eine API-generierte Präsentation in Ihrer regulären Gammas-Liste anzuzeigen, öffnen Sie sie und wählen Sie Duplicate. Das Duplikat wird wie eine standardmäßig web-erstellte Gamma behandelt und erscheint in allen üblichen Ansichten.