Guía de solución de problemas de Gamma API
Aunque nos encantaría ayudar con todo lo relacionado con API, tenga en cuenta que nuestro equipo de soporte no puede crear flujos de trabajo, depurar su código backend (FastAPI, Express, Django, etc.) ni solucionar problemas específicos de la plataforma.
Podemos ayudar con preguntas específicas de Gamma sobre nuestros endpoints y parámetros, autenticación API, solución de errores, créditos y verificar que su solicitud coincida con nuestra documentación.
Para ayuda específica de la plataforma, contacte con Zapier Support, Make Support o N8N Support.
Para más información sobre la API de Gamma, consulte: developers.gamma.app
Códigos de error comunes
400 Solicitud incorrecta
Parámetros inválidos
Revise su solicitud para:
Campos obligatorios faltantes (
inputText,textMode).Valores de parámetros inválidos.
Se excedieron los límites de caracteres o tokens.
Para
from-template: la plantilla debe ser un workspace gamma de una sola página. Las Plantillas oficiales Explore y gammas de varias páginas son rechazadas.
Revise el mensaje de error para detalles específicos de validación.
401 No autorizado
Clave API inválida
Su clave API es inválida o no está asociada con una cuenta Pro.
Verifique que está usando el encabezado
X-API-KEY(no Authorization).Genere una nueva clave API en gamma.app/settings/api-keys.
Confirme que su cuenta tiene un plan activo Pro, Ultra, Teams o Business.
403 Prohibido
No hay créditos disponibles
Su cuenta se ha quedado sin créditos API.
Solucione esto en gamma.app/settings/billing:
Active la recarga automática (recomendado).
Compre créditos ad hoc.
Actualice a un plan de nivel superior.
404 No encontrado
ID de generación o gamma inválido
El ID de generación no existe o pertenece a otro usuario. Este error también se devuelve para un ID de gamma al que no puede acceder al leer, editar o exportar un gamma existente.
Verifique que está usando el generationId correcto de la respuesta POST, o que tiene acceso al gamma que está apuntando.
422 Fallido
La generación no pudo completarse
La generación produjo una salida vacía.
Revise su solicitud:
Asegúrese de que
inputTexttenga contenido suficiente.Verifique que los parámetros coincidan con su entrada.
Simplifique instrucciones complejas si es necesario.
429 Demasiadas solicitudes
Límite de tasa excedido
Ha alcanzado el límite de tasa. Los límites se establecen por propietario de clave API y por workspace, y los valores actuales están documentados en la referencia de códigos de error.
🔷 Nota: La API tiene una capacidad generosa. La mayoría de los usuarios nunca encuentran este límite en el uso normal.
Soluciones:
Contacte a Gamma Support para mayor capacidad.
Implemente retroceso exponencial.
Distribuya las solicitudes a lo largo del tiempo.
500 Error interno del servidor
Error inesperado del servidor
Ocurrió un problema temporal en el servidor.
Espere un momento y vuelva a intentarlo.
Si persiste, contacte al soporte con su
x-request-id.
502 Puerta de enlace incorrecta
Problema temporal de la puerta de enlace
Ocurrió un problema temporal de conexión.
Espere un momento y vuelva a intentar su solicitud.
Mi presentación generada por API no está en mi lista de Gammas
Las presentaciones generadas por API aparecen en la sección API Generated del panel de Gamma, no en su lista principal de Gammas (Todas, Vistas Recientemente o Creadas por Usted). Esto es un comportamiento esperado, y renombrar la presentación no cambia cómo se categoriza.
Solución alternativa: Abra la presentación y seleccione Duplicar. La copia se trata como un gamma creado en la web y aparecerá en su lista principal de Gammas.
¿Aún necesita ayuda?
Soporte general: Cómo contactar al soporte de Gamma.
Comunidad API: Únase al Slack de Gamma API.
Problemas de SSO: Contacte al administrador de TI de su organización.