O que é a Gamma API?
Tem uma apresentação que você adora? E se você pudesse criar mais 100 iguais, personalizadas para diferentes públicos ao redor do mundo?
A Gamma Generate API permite criar apresentações, documentos, páginas da web e posts sociais programaticamente sem usar o app Gamma diretamente. Isso é perfeito para usuários que querem automatizar seus workflows usando ferramentas como Zapier, Make ou n8n, integrar a geração de apresentações bonitas em suas próprias aplicações ou criar apresentações em escala por meio da integração de código backend.
E se você é um desenvolvedor, pode integrar o Gamma em sua aplicação para dar superpoderes de design a ela!
💎 Dica Profissional: Qualquer pessoa com uma conta Pro ou superior pode acessar a API hoje com limites generosos de uso.
A API está pronta?
A Gamma API v1.0 está Geralmente Disponível (GA) desde 5 de novembro de 2025. Qualquer pessoa com uma conta Pro ou superior pode acessar a API hoje com limites generosos de uso.
🔷 Nota: A API v0.2 está obsoleta e será descontinuada em 16 de janeiro de 2026. Se você está usando a v0.2, por favor migre para a v1.0 antes dessa data.
Para informações detalhadas sobre parâmetros específicos da API e como eles afetam a geração de apresentações, consulte nossa documentação da API.
Como faço para obter acesso?
Para acessar a Gamma API, siga estes passos.
Passo 1: Atualize sua conta
Você deve ter uma conta Gamma Pro, Ultra, Team ou Business. Se você ainda não é um usuário Pro ou superior, faça upgrade para Pro para acessar a API.
Passo 2: Gerar uma chave API
Navegue até Configurações e Membros na sua conta Pro, depois vá para a aba API key. Clique em Criar chave API para gerar sua chave, depois copie e armazene sua chave API com segurança.
🔷 Nota: As chaves API usam o formato sk-gamma-xxxxxxxx e devem ser passadas usando o cabeçalho X-API-KEY (não no formato Bearer token).
💎 Dica Profissional: Comece a usar a API com suas ferramentas de automação favoritas ou integre diretamente no seu código backend. A URL base é https://public-api.gamma.app/v1.0/
Posso autenticar com OAuth em vez de uma chave API?
Você pode autenticar com a Gamma REST API usando OAuth 2.0 em vez de uma chave API estática. OAuth permite conectar a Gamma API a uma aplicação sem criar ou armazenar uma chave API de longa duração, o que é útil para integrações e apps parceiros. Chaves API estáticas ainda são totalmente suportadas, então você pode continuar usando o cabeçalho X-API-KEY se preferir. Para configurar OAuth, siga o guia Authenticate with OAuth na documentação para desenvolvedores em developers.gamma.app/get-started/authenticate-with-oauth.
Uso e Limites de Taxa
Limites atuais da API
A API do Gamma é construída para escalar conforme suas necessidades. Seja gerando algumas apresentações ou centenas, você deve conseguir criar conforme suas necessidades de uso sem encontrar limites durante o uso normal.
🌀 Insight: Se você encontrar limitação de taxa (erros HTTP 429), entre em contato com nossa equipe de suporte. Trabalharemos com você para garantir que a API suporte o que você está construindo!
O que há de novo na v1.0?
A API v1.0 inclui vários recursos poderosos novos:
Formato de página web: Gere páginas web além de apresentações, documentos e posts sociais.
Personalização de cabeçalhos e rodapés: Personalize os cabeçalhos e rodapés do seu conteúdo.
URLs de imagens na entrada: Referencie imagens diretamente no seu conteúdo.
Organização em pastas: Organize o conteúdo gerado em pastas.
Compartilhamento por email: Compartilhe conteúdo por email programaticamente.
APIs de listagem: Novos endpoints para listar seus Temas e Pastas.
Pesquisar gammas: Pesquise os títulos e o texto completo dos gammas que você pode acessar, e filtre os resultados antes de abri-los.
Melhores limites de entrada: Até 100.000 tokens (cerca de 400.000 caracteres).
🌀 Insight: Conforme a API evolui, continuaremos adicionando mais opções para modificar e remixar Gammas programaticamente.
Posso gerar imagens independentes com a API?
Agora você pode gerar imagens independentes com a Gamma Generate API e através do Model Context Protocol (MCP). Isso permite criar imagens individuais programaticamente, separadas da geração de uma apresentação, documento ou página web completa. Para gerar imagens pela API ou MCP, siga o guia Create image generation na documentação para desenvolvedores em developers.gamma.app/images/create-image-generation. A geração de imagens via MCP está disponível no Claude e outros clientes MCP hoje; ainda não está disponível no ChatGPT.
Posso pesquisar meus gammas com a API ou MCP?
Você pode pesquisar toda sua biblioteca de gammas pela Gamma API ou através de um assistente de IA conectado ao Gamma com o Model Context Protocol (MCP), um padrão aberto que permite que assistentes de IA se conectem a ferramentas como Gamma. A pesquisa abrange tanto os títulos quanto o texto completo de cada gamma que você tem acesso, e classifica os resultados por relevância para que a correspondência mais próxima apareça primeiro. Cada resultado inclui um link direto, para que você possa abrir o gamma diretamente da resposta.
Você pode refinar sua pesquisa por quem criou o gamma e por quando ele foi atualizado pela última vez. Gammas arquivados são excluídos por padrão, e você pode optar por incluí-los.
🔷 Nota: A pesquisa está sendo implementada gradualmente, então ainda não está disponível em todos os workspaces. Se o endpoint de pesquisa ou a ferramenta de pesquisa MCP não funcionar para você, seu workspace ainda não recebeu essa funcionalidade.
Para a lista completa de parâmetros de pesquisa e exemplos de requisições, siga o guia Search gammas na documentação para desenvolvedores em developers.gamma.app/management/search-gammas.
Para que posso usar a API?
Aproveite a Gamma API para plataformas de automação como Make, Zapier, Workato e outras ferramentas de workflow. Você também pode construir aplicações personalizadas com integração direta no código backend para alimentar seus próprios apps, gerar apresentações em massa criando múltiplas apresentações programaticamente ou criar conteúdo personalizado em escala.
🔷 Nota: Seu inputText deve conter o conteúdo real que você quer nos seus slides, não instruções sobre como criar a apresentação. Temas devem ser pré-criados no Gamma e referenciados pelo ID. Eles não podem ser criados através do inputText.
Suporte a Modelos
Como "templates" significa coisas diferentes para usuários diferentes, aqui está o que está disponível.
Temas visuais: Você pode definir o visual das suas apresentações criando Temas customizados no Gamma, depois referenciando-os na API usando o ID do tema. Use a List Themes API (GET /v1.0/themes) para obter os IDs de temas disponíveis.
Modelos de estrutura de conteúdo: Estamos trabalhando para adicionar suporte estrito à estrutura de conteúdo em atualizações futuras.
Obtendo Ajuda e Suporte
Documentação e Recursos
Para referência técnica completa, visite a documentação API Reference. Você também pode revisar nossa Landing Page para uma visão geral e guia de início rápido. O acesso à API está incluído nas assinaturas Pro, Ultra, Teams e Business.
Ajuda para Depuração
Quando precisar de ajuda com problemas da API, consulte nossa documentação de erros para problemas comuns e soluções, depois entre em contato com o Suporte ao Cliente. Sempre inclua o x-request-id da sua resposta da API ao solicitar ajuda.
Toda resposta da API inclui este identificador único nos cabeçalhos. Para usuários Make.com, encontre-o em Output → Bundle → Headers. Para Zapier, verifique a seção Run Details → Data Out no Histórico de Tarefas para execuções bem-sucedidas, ou a aba Logs → Response information (expanda os cabeçalhos) para requisições falhas.
💎 Dica Profissional: Sempre inclua seu ID de requisição, a mensagem exata de erro e um exemplo do corpo da requisição ao solicitar suporte.
Escopo do Suporte
Podemos Ajudar Com
Podemos ajudar com problemas específicos da API Gamma, autenticação e problemas com chave API, entendimento de mensagens de erro, dúvidas sobre limite de requisições e uso de créditos.
Não Podemos Ajudar Com
Não podemos depurar ou escrever código personalizado, construir fluxos completos no Zapier, Make ou N8N, depurar aplicações personalizadas, fornecer orientações sobre o uso do Zapier, Make ou N8N, ou projetar arquitetura personalizada.
Ao solicitar ajuda com a API, por favor forneça seu ID de requisição, mensagem de erro, exemplo do corpo da requisição e qual plataforma de automação você está usando.
Códigos de Erro Comuns
401 Unauthorized: Chave API inválida. Certifique-se de usar o cabeçalho X-API-KEY (não Authorization ou Bearer).
403 Forbidden: Verifique seu saldo de créditos e certifique-se de que a recarga automática está ativada.
429 Too Many Requests: Você atingiu o limite de requisições. Contate o suporte Slack para opções de maior capacidade.
422 Failed: A geração não pôde ser concluída. Verifique seus parâmetros de entrada.
Precisa de Ajuda para Começar?
Para solução básica de problemas e questões comuns da API, consulte nosso guia abrangente de solução de problemas. Você também pode revisar nossa documentação completa para desenvolvedores para referência detalhada da API e exemplos.
FAQs e Problemas Comuns
Posso compartilhar minhas chaves API com outras pessoas?
As chaves API devem ser mantidas seguras e não compartilhadas.
Gere chaves separadas para diferentes casos de uso, se necessário.
Por que não consigo copiar minha chave API novamente?
Por razões de segurança, as chaves API são exibidas apenas uma vez quando geradas.
Se você perder sua chave, precisará gerar uma nova.
Posso gerar múltiplas chaves API?
Sim, você pode criar múltiplas chaves API para diferentes projetos ou casos de uso através das configurações da sua conta.
Quais gammas aparecem nos resultados de busca da API ou MCP?
A busca retorna apenas gammas aos quais você já tem acesso, então nunca expõe conteúdo que você não pode abrir no Gamma.
Os resultados são classificados por relevância, com a correspondência mais próxima da sua consulta primeiro.
Gammas arquivados são excluídos, a menos que você escolha incluí-los.
Você também pode filtrar por criador e pela última atualização do gamma.
Por que a busca não funciona no meu workspace?
A busca em seus gammas está sendo implementada gradualmente e ainda não está habilitada para todos os workspaces.
Se não estiver disponível, contate o Suporte ao Cliente e inclua seu
x-request-idpara que possamos verificar seu workspace.
Preciso migrar da v0.2 para a v1.0?
Sim, a v0.2 será descontinuada em 16 de janeiro de 2026.
A migração é simples: Atualize sua URL base de
/v0.2/para/v1.0/.Altere o parâmetro
themeNameparathemeId(obtenha IDs da API List Themes).Atualize os limites de entrada - a v1.0 usa 100k tokens em vez de 750k caracteres.
Consulte a documentação da API para detalhes completos do endpoint v1.0.
Quais são as principais diferenças entre a v0.2 e a v1.0?
A v1.0 oferece limites de taxa muito mais generosos (centenas por hora vs. 50 por dia).
A v1.0 inclui suporte ao formato de página web.
Melhores limites de entrada (100k tokens vs. 750k caracteres).
Organização de Pastas e List APIs para Temas e Pastas.
O que acontece se eu ficar sem créditos?
Ative a recarga automática nas suas configurações de cobrança em gamma.app/settings/billing para garantir acesso ininterrupto à API.
Onde as apresentações geradas pela API aparecem no painel do Gamma?
As apresentações criadas via API aparecem na seção API Generated do painel do Gamma, não na sua lista principal de Gammas (Todos, Visualizados Recentemente ou Criados por Você).
Para fazer uma apresentação gerada pela API aparecer na sua lista regular de Gammas, abra-a e selecione Duplicar. A duplicata é tratada como um gamma criado na web padrão e aparecerá em todas as visualizações habituais.