Guide de dépannage de l'API Gamma
Bien que nous aimerions aider sur tout ce qui concerne l'API, gardez à l'esprit que notre équipe de support ne peut pas créer de workflows, déboguer votre code backend (FastAPI, Express, Django, etc.) ni résoudre les particularités spécifiques à une plateforme.
Nous pouvons aider pour les questions spécifiques à Gamma concernant nos endpoints et paramètres, l'authentification API, le dépannage des erreurs, les crédits, et la vérification que votre requête correspond à notre documentation.
Pour une aide spécifique à une plateforme, contactez Zapier Support, Make Support ou N8N Support.
Pour plus d'informations sur l'API de Gamma, consultez : developers.gamma.app
Codes d'erreur courants
400 Bad Request
Paramètres invalides
Vérifiez votre requête pour :
Champs obligatoires manquants (
inputText,textMode).Valeurs de paramètres invalides.
Limites de caractères ou de jetons dépassées.
Pour
from-template: le modèle doit être un workspace gamma à une seule page. Les Modèles Explore officiels et les gammas multi-pages sont rejetés.
Consultez le message d'erreur pour des détails spécifiques de validation.
401 Unauthorized
Clé API invalide
Votre clé API est invalide ou n'est pas associée à un compte Pro.
Vérifiez que vous utilisez l'en-tête
X-API-KEY(et non Authorization).Générez une nouvelle clé API sur gamma.app/settings/api-keys.
Confirmez que votre compte dispose d'un abonnement Pro, Ultra, Teams ou Business actif.
403 Forbidden
Pas de crédits disponibles
Votre compte a épuisé ses crédits API.
Réglez cela sur gamma.app/settings/billing :
Activez la recharge automatique (recommandé).
Achetez des crédits ponctuellement.
Passez à un abonnement supérieur.
404 Not Found
ID de génération ou gamma invalide
L'ID de génération n'existe pas ou appartient à un autre utilisateur. Cette erreur est aussi renvoyée pour un ID gamma auquel vous n'avez pas accès lors de la lecture, modification ou export d'un gamma existant.
Vérifiez que vous utilisez le bon generationId de la réponse POST, ou que vous avez accès au gamma ciblé.
422 Failed
La génération n'a pas pu être complétée
La génération a produit une sortie vide.
Vérifiez votre requête :
Assurez-vous que
inputTextcontient suffisamment de contenu.Vérifiez que les paramètres correspondent à votre saisie.
Simplifiez les instructions complexes si nécessaire.
429 Too Many Requests
Limite de taux dépassée
Vous avez atteint la limite de taux. Les limites sont définies par propriétaire de clé API et par workspace, et les valeurs actuelles sont documentées dans la référence des codes d'erreur.
🔷 Note : L'API a une capacité généreuse. La plupart des utilisateurs ne rencontrent jamais cette limite en usage normal.
Solutions :
Contactez Gamma Support pour une capacité supérieure.
Mettez en œuvre un backoff exponentiel.
Répartissez les requêtes dans le temps.
500 Internal Server Error
Erreur serveur inattendue
Un problème temporaire de serveur est survenu.
Attendez un moment et réessayez.
Si persistant, contactez le support avec votre
x-request-id.
502 Bad Gateway
Problème temporaire de passerelle
Un problème temporaire de connexion est survenu.
Attendez un moment et réessayez votre requête.
Ma présentation générée par l'API n'apparaît pas dans ma liste de Gammas
Les présentations générées par l'API apparaissent dans la section API Generated du tableau de bord Gamma, pas dans votre liste principale de Gammas (Tous, Récemment consultés ou Créés par vous). C'est un comportement attendu, et renommer la présentation ne change pas sa catégorisation.
Solution de contournement : Ouvrez la présentation et sélectionnez Dupliquer. Le duplicata est traité comme un gamma créé via le web classique et apparaîtra dans votre liste principale de Gammas.
Besoin d'aide supplémentaire ?
Support général : Comment contacter le support Gamma.
Communauté API : Rejoignez le Slack Gamma API.
Problèmes SSO : Contactez l'administrateur informatique de votre organisation.