Qu'est-ce que l'API Gamma ?
Vous avez un deck que vous adorez ? Et si vous pouviez en créer 100 autres similaires, personnalisés pour différents publics à travers le monde ?
L'API Gamma Generate vous permet de créer des présentations, documents, pages web et publications sociales de manière programmatique sans utiliser directement l'application Gamma. Parfait pour automatiser vos workflows avec des outils comme Zapier, Make ou n8n, intégrer la génération de présentations dans vos 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 super-pouvoirs de design !
💎 Astuce Pro : Tout le monde peut accéder à l'API aujourd'hui sur n'importe quel plan, y compris le plan Free, 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. Tout le monde peut accéder à l'API aujourd'hui sur n'importe quel plan avec des limites d'utilisation généreuses.
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 : Générer une clé API
Allez dans Paramètres and Membres de votre compte, puis dans l'onglet API key. Cliquez sur Create API key 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 longue durée, 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 Authenticate with OAuth dans la documentation développeur sur 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 ce que vous construisez !
Ce que l'API peut faire
L'API Gamma couvre tout le cycle de vie d'un gamma, de la création à l'exportation.
Générer du contenu : Créez des présentations, documents, pages web et publications sociales à partir de votre propre texte.
Créer à partir d'un modèle : Générez de nouveaux gammas à partir d'un modèle que vous avez créé dans Gamma, en conservant sa mise en page et sa structure de cartes.
Modifier des gammas existants : POST /v1.0/agent/gammas/{gammaId}/edits applique un changement en langage naturel à une page.
Génération par agent : POST /v1.0/agent/generations lance une génération à partir d'un modèle d'espace de travail, d'un gamma existant ou d'un modèle officiel Gamma.
Lire, exporter et analyser des gammas existants : Points d'accès pour obtenir, commenter, exporter et analyser.
Génération d'images autonome : Générez des images individuelles séparément d'un gamma complet.
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 du contenu par email de manière programmatique.
APIs de liste : 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.
Limites généreuses d'entrée : Jusqu'à 100 000 tokens (environ 400 000 caractères).
Puis-je générer des images autonomes avec l'API ?
Vous pouvez générer des images autonomes avec l'API Gamma 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 Create image generation dans la documentation développeur. La génération d'images via MCP est disponible dans Claude, ChatGPT et d'autres clients MCP.
Puis-je rechercher mes gammas avec l'API ou MCP ?
Vous pouvez rechercher 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 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 pour 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.
Pour la liste complète des paramètres de recherche et des exemples de requêtes, suivez le guide Search gammas dans la documentation développeur sur 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 intégration directe dans le code backend pour alimenter vos propres apps, générer en masse des présentations 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 en utilisant 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 : Utilisez Create from template. Construisez un modèle dans Gamma, puis appelez POST /v1.0/generations/from-template avec son ID et une invite. La mise en page et la structure des cartes du modèle sont conservées par défaut, et votre invite modifie le contenu, le public ou la langue. Les modèles doivent être des gammas à page unique de votre espace de travail (une page peut contenir plusieurs cartes). Trouvez les IDs des modèles avec GET /v1.0/templates/search.
Génération d'agent : POST /v1.0/agent/generations peut également démarrer à partir d'un modèle d'espace de travail, d'un gamma existant ou d'un modèle officiel Gamma (templateId).
Obtenir de l'aide et du support
Documentation et ressources
Pour une référence technique complète, consultez la documentation développeur. L'accès à l'API est inclus dans tous les plans, y compris Free.
Aide au débogage
Lorsque vous avez besoin d'aide pour des problèmes d'API, consultez notre documentation sur les erreurs pour les problèmes courants et leurs solutions, puis contactez le support client. 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 du corps de votre requête lors de la demande de support.
Portée du support
Nous pouvons aider avec
Nous pouvons aider avec les problèmes d'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é, construire 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 pour l'API, veuillez fournir votre ID de requête, le message d'erreur, un exemple du corps de la 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 courants d'API, consultez notre guide complet de dépannage. Vous pouvez également consulter notre documentation développeur complète pour une référence API détaillée et des exemples.
FAQs & Problèmes courants
Puis-je Modifier un gamma existant avec l'API ?
Oui.
POST /v1.0/agent/gammas/{gammaId}/editsapplique une instruction en langage naturel à une page d'un gamma que vous pouvez Modifier, par exemple « mettre à jour la carte des tarifs avec les nouveaux paliers. »Interrogez
GET /v1.0/agent/edits/{editId}pour le résultat.Les Modifications ne peuvent pas ajouter de pages, et une seule Modification s'exécute sur une page à la fois.
La même capacité est disponible dans Claude, ChatGPT, Slack et d'autres clients MCP.
Mon propre agent IA peut-il utiliser Gamma ?
Oui. Connectez n'importe quel client MCP à
https://mcp.gamma.app/mcpet connectez-vous avec votre compte Gamma. Cela fonctionne sur tous les plans.Les clients personnalisés doivent d'abord enregistrer leurs URI de redirection OAuth.
Puis-je partager mes clés API avec d'autres ?
Les clés API doivent être gardées sécurisées 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 les paramètres de votre compte.
Quels gammas apparaissent dans les résultats de recherche API ou MCP ?
La recherche ne retourne 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 Support Client et incluez votre
x-request-idafin que nous puissions vérifier votre espace de travail.Éditeur : supprimez cette FAQ si la recherche est confirmée à 100 %.
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ù apparaissent les présentations générées par l'API 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 (All, Recently Viewed, or Created by You).
Pour qu'une présentation générée par l'API apparaisse dans votre liste régulière de Gammas, ouvrez-la et sélectionnez Duplicate. Le duplicata est traité comme un gamma standard créé sur le web et apparaîtra dans toutes les vues habituelles.