Qu'est-ce que l'API Gamma ?
Vous avez une présentation que vous adorez ? Et si vous pouviez en créer 100 autres similaires, personnalisées pour différents publics à travers le monde ?
L'API Gamma Générer vous permet de créer des présentations, documents, pages web et publications sociales de manière programmatique sans utiliser directement l'application Gamma. C'est parfait pour les utilisateurs souhaitant automatiser leurs workflows avec des outils comme Zapier, Make ou n8n, intégrer la génération de présentations élégantes dans leurs propres applications, ou créer des présentations à grande échelle via une intégration backend.
Et si vous êtes développeur, vous pouvez intégrer Gamma dans votre application pour lui donner des superpouvoirs de design !
💎 Astuce Pro : Toute personne disposant d'un compte Pro ou supérieur peut accéder à l'API dès aujourd'hui avec des limites d'utilisation généreuses.
L'API est-elle prête ?
L'API Gamma v1.0 est disponible en version générale (GA) depuis le 5 novembre 2025. Toute personne disposant d'un compte Pro ou supérieur peut accéder à l'API dès aujourd'hui avec des limites d'utilisation généreuses.
🔷 Note : L'API v0.2 est obsolète et sera arrêtée le 16 janvier 2026. Si vous utilisez actuellement la v0.2, veuillez migrer vers la v1.0 avant cette date.
Pour des informations détaillées sur les paramètres spécifiques de l'API et leur impact sur la génération de présentations, consultez notre documentation API.
Comment obtenir l'accès ?
Pour accéder à l'API Gamma, suivez ces étapes.
Étape 1 : Mettez à niveau votre compte
Vous devez disposer d'un compte Gamma Pro, Ultra, Team ou Business. Si vous n'êtes pas actuellement utilisateur Pro ou supérieur, passez à Pro pour accéder à l'API.
Étape 2 : Générer une clé API
Allez dans Paramètres et Membres de votre compte Pro, puis dans l'onglet clé API. Cliquez sur Créer une clé API pour générer votre clé, puis copiez-la et stockez-la en toute sécurité.
🔷 Note : Les clés API utilisent le format sk-gamma-xxxxxxxx et doivent être transmises via l'en-tête X-API-KEY (pas au format Bearer token).
💎 Astuce Pro : Commencez à utiliser l'API avec vos outils d'automatisation préférés ou intégrez-la directement dans votre code backend. L'URL de base est https://public-api.gamma.app/v1.0/
Puis-je m'authentifier avec OAuth au lieu d'une clé API ?
Vous pouvez vous authentifier avec l'API REST Gamma en utilisant OAuth 2.0 au lieu d'une clé API statique. OAuth vous permet de connecter l'API Gamma à une application sans créer ni stocker une clé API à long terme, ce qui est utile pour les intégrations et applications partenaires. Les clés API statiques sont toujours entièrement prises en charge, vous pouvez donc continuer à utiliser l'en-tête X-API-KEY si vous préférez. Pour configurer OAuth, suivez le guide Authentification avec OAuth dans la documentation développeur à developers.gamma.app/get-started/authenticate-with-oauth.
Utilisation et limites de débit
Limites actuelles de l'API
L'API Gamma est conçue pour évoluer selon vos besoins. Que vous génériez quelques présentations ou des centaines, vous devriez pouvoir créer selon vos besoins sans rencontrer de limites en usage normal.
🌀 Conseil : Si vous rencontrez des limitations de débit (erreurs HTTP 429), contactez notre équipe support. Nous travaillerons avec vous pour que l'API soutienne votre projet !
Quoi de neuf dans la v1.0 ?
L'API v1.0 inclut plusieurs nouvelles fonctionnalités puissantes :
Format page web : Générez des pages web en plus des présentations, documents et publications sociales.
Personnalisation des en-têtes et pieds de page : Personnalisez les en-têtes et pieds de page de votre contenu.
URLs d'images en entrée : Référencez directement des images dans votre contenu.
Organisation en dossiers : Organisez le contenu généré dans des dossiers.
Partage par email : Partagez le contenu par email de manière programmatique.
APIs de liste : Nouveaux points d'accès pour lister vos thèmes et dossiers.
Recherche de gammas : Recherchez dans les titres et le texte complet des gammas auxquels vous avez accès, et filtrez les résultats avant de les ouvrir.
Meilleures limites d'entrée : Jusqu'à 100 000 tokens (environ 400 000 caractères).
🌀 Conseil : Au fur et à mesure de l'évolution de l'API, nous continuerons d'ajouter plus d'options pour modifier et remixer les Gammas de manière programmatique.
Puis-je générer des images autonomes avec l'API ?
Vous pouvez désormais générer des images autonomes avec l'API Gamma Générer et via le Model Context Protocol (MCP). Cela vous permet de créer des images individuelles de manière programmatique, séparément de la génération d'une présentation, document ou page web complète. Pour générer des images via l'API ou MCP, suivez le guide Créer une génération d'image dans la documentation développeur à developers.gamma.app/images/create-image-generation. La génération d'images via MCP est disponible aujourd'hui dans Claude et d'autres clients MCP ; elle n'est pas encore disponible dans ChatGPT.
Puis-je rechercher mes gammas avec l'API ou MCP ?
Vous pouvez rechercher dans toute votre bibliothèque de gammas depuis l'API Gamma ou via un assistant IA connecté à Gamma avec le Model Context Protocol (MCP), une norme ouverte permettant aux assistants IA de se connecter à des outils comme Gamma. La recherche porte à la fois sur les titres et le texte complet de chaque gamma auquel vous avez accès, et classe les résultats par pertinence pour afficher la meilleure correspondance en premier. Chaque résultat inclut un lien direct, vous permettant d'ouvrir le gamma directement depuis la réponse.
Vous pouvez affiner votre recherche selon l'auteur du gamma et la date de dernière mise à jour. Les gammas archivés sont exclus par défaut, mais vous pouvez choisir de les inclure.
🔷 Note : La recherche est déployée progressivement, elle n'est donc pas encore disponible dans tous les espaces de travail. Si le point d'accès de recherche ou l'outil de recherche MCP ne fonctionne pas pour vous, votre espace de travail ne l'a pas encore reçu.
Pour la liste complète des paramètres de recherche et des exemples de requêtes, suivez le guide Recherche de gammas dans la documentation développeur à developers.gamma.app/management/search-gammas.
À quoi puis-je utiliser l'API ?
Exploitez l'API Gamma pour des plateformes d'automatisation comme Make, Zapier, Workato et autres outils de workflow. Vous pouvez aussi créer des applications personnalisées avec une intégration directe dans le code backend pour alimenter vos propres applications, générer des présentations en masse en créant plusieurs présentations de manière programmatique, ou créer du contenu personnalisé à grande échelle.
🔷 Note : Votre inputText doit contenir le contenu réel que vous souhaitez sur vos diapositives, pas des instructions sur la création de la présentation. Les thèmes doivent être pré-créés dans Gamma et référencés par ID. Ils ne peuvent pas être créés via inputText.
Support des modèles
Parce que "templates" signifie différentes choses pour différents utilisateurs, voici ce qui est disponible.
Thèmes visuels : Vous pouvez définir l'apparence de vos présentations en créant des thèmes personnalisés dans Gamma, puis en les référant dans l'API via leur ID de thème. Utilisez l'API List Themes (GET /v1.0/themes) pour obtenir les IDs de thèmes disponibles.
Modèles de structure de contenu : Nous travaillons à ajouter un support strict de la structure de contenu dans de futures mises à jour.
Obtenir de l'aide et du support
Documentation et ressources
Pour une référence technique complète, consultez la documentation API Reference. Vous pouvez également consulter notre Landing Page pour un aperçu et un guide de démarrage. L'accès API est inclus avec les abonnements Pro, Ultra, Teams et Business.
Aide au débogage
Lorsque vous avez besoin d'aide pour des problèmes API, consultez notre documentation sur les erreurs pour les problèmes courants et leurs solutions, puis contactez le Customer Support. Incluez toujours le x-request-id de votre réponse API lors de votre demande d'aide.
Chaque réponse API inclut cet identifiant unique dans les en-têtes. Pour les utilisateurs Make.com, trouvez-le sous Output → Bundle → Headers. Pour Zapier, vérifiez la section Run Details → Data Out dans l'historique des tâches pour les exécutions réussies, ou l'onglet Logs → Response information (développez les en-têtes) pour les requêtes échouées.
💎 Astuce Pro : Incluez toujours votre ID de requête, le message d'erreur exact et un exemple de votre corps de requête lors de la demande de support.
Portée du support
Nous pouvons aider avec
Nous pouvons aider avec les problèmes API spécifiques à Gamma, les problèmes d'authentification et de clé API, la compréhension des messages d'erreur, les questions sur les limites de taux et les questions sur l'utilisation des crédits.
Nous ne pouvons pas aider avec
Nous ne pouvons pas déboguer ou écrire du code personnalisé, créer des workflows complets dans Zapier, Make ou N8N, déboguer des applications personnalisées, fournir des instructions sur l'utilisation de Zapier, Make ou N8N, ni concevoir une architecture personnalisée.
Lors de la demande d'aide API, veuillez fournir votre ID de requête, le message d'erreur, un exemple de corps de requête et la plateforme d'automatisation que vous utilisez.
Codes d'erreur courants
401 Unauthorized : Clé API invalide. Assurez-vous d'utiliser l'en-tête X-API-KEY (pas Authorization ni Bearer).
403 Forbidden : Vérifiez votre solde de crédits et assurez-vous que la recharge automatique est activée.
429 Too Many Requests : Vous avez atteint la limite de taux. Contactez le support Slack pour des options de capacité supérieure.
422 Failed : La génération n'a pas pu être complétée. Vérifiez vos paramètres d'entrée.
Besoin d'aide pour commencer ?
Pour le dépannage de base et les problèmes API courants, consultez notre guide complet de dépannage. Vous pouvez également consulter notre documentation complète pour développeurs pour une référence API détaillée et des exemples.
FAQs & problèmes courants
Puis-je partager mes clés API avec d'autres ?
Les clés API doivent être gardées en sécurité et ne pas être partagées.
Générez des clés séparées pour différents cas d'utilisation si nécessaire.
Pourquoi ne puis-je plus copier ma clé API ?
Pour des raisons de sécurité, les clés API ne sont affichées qu'une seule fois lors de leur génération.
Si vous perdez votre clé, vous devrez en générer une nouvelle.
Puis-je générer plusieurs clés API ?
Oui, vous pouvez créer plusieurs clés API pour différents projets ou cas d'utilisation via vos Paramètres de compte.
Quels gammas apparaissent dans les résultats de recherche API ou MCP ?
La recherche ne renvoie que les gammas auxquels vous avez déjà accès, elle ne révèle donc jamais de contenu que vous ne pouvez pas ouvrir dans Gamma.
Les résultats sont classés par pertinence, avec la correspondance la plus proche de votre requête en premier.
Les gammas archivés sont exclus sauf si vous choisissez de les inclure.
Vous pouvez également filtrer par créateur et par date de dernière mise à jour d'un gamma.
Pourquoi la recherche ne fonctionne-t-elle pas dans mon espace de travail ?
La recherche dans vos gammas est déployée progressivement et n'est pas encore activée pour tous les espaces de travail.
Si elle n'est pas disponible, contactez le Customer Support et incluez votre
x-request-idpour que nous puissions vérifier votre espace de travail.
Dois-je migrer de la v0.2 à la v1.0 ?
Oui, la v0.2 sera arrêtée le 16 janvier 2026.
La migration est simple : mettez à jour votre URL de base de
/v0.2/à/v1.0/.Changez le paramètre
themeNameenthemeId(obtenez les IDs via l'API List Themes).Mettez à jour les limites d'entrée - la v1.0 utilise 100k tokens au lieu de 750k caractères.
Consultez la documentation API pour tous les détails des points de terminaison v1.0.
Quelles sont les principales différences entre la v0.2 et la v1.0 ?
La v1.0 offre des limites de taux beaucoup plus généreuses (des centaines par heure contre 50 par jour).
La v1.0 inclut la prise en charge du format page web.
Meilleures limites d'entrée (100k tokens contre 750k caractères).
Organisation des dossiers et List APIs pour les thèmes et dossiers.
Que se passe-t-il si je n'ai plus de crédits ?
Activez la recharge automatique dans vos Paramètres de facturation sur gamma.app/settings/billing pour garantir un accès API ininterrompu.
Où les présentations Générées par l'API apparaissent-elles dans le tableau de bord Gamma ?
Les présentations créées via 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).
Pour qu'une présentation générée par l'API apparaisse dans votre liste habituelle de Gammas, ouvrez-la et sélectionnez Dupliquer. Le duplicata est traité comme un gamma standard créé sur le web et apparaîtra dans toutes les vues habituelles.
