¿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 directamente la app Gamma. 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á disponible generalmente (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.
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 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 carpetas: Organiza el contenido generado en carpetas.
Compartir por email: Comparte contenido por email programáticamente.
APIs de lista: Nuevos endpoints para listar tus Temas y Carpetas.
Búsqueda de 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 AI conectado a Gamma con el Model Context Protocol (MCP), un estándar abierto que permite a asistentes AI 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 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 la búsqueda por creador y por fecha de última actualización. Los gammas archivados se excluyen 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 MCP no funcionan, 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 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 pre-creados en Gamma y referenciados por ID. No pueden crearse mediante inputText.
Soporte de Plantillas
Como "plantillas" 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 API List Themes (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, visita la documentación de referencia de la API. También puedes revisar nuestra Landing Page para una visión general y guía de inicio. El acceso a la API está incluido con suscripciones Pro, Ultra, Teams y Business.
Ayuda para depuración
Cuando necesites ayuda con problemas de API, consulta nuestra documentación de errores para problemas comunes y soluciones, luego contacta al Soporte al Cliente. Siempre incluye el x-request-id de tu respuesta API al pedir ayuda.
Cada respuesta API incluye este identificador único en los encabezados. Para usuarios de Make.com, encuéntralo bajo Output → Bundle → Headers. Para Zapier, revisa Run Details → Data Out en el Historial de Tareas para ejecuciones exitosas, o la pestaña Logs → Response information (expande encabezados) para solicitudes fallidas.
💎 Consejo Pro: Siempre incluye tu ID de solicitud, el mensaje exacto de error y una muestra del cuerpo de tu solicitud al pedir soporte.
Alcance del soporte
Podemos ayudar con
Podemos ayudar con problemas específicos de la API Gamma, autenticación y problemas con claves API, entender mensajes de error, preguntas sobre límites de tasa y uso de créditos.
No podemos ayudar con
No podemos depurar o 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 la API, por favor proporciona tu ID de solicitud, mensaje de error, muestra del cuerpo de la solicitud y qué plataforma de automatización usas.
Códigos de error comunes
401 Unauthorized: Clave API inválida. Asegúrate de usar el encabezado X-API-KEY (no Authorization ni Bearer).
403 Forbidden: Revisa tu saldo de créditos y asegúrate de que la recarga automática esté activada.
429 Too Many Requests: Has alcanzado el límite de tasa. Contacta al soporte de Slack para opciones de mayor capacidad.
422 Failed: La generación no pudo completarse. Revisa tus parámetros de entrada.
¿Necesitas ayuda para empezar?
Para solución básica de problemas y problemas comunes de API, consulta nuestra guía completa de solución de problemas. También puedes revisar nuestra documentación completa para desarrolladores con referencia detallada y ejemplos de API.
Preguntas frecuentes y problemas comunes
¿Puedo compartir mis claves API con otros?
Las claves API deben mantenerse seguras y no compartirse.
Genera 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 pierdes tu clave, deberás generar una nueva.
¿Puedo generar múltiples claves API?
Sí, puedes crear múltiples claves API para diferentes proyectos o casos de uso desde los ajustes de tu cuenta.
¿Qué gammas aparecen en los resultados de búsqueda de API o MCP?
La búsqueda solo devuelve gammas a los que ya tienes acceso, por lo que nunca expone contenido que no puedas abrir en Gamma.
Los resultados se ordenan por relevancia, con la coincidencia más cercana a tu consulta primero.
Los gammas archivados se excluyen a menos que elijas incluirlos.
También puedes filtrar por creador y por fecha de última actualización.
¿Por qué no funciona la búsqueda en mi espacio de trabajo?
La búsqueda en tus gammas se está implementando gradualmente y aún no está habilitada para todos los espacios de trabajo.
Si no está disponible, contacta al Soporte al Cliente e incluye tu
x-request-idpara que podamos revisar tu espacio de trabajo.
¿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 (Todas, Vistas Recientemente o Creadas por Ti).
Para que una presentación generada por API aparezca en tu lista regular de Gammas, ábrela y selecciona Duplicate. El duplicado se trata como un gamma estándar creado en la web y aparecerá en todas las vistas habituales.
