O que é a Gamma API?
Tem uma apresentação que você adora? E se 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. É perfeita para usuários que querem automatizar seus fluxos de trabalho usando ferramentas como Zapier, Make ou n8n, integrar a geração de apresentações bonitas em seus próprios aplicativos ou criar apresentações em escala via integração de código backend.
E se você é um desenvolvedor, pode integrar o Gamma ao seu aplicativo para dar superpoderes de design a ele!
💎 Dica Profissional: Qualquer pessoa pode acessar a API hoje em qualquer plano, incluindo o Free, 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 pode acessar a API hoje em qualquer plano com limites generosos de uso.
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: Gerar uma chave API
Navegue até Configurações and Membros na sua conta, depois vá para a aba API key. Clique em Criar API key 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 um aplicativo sem criar ou armazenar uma chave API de longa duração, ú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 da Gamma é construída para escalar conforme suas necessidades. Seja gerando poucas ou centenas de apresentações, você deve conseguir criar conforme suas necessidades de uso sem enfrentar 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 a API pode fazer
A Gamma API cobre todo o ciclo de vida de um gamma, desde a criação até a exportação.
Gerar conteúdo: Crie apresentações, documentos, páginas da web e posts sociais a partir do seu próprio texto.
Criar a partir de modelo: Gere novos gammas a partir de um modelo que você criou no Gamma, mantendo seu layout e estrutura de cartões.
Editar gammas existentes: POST /v1.0/agent/gammas/{gammaId}/edits aplica uma alteração em linguagem natural a uma página.
Geração por agente: POST /v1.0/agent/generations inicia uma geração a partir de um modelo de workspace, um gamma existente ou um modelo oficial Gamma.
Ler, exportar e analisar gammas existentes: Endpoints para obter, comentários, exportar e análises.
Geração de imagem independente: Gere imagens individuais separadamente de um gamma completo.
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: 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.
Limites generosos de entrada: Até 100.000 tokens (cerca de 400.000 caracteres).
Posso gerar imagens independentes com a API?
Você pode gerar imagens independentes com a Gamma API e através do Model Context Protocol (MCP). Isso permite criar imagens individuais programaticamente, separadamente da geração de uma apresentação, documento ou página web completa. Para gerar imagens via API ou MCP, siga o guia Create image generation na documentação para desenvolvedores. A geração de imagens via MCP está disponível no Claude, ChatGPT e outros clientes MCP.
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 títulos e texto completo de cada gamma que você tem acesso, e classifica os resultados por relevância para que a melhor correspondência apareça primeiro. Cada resultado inclui um link direto para abrir o gamma diretamente da resposta.
Você pode refinar sua pesquisa por quem criou o gamma e por quando foi atualizado pela última vez. Gammas arquivados são excluídos por padrão, mas você pode optar por incluí-los.
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 fluxo de trabalho. Você também pode construir aplicativos personalizados 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 por ID. Eles não podem ser criados via 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 e a sensação das suas apresentações criando temas personalizados no Gamma e, em seguida, 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: Use Create from template. Crie um modelo no Gamma e depois chame POST /v1.0/generations/from-template com seu ID e um prompt. O layout e a estrutura dos cartões do modelo são mantidos por padrão, e seu prompt altera o conteúdo, público ou idioma. Modelos devem ser gammas de página única do seu workspace (uma página pode conter muitos cartões). Encontre IDs de modelos com GET /v1.0/templates/search.
Geração de agente: POST /v1.0/agent/generations também pode começar a partir de um modelo do workspace, um gamma existente ou um modelo oficial do Gamma (templateId).
Obtendo Ajuda e Suporte
Documentação e recursos
Para referência técnica completa, visite a documentação do desenvolvedor. O acesso à API está incluído em todos os planos, incluindo o Free.
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 pedir ajuda.
Toda resposta da API inclui esse identificador único nos cabeçalhos. Para **Make.com users**, 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 solicitações falhadas.
💎 Dica Profissional: Sempre inclua seu ID de solicitação, a mensagem exata de erro e um exemplo do corpo da solicitação ao pedir suporte.
Escopo do Suporte
Podemos Ajudar Com
Podemos ajudar com problemas específicos da API do Gamma, problemas de autenticação e chave de API, entendimento de mensagens de erro, dúvidas sobre limite de taxa e uso de créditos.
Não Podemos Ajudar Com
Não podemos depurar ou escrever código personalizado, construir fluxos de trabalho 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, forneça seu ID de solicitação, mensagem de erro, exemplo do corpo da solicitação e qual plataforma de automação você está usando.
Códigos de Erro Comuns
401 Unauthorized: Chave de 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 taxa. Contate o suporte do Slack para opções de capacidade maior.
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 problemas 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 & Problemas Comuns
Posso editar um gamma existente com a API?
Sim.
POST /v1.0/agent/gammas/{gammaId}/editsaplica uma instrução em linguagem natural a uma página de um gamma que você pode editar, por exemplo, "atualize o cartão de preços com os novos níveis."Faça polling com
GET /v1.0/agent/edits/{editId}para obter o resultado.Edições não podem adicionar páginas, e apenas uma edição é executada por página por vez.
A mesma capacidade está disponível no Claude, ChatGPT, Slack e outros clientes MCP.
Meu próprio agente de IA pode usar o Gamma?
Sim. Conecte qualquer cliente MCP a
https://mcp.gamma.app/mcpe faça login com sua conta Gamma. Funciona em todos os planos.Clientes personalizados precisam registrar primeiro seus URIs de redirecionamento OAuth.
Posso compartilhar minhas chaves de API com outras pessoas?
As chaves de API devem ser mantidas seguras e não compartilhadas.
Gere chaves separadas para diferentes casos de uso, se necessário.
Por que não posso copiar minha chave de API novamente?
Por razões de segurança, as chaves de API são exibidas apenas uma vez quando geradas.
Se você perder sua chave, precisará gerar uma nova.
Posso gerar várias chaves de API?
Sim, você pode criar várias chaves de API para diferentes projetos ou casos de uso através das configurações da sua conta.
Quais gammas aparecem nos resultados de pesquisa da API ou MCP?
A pesquisa 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 por quando um gamma foi atualizado pela última vez.
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, entre em contato com o Customer Support e inclua seu
x-request-idpara que possamos verificar seu workspace.Editor: delete esta FAQ se a busca estiver confirmada em 100%.
O que acontece se eu ficar sem créditos?
Ative o auto-recharge nas suas configurações de billing em gamma.app/settings/billing para garantir acesso ininterrupto à API.
Onde as apresentações geradas pela API aparecem no dashboard do Gamma?
Apresentações criadas via API aparecem na seção API Generated do dashboard do Gamma, não na sua lista principal de Gammas (All, Recently Viewed, ou Created by You).
Para fazer uma apresentação gerada pela API aparecer na sua lista regular de Gammas, abra-a e selecione Duplicate. A duplicata é tratada como um gamma criado na web padrão e aparecerá em todas as visualizações habituais.