¿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 profesional: Cualquiera puede acceder a la API hoy en cualquier plan, incluido Free, 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. Cualquiera puede acceder a la API hoy en cualquier plan 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 API.
¿Cómo obtengo acceso?
Para acceder a la Gamma API, sigue estos pasos.
Paso 1: Generar una clave API
Navega a Settings and Members en tu cuenta, 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 profesional: 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 Gamma API 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é puede hacer la API
La Gamma API cubre todo el ciclo de vida de un gamma, desde la creación hasta la exportación.
Generar contenido: Crear presentaciones, documentos, páginas web y publicaciones sociales desde tu propio texto.
Crear desde plantilla: Generar nuevos gammas desde una plantilla que creaste en Gamma, manteniendo su diseño y estructura de tarjetas.
Editar gammas existentes: POST /v1.0/agent/gammas/{gammaId}/edits aplica un cambio en lenguaje natural a una página.
Generación por agente: POST /v1.0/agent/generations inicia una generación desde una plantilla de workspace, un gamma existente o una plantilla oficial de Gamma.
Leer, exportar y analizar gammas existentes: Endpoints para obtener, comentar, exportar y analizar.
Generación de imágenes independientes: Generar imágenes individuales separadas de un gamma completo.
Formato de página web: Generar 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: Compartir contenido por email programáticamente.
APIs de lista: 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.
Límites generosos de entrada: Hasta 100,000 tokens (alrededor de 400,000 caracteres).
¿Puedo generar imágenes independientes con la API?
Puedes generar imágenes independientes con la Gamma 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. La generación de imágenes mediante MCP está disponible en Claude, ChatGPT y otros clientes MCP.
¿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.
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 pre-creados en Gamma y referenciados por ID. No pueden crearse mediante inputText.
Soporte de plantillas
Como "templates" significa cosas diferentes para distintos usuarios, aquí está lo que está disponible.
Temas visuales: Puedes definir el aspecto y la sensación de tus presentaciones creando temas personalizados en Gamma, y 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: Usa Create from template. Crea una plantilla en Gamma, luego llama a POST /v1.0/generations/from-template con su ID y un prompt. El diseño y la estructura de tarjetas de la plantilla se mantienen por defecto, y tu prompt cambia el contenido, la audiencia o el idioma. Las plantillas deben ser gammas de una sola página de tu workspace (una página puede contener muchas tarjetas). Encuentra los IDs de plantillas con GET /v1.0/templates/search.
Generación de agente: POST /v1.0/agent/generations también puede comenzar desde una plantilla de workspace, un gamma existente o una plantilla oficial de Gamma (templateId).
Obteniendo ayuda y soporte
Documentación y recursos
Para referencia técnica completa, visita la documentación para desarrolladores. El acceso a la API está incluido en todos los planes, incluido el Free.
Ayuda para depuración
Cuando necesites ayuda con problemas de la 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 de la API incluye este identificador único en los encabezados. Para usuarios de **Make.com, encuéntralo bajo Output → Bundle → Headers. Para Zapier, revisa la sección 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 profesional: 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 de Gamma, problemas de autenticación y clave API, comprensión de mensajes de error, preguntas sobre límites de tasa y preguntas sobre uso de créditos.
No podemos ayudar con
No podemos depurar ni escribir código personalizado, construir flujos de trabajo completos en Zapier, Make o N8N, depurar aplicaciones personalizadas, proporcionar 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 estás usando.
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é habilitada.
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 comenzar?
Para solución básica de problemas y problemas comunes de la API, consulta nuestra guía completa de solución de problemas. También puedes revisar nuestra documentación completa para desarrolladores para referencia detallada y ejemplos de la API.
Preguntas frecuentes y problemas comunes
¿Puedo editar un gamma existente con la API?
Sí.
POST /v1.0/agent/gammas/{gammaId}/editsaplica una instrucción en lenguaje natural a una página de un gamma que puedes editar, por ejemplo "actualiza la tarjeta de precios con los nuevos niveles."Consulta
GET /v1.0/agent/edits/{editId}para el resultado.Las ediciones no pueden agregar páginas, y solo una edición se ejecuta en una página a la vez.
La misma capacidad está disponible en Claude, ChatGPT, Slack y otros clientes MCP.
¿Puede mi propio agente de IA usar Gamma?
Sí. Conecta cualquier cliente MCP a
https://mcp.gamma.app/mcpe inicia sesión con tu cuenta Gamma. Funciona en todos los planes.Los clientes personalizados necesitan registrar primero sus URIs de redirección OAuth.
¿Cómo uso un diseño Gamma 5 con la API?
Los diseños Gamma 5 son plantillas, no temas. Encuentra sus IDs con
GET /v1.0/templates/search. Los diseños oficiales aparecen comoexploreTemplatesy los tuyos comoworkspaceTemplates(10 por lista por defecto, hasta 25).Pasa el ID como
templateIdaPOST /v1.0/agent/generations.templateIdtambién acepta el ID de un gamma en tu workspace.POST /v1.0/generations/from-templatesolo acepta plantillas de tu propio workspace, no plantillas oficiales de Gamma.
¿Puedo usar un templateId y un themeId juntos?
No. Enviar ambos devuelve un error 400.
themeIdpor sí solo funciona enPOST /v1.0/agent/generationsy aplica tu tema guardado al diseño estándar de Gamma.Ni
templateIdnithemeIdpueden combinarse con un archivo subido para importación.
¿Cómo obtengo todos mis IDs de temas?
GET /v1.0/themesdevuelve hasta 50 temas por página (50 es el máximolimit).Para obtener la siguiente página, pasa el valor
nextCursorcomo parámetroafter. Repite hasta quehasMoresea falso.
¿Puedo compartir mis claves API con otros?
Las claves API deben mantenerse seguras y no compartirse.
Generar claves separadas para diferentes casos de uso si es necesario.
¿Por qué no puedo copiar mi clave API de nuevo?
Por razones de seguridad, las claves API solo se muestran una vez cuando se generan.
Si pierdes tu clave, necesitarás generar una nueva.
¿Puedo generar múltiples claves API?
Sí, puedes crear múltiples claves API para diferentes proyectos o casos de uso a través de 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 la última vez que se actualizó un gamma.
¿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 con Atención 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 Duplicar. La copia se trata como un gamma estándar creado en la web y aparecerá en todas las vistas habituales.