Zum Hauptinhalt springen

Gamma API Fehlerbehebung

Supportumfang, häufige Fehlercodes und die Schritte zur Fehlerbehebung.

Gamma API Fehlerbehebungsanleitung

Obwohl wir gerne bei allen API-Angelegenheiten helfen würden, beachten Sie bitte, dass unser Support-Team keine Workflows erstellt, Ihren Backend-Code (FastAPI, Express, Django usw.) debuggt oder plattformspezifische Eigenheiten behebt.

Wir können bei Gamma-spezifischen Fragen zu unseren Endpunkten und Parametern, API-Authentifizierung, Fehlerbehebung, Credits und der Überprüfung, ob Ihre Anfrage unserer Dokumentation entspricht, helfen.

Für plattformspezifische Hilfe kontaktieren Sie bitte Zapier Support, Make Support oder N8N Support.

Für weitere Informationen zur Gamma-API siehe: developers.gamma.app


Häufige Fehlercodes

400 Bad Request

Ungültige Parameter

Überprüfen Sie Ihre Anfrage auf:

  • Fehlende Pflichtfelder (inputText, textMode).

  • Ungültige Parameterwerte.

  • Zeichen- oder Token-Limits überschritten.

  • Für from-template: Die Vorlage muss ein einseitiger Workspace Gamma sein. Offizielle Explore-Vorlagen und mehrseitige Gammas werden abgelehnt.

Überprüfen Sie die Fehlermeldung für spezifische Validierungsdetails.


401 Unauthorized

Ungültiger API-Schlüssel

Ihr API-Schlüssel ist ungültig oder nicht mit einem Pro-Konto verknüpft.

  1. Vergewissern Sie sich, dass Sie den Header X-API-KEY (nicht Authorization) verwenden.

  2. Generieren Sie einen neuen API-Schlüssel unter gamma.app/settings/api-keys.

  3. Bestätigen Sie, dass Ihr Konto einen aktiven Pro-, Ultra-, Teams- oder Business-Plan hat.


403 Forbidden

Keine Credits verfügbar

Ihr Konto hat keine API-Credits mehr.

Beheben Sie dies unter gamma.app/settings/billing:

  • Aktivieren Sie die automatische Aufladung (empfohlen).

  • Kaufen Sie Credits bei Bedarf.

  • Upgrade auf einen höheren Tarifplan.


404 Not Found

Ungültige Generation- oder Gamma-ID

Die Generation-ID existiert nicht oder gehört einem anderen Benutzer. Dieser Fehler wird auch für eine Gamma-ID zurückgegeben, auf die Sie beim Lesen, Bearbeiten oder Exportieren eines bestehenden Gammas keinen Zugriff haben.

Überprüfen Sie, ob Sie die korrekte generationId aus der POST-Antwort verwenden oder ob Sie Zugriff auf das Ziel-Gamma haben.


422 Failed

Generierung konnte nicht abgeschlossen werden

Die Generierung lieferte eine leere Ausgabe.

Überprüfen Sie Ihre Anfrage:

  • Stellen Sie sicher, dass inputText ausreichend Inhalt hat.

  • Überprüfen Sie, ob die Parameter mit Ihrer Eingabe übereinstimmen.

  • Vereinfachen Sie bei Bedarf komplexe Anweisungen.


429 Too Many Requests

Ratenlimit überschritten

Sie haben das Ratenlimit erreicht. Limits sind pro API-Schlüsselbesitzer und pro Workspace festgelegt, die aktuellen Werte sind in der Fehlercode-Referenz dokumentiert.

🔷 Hinweis: Die API hat eine großzügige Kapazität. Die meisten Nutzer stoßen im normalen Gebrauch nie auf dieses Limit.

Lösungen:

  1. Kontaktieren Sie Gamma Support für höhere Kapazitäten.

  2. Implementieren Sie exponentielles Backoff.

  3. Verteilen Sie Anfragen über die Zeit.


500 Internal Server Error

Unerwarteter Serverfehler

Ein temporäres Serverproblem ist aufgetreten.

  1. Warten Sie einen Moment und versuchen Sie es erneut.

  2. Wenn das Problem weiterhin besteht, kontaktieren Sie den Support mit Ihrer x-request-id.


502 Bad Gateway

Temporäres Gateway-Problem

Ein temporäres Verbindungsproblem ist aufgetreten.

Warten Sie einen Moment und wiederholen Sie Ihre Anfrage.


Meine API-generierte Präsentation erscheint nicht in meiner Gammas-Liste

API-generierte Präsentationen erscheinen im Abschnitt API Generated des Gamma-Dashboards, nicht in Ihrer Haupt-Gammas-Liste (Alle, Kürzlich angesehen oder Von Ihnen erstellt). Dies ist erwartetes Verhalten, und das Umbenennen der Präsentation ändert nicht die Kategorisierung.

Workaround: Öffnen Sie die Präsentation und wählen Sie Duplizieren. Das Duplikat wird als reguläres, webbasiertes Gamma behandelt und erscheint in Ihrer Haupt-Gammas-Liste.

Benötigen Sie noch Hilfe?

Hat dies deine Frage beantwortet?