Guia de Solução de Problemas da API Gamma

Embora adoraríamos ajudar com tudo relacionado à API, lembre-se de que nossa equipe de suporte não pode criar fluxos de trabalho, depurar seu código backend (FastAPI, Express, Django, etc.) ou solucionar peculiaridades específicas 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 Suporte Zapier, Suporte Make ou Suporte N8N.

Para mais informações sobre a API da Gamma, veja: developers.gamma.app

Códigos de Erro Comuns

400 Solicitação Inválida

Parâmetros inválidos

Verifique sua solicitação para:

Campos obrigatórios ausentes (inputText, textMode)
Valores de parâmetros inválidos
Limites de caracteres/tokens excedidos

Revise a mensagem de erro para detalhes específicos de validação.

401 Não Autorizado

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)
Gerar uma nova chave API em gamma.app/settings/billing
Confirme que sua conta possui um plano Pro, Ultra, Teams ou Business ativo

403 Proibido

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 Não Encontrado

ID de geração inválido

O ID de geração não existe ou pertence a outro usuário.

Verifique se você está usando o generationId correto da resposta POST.

422 Falha

A geração não pôde ser concluída

A geração produziu saída vazia.

Revise sua solicitação:

Garanta que inputText tenha conteúdo suficiente
Verifique se os parâmetros estão alinhados com sua entrada
Simplifique instruções complexas, se necessário

429 Muitas Solicitações

Limite de taxa excedido

Você atingiu o limite de taxa (50 gerações/hora).

Nota: A API tem capacidade generosa. A maioria dos usuários nunca encontra esse limite no uso normal.

Soluções:

Entre em contato com Suporte Gamma para maior capacidade
Implemente backoff exponencial
Distribua as solicitações ao longo do tempo

500 Erro Interno do Servidor

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 Gateway Ruim

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 — 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 Slack da Gamma API
Problemas com SSO: Contate o administrador de TI da sua organização