So aktualisieren Sie Ihren n8n-Workflow für Gamma API v1.0

Kritisches Update: Gamma API v0.2 wird eingestellt

Wenn Sie Gammas API mit n8n verwenden, um automatisch Präsentationen zu generieren, müssen Sie Ihre Workflows vor dem 31. Januar 2026 aktualisieren. Gamma stellt die v0.2 API-Endpoints ein, und alle Workflows, die noch die alte Version verwenden, werden nach diesem Datum nicht mehr funktionieren.

Die gute Nachricht? Die Migration ist unkompliziert und dauert nur wenige Minuten. Diese Anleitung führt Sie durch die notwendigen Änderungen.

Was sich in Gamma API v1.0 ändert

Die wichtigste Änderung in der v1.0 API betrifft die Angabe von Themes. Anstelle von menschenlesbaren Theme-Namen erfordert die neue API Theme-IDs.

Alte Methode (v0.2):

“themeName”: “Oasis”

Neue Methode (v1.0):

“themeId”: “theme_abc123xyz”

Diese Änderung verbessert die API-Stabilität und ermöglicht eine präzisere Theme-Auswahl, erfordert aber ein einmaliges Update Ihrer Workflows.

Schritt-für-Schritt-Migration für n8n-Nutzer

Schritt 1: Öffnen Sie Ihren n8n-Workflow

Navigieren Sie zu Ihrer n8n-Instanz und öffnen Sie den Workflow, der die Gamma API verwendet. Suchen Sie den HTTP Request-Node, der den API-Aufruf an Gamma macht.

Schritt 2: Aktualisieren Sie die API-URL

Ändern Sie in Ihrem HTTP Request-Node die URL von:

https://public-api.gamma.app/v0.2/generations

Zu:

https://public-api.gamma.app/v1.0/generations

Schritt 3: Holen Sie sich Ihre Theme-ID von Gamma

Das ist der entscheidende Schritt. So finden Sie Ihre Theme-ID:

1. Melden Sie sich bei Ihrem Gamma-Konto unter gamma.app an
2. Klicken Sie auf das Paletten-Symbol in der Navigationsleiste, um die Design Library zu öffnen
3. Finden Sie das Theme, das Sie für Ihre Präsentationen verwenden möchten
4. Klicken Sie auf die drei Punkte (⋯) neben dem Theme-Namen
5. Wählen Sie „Copy theme ID for API” aus dem Menü

Ihre Theme-ID wird in die Zwischenablage kopiert. Sie sieht etwa so aus: theme_12345abcde

Schritt 4: Aktualisieren Sie Ihren JSON-Payload

Finden Sie in Ihrem n8n HTTP Request-Node den JSON-Body-Bereich. Ersetzen Sie den Parameter themeName durch themeId:

Vorher:

{ “inputText”: “Your presentation topic”, “format”: “presentation”, “themeName”: “Oasis”, “numCards”: 10 }

Nachher:

{ “inputText”: “Your presentation topic”, “format”: “presentation”, “themeId”: “theme_12345abcde”, “numCards”: 10 }

Schritt 5: Speichern und testen

Speichern Sie Ihren aktualisierten Workflow. Wenn Sie n8n v2.0+ verwenden, veröffentlichen Sie die neue Version. Bei v1.x aktivieren Sie den Workflow.

Führen Sie eine Testausführung durch, um zu überprüfen, dass alles mit der neuen API-Version korrekt funktioniert.

Alternative: Gammas Standard-Theme verwenden

Wenn Sie kein bestimmtes benutzerdefiniertes Theme benötigen, können Sie die Migration vereinfachen, indem Sie den Theme-Parameter ganz entfernen. Die v1.0 API verwendet dann automatisch Gammas Standard-Theme:

{ “inputText”: “Your presentation topic”, “format”: “presentation”, “numCards”: 10 }

Was, wenn ich mehrere Workflows habe?

Wenn Sie mehrere n8n-Workflows mit der Gamma API haben, müssen Sie jeden einzeln aktualisieren. Der Prozess ist jedoch für jeden Workflow identisch:

1. Aktualisieren Sie die API-URL auf v1.0
2. Ersetzen Sie themeName durch themeId
3. Verwenden Sie dieselbe Theme-ID in allen Workflows (oder holen Sie sich verschiedene Theme-IDs für unterschiedliche Themes)

Dokumentieren Sie Ihre Theme-IDs an einem zentralen Ort, damit Sie sie beim Erstellen neuer Workflows leicht nachschlagen können.

Zusätzliche Ressourcen

• Offizielle Gamma API-Dokumentation
• Gamma API Help Center

Brauchen Sie Hilfe?

Wenn Sie während der Migration auf Probleme stoßen, überprüfen Sie Folgendes:

• Ihr API-Key hat sich nicht geändert (er sollte gleich bleiben)
• Sie haben die vollständige Theme-ID von Gamma kopiert
• Sie verwenden die korrekte v1.0-Endpoint-URL
• Ihre JSON-Syntax ist gültig (achten Sie auf fehlende Kommas oder Anführungszeichen)

Die Frist am 31. Januar 2026 rückt schnell näher, also stellen Sie sicher, dass Sie Ihre Workflows bald aktualisieren. Die Migration ist unkompliziert, und sobald sie abgeschlossen ist, funktioniert Ihre automatisierte Präsentationserstellung nahtlos mit der verbesserten v1.0 API weiter.