Guia de Solução de Problemas da API Gamma
Embora adoraríamos ajudar com tudo relacionado à API, lembre-se que nossa equipe de suporte não pode criar fluxos de trabalho, depurar seu código backend (FastAPI, Express, Django, etc.) ou solucionar problemas específicos da plataforma.
Podemos ajudar com perguntas específicas da Gamma sobre nossos endpoints e parâmetros, autenticação da API, solução de erros, créditos e verificação se sua solicitação corresponde à nossa documentação.
Para ajuda específica da plataforma, entre em contato com Zapier Support, Make Support ou N8N Support.
Para mais informações sobre a API da Gamma, veja: developers.gamma.app
Códigos de erro comuns
400 Bad Request
Parâmetros inválidos
Verifique sua solicitação para:
Campos obrigatórios ausentes (
inputText,textMode).Valores de parâmetros inválidos.
Limites de caracteres ou tokens excedidos.
Para
from-template: o modelo deve ser um workspace gamma de página única. Modelos oficiais Explore e gammas de múltiplas páginas são rejeitados.
Revise a mensagem de erro para detalhes específicos da validação.
401 Unauthorized
Chave API inválida
Sua chave API é inválida ou não está associada a uma conta Pro.
Verifique se você está usando o cabeçalho
X-API-KEY(não Authorization).Gere uma nova chave API em gamma.app/settings/api-keys.
Confirme que sua conta possui um plano ativo Pro, Ultra, Teams ou Business.
403 Forbidden
Sem créditos disponíveis
Sua conta ficou sem créditos de API.
Corrija isso em gamma.app/settings/billing:
Ative a recarga automática (recomendado).
Compre créditos avulsos.
Faça upgrade para um plano de nível superior.
404 Not Found
ID de geração ou gamma inválido
O ID de geração não existe ou pertence a outro usuário. Esse erro também é retornado para um ID gamma que você não pode acessar ao ler, editar ou exportar um gamma existente.
Verifique se você está usando o generationId correto da resposta POST, ou se tem acesso ao gamma que está tentando acessar.
422 Failed
A geração não pôde ser concluída
A geração produziu saída vazia.
Revise sua solicitação:
Garanta que
inputTexttenha conteúdo suficiente.Verifique se os parâmetros estão alinhados com sua entrada.
Simplifique instruções complexas, se necessário.
429 Too Many Requests
Limite de taxa excedido
Você atingiu o limite de taxa. Os limites são definidos por proprietário da chave API e por workspace, e os valores atuais estão documentados na referência de códigos de erro.
🔷 Nota: A API tem capacidade generosa. A maioria dos usuários nunca encontra esse limite no uso normal.
Soluções:
Entre em contato com Gamma Support para maior capacidade.
Implemente backoff exponencial.
Distribua as solicitações ao longo do tempo.
500 Internal Server Error
Erro inesperado no servidor
Ocorreu um problema temporário no servidor.
Aguarde um momento e tente novamente.
Se persistir, entre em contato com o suporte com seu
x-request-id.
502 Bad Gateway
Problema temporário no gateway
Ocorreu um problema temporário de conexão.
Aguarde um momento e tente sua solicitação novamente.
Minha apresentação gerada pela API não está na minha lista de Gammas
Apresentações geradas pela API aparecem na seção API Generated do painel Gamma, não na sua lista principal de Gammas (Todas, Visualizadas Recentemente ou Criadas por Você). Isso é comportamento esperado, e renomear a apresentação não altera sua categorização.
Solução alternativa: Abra a apresentação e selecione Duplicar. A duplicata é tratada como um gamma criado na web e aparecerá na sua lista principal de Gammas.
Ainda precisa de ajuda?
Suporte Geral: Como contatar o suporte Gamma.
Comunidade API: Participe do Gamma API Slack.
Problemas com SSO: Contate o administrador de TI da sua organização.