¿Qué es la Gamma API?
¿Tienes una presentación que te encanta? ¿Y si pudieras crear 100 más iguales, personalizadas para diferentes audiencias en todo el mundo?
La Gamma Generate API te permite crear presentaciones, documentos, páginas web y publicaciones sociales programáticamente sin usar la app Gamma directamente. Es ideal para usuarios que quieren automatizar sus flujos de trabajo con herramientas como Zapier, Make o n8n, integrar la generación de presentaciones hermosas en sus propias aplicaciones o crear presentaciones a gran escala mediante integración de código backend.
Y si eres desarrollador, ¡puedes integrar Gamma en tu aplicación para darle superpoderes de diseño!
💎 Consejo Pro: Cualquier persona con una cuenta Pro o superior puede acceder a la API hoy con límites de uso generosos.
¿Está lista la API?
La Gamma API v1.0 está Generalmente Disponible (GA) desde el 5 de noviembre de 2025. Cualquier persona con una cuenta Pro o superior puede acceder a la API hoy con límites de uso generosos.
🔷 Nota: La API v0.2 está obsoleta y dejará de funcionar el 16 de enero de 2026. Si usas v0.2, migra a v1.0 antes de esa fecha.
Para información detallada sobre parámetros específicos de la API y cómo afectan la generación de presentaciones, consulta nuestra documentación de la API.
¿Cómo obtengo acceso?
Para acceder a la Gamma API, sigue estos pasos.
Paso 1: Actualiza tu cuenta
Debes tener una cuenta Gamma Pro, Ultra, Team o Business. Si no eres usuario Pro o superior, actualiza a Pro para acceder a la API.
Paso 2: Genera una clave API
Navega a Ajustes and Miembros en tu cuenta Pro, luego ve a la pestaña API key. Haz clic en Create API key para generar tu clave, luego cópiala y guárdala de forma segura.
🔷 Nota: Las claves API usan el formato sk-gamma-xxxxxxxx y deben enviarse usando el encabezado X-API-KEY (no formato Bearer token).
💎 Consejo Pro: Comienza a usar la API con tus herramientas de automatización favoritas o intégrala directamente en tu código backend. La URL base es https://public-api.gamma.app/v1.0/
¿Puedo autenticarme con OAuth en lugar de una clave API?
Puedes autenticarte con la Gamma REST API usando OAuth 2.0 en lugar de una clave API estática. OAuth te permite conectar la API Gamma a una aplicación sin crear o almacenar una clave API de larga duración, útil para integraciones y apps de socios. Las claves API estáticas siguen siendo totalmente compatibles, así que puedes seguir usando el encabezado X-API-KEY si prefieres. Para configurar OAuth, sigue la guía Authenticate with OAuth en la documentación para desarrolladores en developers.gamma.app/get-started/authenticate-with-oauth.
Uso y límites de tasa
Límites actuales de la API
La API de Gamma está diseñada para escalar según tus necesidades. Ya sea que generes pocas o cientos de presentaciones, deberías poder crear según tus requerimientos sin encontrar límites en el uso normal.
🌀 Consejo: Si encuentras limitación de tasa (errores HTTP 429), contacta a nuestro equipo de soporte. Trabajaremos contigo para asegurar que la API soporte lo que estás construyendo.
¿Qué hay de nuevo en v1.0?
La API v1.0 incluye varias funciones nuevas y potentes:
Formato de página web: Genera páginas web además de presentaciones, documentos y publicaciones sociales.
Personalización de encabezados y pies de página: Personaliza los encabezados y pies de página de tu contenido.
URLs de imágenes en la entrada: Referencia imágenes directamente en tu contenido.
Organización en folders: Organiza el contenido generado en folders.
Compartir por email: Comparte contenido por email programáticamente.
APIs de listas: Nuevos endpoints para listar tus Temas y folders.
Buscar gammas: Busca en los títulos y texto completo de los gammas a los que tienes acceso, y filtra resultados antes de abrirlos.
Mejores límites de entrada: Hasta 100,000 tokens (alrededor de 400,000 caracteres).
🌀 Consejo: A medida que la API evoluciona, seguiremos añadiendo más opciones para modificar y remezclar Gammas programáticamente.
¿Puedo generar imágenes independientes con la API?
Ahora puedes generar imágenes independientes con la Gamma Generate API y a través del Model Context Protocol (MCP). Esto te permite crear imágenes individuales programáticamente, separadas de generar una presentación, documento o página web completa. Para generar imágenes mediante la API o MCP, sigue la guía Create image generation en la documentación para desarrolladores en developers.gamma.app/images/create-image-generation. La generación de imágenes mediante MCP está disponible hoy en Claude y otros clientes MCP; aún no está disponible en ChatGPT.
¿Puedo buscar mis gammas con la API o MCP?
Puedes buscar toda tu biblioteca de gammas desde la Gamma API o a través de un asistente de IA conectado a Gamma con el Model Context Protocol (MCP), un estándar abierto que permite a asistentes de IA conectarse a herramientas como Gamma. La búsqueda revisa tanto los títulos como el texto completo de cada gamma al que tienes acceso, y ordena los resultados por relevancia para que la coincidencia más cercana aparezca primero. Cada resultado incluye un enlace directo para abrir el gamma desde la respuesta.
Puedes filtrar tu búsqueda por quién creó el gamma y cuándo fue actualizado por última vez. Los gammas archivados están excluidos por defecto, pero puedes elegir incluirlos.
🔷 Nota: La búsqueda se está implementando gradualmente, por lo que aún no está disponible en todos los espacios de trabajo. Si el endpoint de búsqueda o la herramienta de búsqueda MCP no funcionan para ti, tu espacio de trabajo aún no la tiene.
Para la lista completa de parámetros de búsqueda y ejemplos de solicitudes, sigue la guía Search gammas en la documentación para desarrolladores en developers.gamma.app/management/search-gammas.
¿Para qué puedo usar la API?
Aprovecha la Gamma API para plataformas de automatización como Make, Zapier, Workato y otras herramientas de flujo de trabajo. También puedes crear aplicaciones personalizadas con integración directa en código backend para potenciar tus propias apps, generar presentaciones en masa creando múltiples presentaciones programáticamente o crear contenido personalizado a gran escala.
🔷 Nota: Tu inputText debe contener el contenido real que quieres en tus diapositivas, no instrucciones sobre cómo crear la presentación. Los Temas deben estar precreados en Gamma y referenciados por ID. No pueden crearse mediante inputText.
Soporte de plantillas
Como "templates" significa cosas diferentes para distintos usuarios, esto es lo que está disponible.
Temas visuales: Puedes definir el aspecto de tus presentaciones creando Temas personalizados en Gamma, luego referenciándolos en la API usando su ID de tema. Usa la List Themes API (GET /v1.0/themes) para obtener los IDs de Temas disponibles.
Plantillas de estructura de contenido: Estamos trabajando en añadir soporte estricto para estructura de contenido en futuras actualizaciones.
Obtener ayuda y soporte
Documentación y recursos
Para referencia técnica completa, visite la documentación de API Reference. También puede revisar nuestra Landing Page para una visión general y guía de inicio. El acceso a API está incluido con las suscripciones Pro, Ultra, Teams y Business.
Ayuda para depuración
Cuando necesite ayuda con problemas de API, consulte nuestra documentación de errores para problemas comunes y soluciones, luego contacte a Customer Support. Siempre incluya el x-request-id de su respuesta API al solicitar ayuda.
Cada respuesta de API incluye este identificador único en los encabezados. Para Make.com users, encuéntrelo bajo Output → Bundle → Headers. Para Zapier, revise la sección Run Details → Data Out en el historial de tareas para ejecuciones exitosas, o la pestaña Logs → Response information (expanda encabezados) para solicitudes fallidas.
💎 Consejo profesional: Siempre incluya su ID de solicitud, el mensaje exacto de error y una muestra del cuerpo de su solicitud al pedir soporte.
Alcance del soporte
Podemos ayudar con
Podemos ayudar con problemas específicos de API de Gamma, problemas de autenticación y clave API, comprensión de mensajes de error, preguntas sobre límites de tasa y uso de créditos.
No podemos ayudar con
No podemos depurar ni escribir código personalizado, construir flujos completos en Zapier, Make o N8N, depurar aplicaciones personalizadas, dar instrucciones sobre el uso de Zapier, Make o N8N, ni diseñar arquitectura personalizada.
Al solicitar ayuda con API, proporcione su ID de solicitud, mensaje de error, muestra del cuerpo de la solicitud y la plataforma de automatización que está usando.
Códigos de error comunes
401 Unauthorized: Clave API inválida. Asegúrese de usar el encabezado X-API-KEY (no Authorization ni Bearer).
403 Forbidden: Verifique su saldo de créditos y asegúrese de que la recarga automática esté habilitada.
429 Too Many Requests: Ha alcanzado el límite de tasa. Contacte a soporte de Slack para opciones de mayor capacidad.
422 Failed: La generación no pudo completarse. Verifique sus parámetros de entrada.
¿Necesita ayuda para comenzar?
Para solución básica de problemas y problemas comunes de API, consulte nuestra guía completa de solución de problemas. También puede revisar nuestra documentación completa para desarrolladores para referencia detallada de API y ejemplos.
Preguntas frecuentes y problemas comunes
¿Puedo compartir mis claves API con otros?
Las claves API deben mantenerse seguras y no compartirse.
Genere claves separadas para diferentes casos de uso si es necesario.
¿Por qué no puedo copiar mi clave API nuevamente?
Por razones de seguridad, las claves API solo se muestran una vez al generarlas.
Si pierde su clave, deberá generar una nueva.
¿Puedo generar múltiples claves API?
Sí, puede crear múltiples claves API para diferentes proyectos o casos de uso a través de los ajustes de su cuenta.
¿Qué gammas aparecen en los resultados de búsqueda de API o MCP?
La búsqueda solo devuelve gammas a los que ya tiene acceso, por lo que nunca expone contenido que no pueda abrir en Gamma.
Los resultados se ordenan por relevancia, con la coincidencia más cercana a su consulta primero.
Los gammas archivados se excluyen a menos que elija incluirlos.
También puede filtrar por creador y por la última actualización de un gamma.
¿Por qué no funciona la búsqueda en mi espacio de trabajo?
La búsqueda en sus gammas se está implementando gradualmente y aún no está habilitada para todos los espacios de trabajo.
Si no está disponible, contacte a Customer Support e incluya su
x-request-idpara que podamos revisar su espacio de trabajo.
¿Necesito migrar de v0.2 a v1.0?
Sí, v0.2 finalizará el 16 de enero de 2026.
La migración es sencilla: actualice su URL base de
/v0.2/a/v1.0/.Cambie el parámetro
themeNameathemeId(obtenga los IDs de la API List Themes).Actualice los límites de entrada: v1.0 usa 100k tokens en lugar de 750k caracteres.
Consulte la documentación de API para detalles completos del endpoint v1.0.
¿Cuáles son las principales diferencias entre v0.2 y v1.0?
v1.0 ofrece límites de tasa mucho más generosos (cientos por hora vs. 50 por día).
v1.0 incluye soporte para formato de página web.
Mejores límites de entrada (100k tokens vs. 750k caracteres).
Organización de carpetas y List APIs para Temas y Carpetas.
¿Qué pasa si me quedo sin créditos?
Activa la recarga automática en tus ajustes de facturación en gamma.app/settings/billing para asegurar acceso ininterrumpido a la API.
¿Dónde aparecen las presentaciones generadas por API en el panel de Gamma?
Las presentaciones creadas vía API aparecen en la sección API Generated del panel de Gamma, no en tu lista principal de Gammas (Todos, Vistos Recientemente o Creados por Ti).
Para que una presentación generada por API aparezca en tu lista regular de Gammas, ábrela y selecciona Duplicar. La copia se trata como un gamma estándar creado en la web y aparecerá en todas las vistas habituales.