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 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 flux de travail 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 : 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.
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 : Améliorez 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
Accédez à Paramètres and Membres dans votre compte Pro, puis allez à l'onglet clé API. Cliquez sur Créer clé API pour générer votre clé, puis copiez 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 à 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 une limitation de débit (erreurs HTTP 429), contactez notre équipe support. Nous travaillerons avec vous pour que l'API supporte 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érer 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, commentaires, exporter et analyses.
Génération d'images autonome : Générer des images individuelles séparément d'un gamma complet.
Format page web : Générer 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 : 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 d'entrée généreuses : 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 Créer une génération d'image 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 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 intégration directe dans le code backend pour alimenter vos propres applications, 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 « modèles » 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 Créer à partir d'un modèle. 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 de 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 sur developers.gamma.app. L'accès à l'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 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 lorsque vous demandez de l'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 lorsque vous demandez du 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.
Lorsque vous demandez de l'aide pour l'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 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 prix 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 doivent 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 workspace ?
La recherche dans vos gammas est déployée progressivement et n'est pas encore activée pour tous les workspaces.
Si elle n'est pas disponible, contactez le Customer Support et incluez votre
x-request-idafin que nous puissions vérifier votre workspace.É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 billing 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, et non dans votre liste principale de Gammas (All, Recently Viewed, ou Created by You).
Pour qu'une présentation générée par l'API apparaisse dans votre liste habituelle 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.