2Slides Team
14 min read
Casos de Uso da API de Apresentação com IA: 12 Receitas de Automação por Equipe (2026)
Uma API de apresentação com IA transforma um gatilho (uma nova linha no CRM, um cron de segunda-feira, uma planilha curricular, um documento clínico aprovado) em um deck finalizado sem que ninguém precise abrir o PowerPoint. Este hub mapeia 12 receitas de produção para as equipes que as executam: Vendas, Customer Success, Marketing, Conteúdo, Educação, Saúde, Consultoria, E-commerce, Finanças, RH e equipes de engenharia que constroem agentes de IA. Cada receita usa os mesmos 7 endpoints da API 2Slides, custa um valor previsível de 10 créditos por página PPTX editável (cerca de $0,025) ou de 100 a 200 créditos por página com design por imagem, e funciona com Zapier, Make, n8n, Python ou Node simples, e agentes de código via MCP.
Divulgação: 2Slides é nosso produto. Quando outro fornecedor cobre uma receita, indicamos isso. A página da API da Gamma publica um conjunto similar de receitas de automação (carrosséis Make + Claude, decks de onboarding n8n + HubSpot, propostas Zapier + Sheets); as diferenças no nível de desenvolvedor entre as duas APIs estão em Gamma Generate API vs 2Slides API.
Principais pontos
- Toda receita abaixo se reduz a um padrão: gatilho → construir um prompt a partir de dados estruturados →
POSTpara um dos três endpoints de geração → consultarGET /api/v1/jobs/{id}a cada 5 a 10 segundos → entregar o arquivo. - Decks PPTX editáveis custam 10 créditos por página; uma proposta de 10 páginas custa cerca de $0,25 no nível de $5 por 2.000 créditos e $0,20 no nível de 40.000 créditos.
- Decks com design por imagem (direção de arte personalizada ou combinação de marca a partir de uma imagem de referência) custam 10 créditos de planejamento mais 100 créditos por página no nível 2K, e podem ser narrados por 210 créditos por página e exportados como MP4.
- As chaves da API são emitidas para qualquer conta com 500 créditos grátis, então uma prova de conceito não custa nada; os limites de taxa são 6 requisições por minuto por chave nos endpoints de geração e 10 por minuto na consulta de jobs.
- As mesmas 7 operações são expostas como servidor MCP e como Agent Skill, então uma sessão Claude Code ou Codex pode executar qualquer receita interativamente antes de automatizá-la.
Para quem é este conteúdo
Este hub é para engenheiros de operações, líderes de RevOps e marketing ops, desenvolvedores edtech e health-tech, e equipes de agências que já geram o conteúdo dos decks a partir de dados e querem eliminar a etapa manual de design. Se você faz um deck por semana manualmente, o app web em 2slides.com/fast-ppt é mais rápido que uma integração; a API compensa quando os decks são repetitivos, personalizados ou acionados por tempo.
As 12 receitas em resumo
| # | Equipe | Gatilho | Endpoint(s) | Saída | Custo por deck de 10 páginas | Receita |
|---|---|---|---|---|---|---|
| 1 | Conteúdo | Nova linha em planilha de tópicos ou banco de dados Notion | create-pdf-slides (4:5 ou 9:16), opcional generate-narration | PDF carrossel + PNG por página, MP4 opcional | ~1.010 créditos ($2,53) | Automatizar carrosséis para redes sociais |
| 2 | Vendas | Nova linha de prospect em Google Sheets ou exportação CRM | themes/search + generate | Proposta PPTX editável por conta | 100 créditos ($0,25) | Propostas de vendas personalizadas em escala |
| 3 | Vendas | Mudança de estágio de negócio no HubSpot | generate (assíncrono) | Pitch deck PPTX editável anexado ao negócio | 100 créditos ($0,25) | Automação de decks de vendas HubSpot |
| 4 | Customer Success | Webhook Closed Won; agendamento dia 85 | generate; opcional create-like-this para combinação de marca | Decks de kickoff onboarding, revisão de 90 dias | 100 créditos ($0,25) | Automatizar decks de onboarding de clientes |
| 5 | Marketing | Cron de segunda-feira em métricas de campanha | create-pdf-slides → generate-narration → download-slides-pages-voices | Deck de resumo + MP4 narrado com dois locutores | ~3.110 créditos ($7,78) | Decks de relatório de marketing e vídeos narrados |
| 6 | Finanças / Operações | Dados de relatório semanal em Sheets | generate via Zapier | Relatório semanal PPTX editável | 100 créditos ($0,25) | Relatórios semanais em slides com Zapier |
| 7 | Educação | Planilha curricular ou exportação LMS | generate por aula; caminho de aula narrada opcional | PPTX de aula por turma e idioma; vídeo aulas | 100 créditos ($0,25) por aula | Gerar slides de aula programaticamente |
| 8 | Educação / Idiomas | Lista de palavras por nível | generate em lote | 100 decks de vocabulário | 10.000 créditos ($22,50) para 100 decks | Gerar decks de vocabulário em lote |
| 9 | Saúde | Documento fonte aprovado e desidentificado | generate por condição e idioma; create-pdf-slides + narração para treinamento de equipe | Decks de educação do paciente em 20+ idiomas; vídeos narrados para serviço | 100 créditos ($0,25) por deck de paciente | Automação de slides de educação para pacientes |
| 10 | Consultoria / Pesquisa | Formulário de tema ou agenda | Tavily ou Exa → LLM → generate ou create-pdf-slides | Briefing de 12 slides com fontes | 120 créditos ($0,30) editável; ~1.210 créditos design por imagem | Pipeline de pesquisa para deck |
| 11 | E-commerce | Novo SKU ou lançamento sazonal no catálogo | generate para sell sheets; create-like-this com visual da campanha | Deck para varejista + deck de lançamento com marca | 100 créditos ($0,25) / ~1.010 créditos ($2,53) | Catálogo de produtos para decks de vendas |
| 12 | Engenharia / Agentes de IA | Prompt em Claude Code, Codex, Cursor ou agente customizado | Ferramentas MCP themes_search → slides_generate (mesma API, mesmos créditos) | Qualquer um dos acima, interativamente | Igual ao endpoint usado | Agent Skills vs MCP servers |
Os valores de custo usam o nível de $5 por 2.000 créditos ($0,0025 por crédito). O pacote de 40.000 créditos reduz para $0,002 por crédito. Decks com design por imagem assumem resolução 2K e 10 páginas; 4K dobra a cobrança por página para 200 créditos.
Como cada receita é estruturada
Authorization: Bearer <key>; as chaves são criadas na aba API Keys e devem ficar no servidor.
Todas as 12 receitas compartilham quatro partes móveis.
1. Um gatilho com dados estruturados. Uma linha de planilha, um payload webhook do CRM, um job cron que consulta um data warehouse, ou um documento aprovado. A qualidade do deck é limitada pela qualidade dessa entrada, então a maioria das equipes dedica mais tempo ao template do prompt do que à chamada da API.
2. Um prompt construído a partir desses dados. Ou você formata os campos num resumo você mesmo (Company: Acme. Industry: logistics. Pain points: ...) ou usa um LLM para escrever um esboço slide a slide primeiro. Ambos funcionam; o passo do LLM importa mais quando a fonte é não estruturada (notas de pesquisa, transcrições de chamadas).
3. Um dos três endpoints de geração.
| Endpoint | O que gera | Melhor para | Créditos |
|---|---|---|---|
POST /api/v1/slides/generate | PPTX nativo e editável a partir de um dos 1.500+ templates (themeId) | Qualquer coisa que um humano editará depois: propostas, relatórios, decks de aula | 10 por página |
POST /api/v1/slides/create-pdf-slides | Slides com design por imagem a partir de prompt designStyle; 512px a 4K; qualquer proporção | Saída visual prioritária: carrosséis, decks de lançamento, fonte para vídeo | 10 + 100 por página (2K) |
POST /api/v1/slides/create-like-this | Igual, mas o design inteiro é derivado de referenceImageUrl | Combinação estrita de marca em centenas de decks | 10 + 100 por página (2K) |
responseLanguage aceita o nome do idioma como "Spanish" e padrão é Auto.
4. Consultar e entregar. O Fast PPT generate roda síncrono por padrão e retorna uma URL de download numa única chamada, o que é conveniente em scripts. Para lotes, passe mode: "async", armazene o jobId junto ao registro que o disparou, e consulte GET /api/v1/jobs/{id} até que status seja success ou failed. A entrega é o que seu stack já faz: enviar o PPTX por email, postar no Slack, salvar no Drive, anexar ao registro CRM.
Um worker Node.js mínimo que toda receita pode reutilizar:
const API = "https://2slides.com/api/v1";
const headers = {
Authorization: `Bearer ${process.env.SLIDES_API_KEY}`,
"Content-Type": "application/json",
};
async function generateDeck({ userInput, themeId, responseLanguage = "Auto" }) {
const res = await fetch(`${API}/slides/generate`, {
method: "POST",
headers,
body: JSON.stringify({ userInput, themeId, responseLanguage, mode: "async" }),
});
const { jobId } = await res.json();
for (let i = 0; i < 60; i++) {
await new Promise((r) => setTimeout(r, 8000));
const job = await (await fetch(`${API}/jobs/${jobId}`, { headers })).json();
if (job.status === "success") return job.downloadUrl;
if (job.status === "failed") throw new Error(`Job ${jobId} failed`);
}
throw new Error(`Job ${jobId} timed out`);
}Mantenha uma fila na frente dessa função: os endpoints de geração permitem 6 requisições por minuto por chave, então 200 decks levam cerca de 35 minutos de tempo real, não 35 minutos do seu tempo.
Escolhendo o pipeline para um caso de uso
A pergunta recorrente em toda receita é "PPTX editável ou slides com design por imagem?" A resposta depende de quem vai mexer no deck depois.
| Situação | Escolha | Por quê |
|---|---|---|
| Um humano vai editar números, preços ou texto depois | generate (Fast PPT) | Caixas de texto reais e layouts no PPTX; 10 créditos por página |
| Centenas de decks devem ser idênticos a um slide de marca | create-like-this | O sistema de design é derivado da sua imagem de referência, não de um template |
| A saída é um carrossel, um post social ou um vídeo | create-pdf-slides | Controle de proporção (4:5, 9:16, 1:1) e exportação PNG por página |
| O deck será entregue como vídeo narrado | create-pdf-slides ou create-like-this → generate-narration | Narração e exportação MP4 só estão disponíveis nos pipelines com design por imagem |
| Você precisa do menor custo unitário possível em volume | generate | 100 decks de vocabulário de 10 páginas custam 10.000 créditos ($22,50) |
GET /api/v1/themes/search. Escolha um tema uma vez, fixe seu themeId, e todo deck gerado herda o design.
referenceImageUrl para create-like-this quando você quer um visual específico sem desenhar você mesmo.
Executando receitas a partir de um agente de IA em vez de uma ferramenta de workflow
Cada endpoint acima é também uma ferramenta MCP (slides_generate, slides_create_pdf_slides, slides_create_like_this, slides_generate_narration, slides_download_slides_pages_voices, themes_search, jobs_get) e as mesmas operações são empacotadas como SKILL.md para agentes de código. Na prática, equipes prototipam uma receita numa sessão Claude Code ou Codex ("buscar tema de consultoria, gerar briefing de 12 slides a partir desta pesquisa, em alemão") e só movem para n8n ou cron quando o prompt está estável.
As vantagens e desvantagens entre os dois estilos de integração são cobertas em Agent Skills vs MCP servers for presentations e a configuração específica do Claude em How to use Claude MCP to generate presentations.
Quanto custam as receitas em volume realista
| Equipe e volume | Pipeline | Créditos por mês | USD por mês (a $0,0025) |
|---|---|---|---|
| Vendas: 200 propostas × 10 páginas | generate | 20.000 | $50 (ou $42,50 com pacote de 20.000 créditos) |
| Customer Success: 60 decks onboarding + 60 de revisão × 10 páginas | generate | 12.000 | $30 |
| Marketing: 4 resumos semanais × 8 páginas, narrados | create-pdf-slides + narração | ~10.000 | $25 |
| Conteúdo: 30 carrosséis × 7 páginas em 2K | create-pdf-slides | 21.300 | $53 |
| Educação: 40 aulas × 12 páginas | generate | 4.800 | $12 |
| Saúde: 25 condições × 8 páginas × 6 idiomas | generate | 12.000 | $30 |
Nenhuma assinatura é necessária para qualquer linha; o plano Pro opcional adiciona 10.000 créditos por mês para equipes que preferem uma conta fixa.
Armadilhas comuns em todas as receitas
- Limite de taxa. Seis requisições de geração por minuto por chave. Use fila e pausas; não tente repetir um 429 em loop apertado.
- Chaves no lugar errado. A chave da API deve ficar no seu servidor, nas credenciais do n8n, ou no passo webhook do Zapier, nunca no navegador ou numa planilha compartilhada.
- Narrar pipeline errado.
generate-narrationsó aceita jobs decreate-pdf-slidesoucreate-like-this. Decks Fast PPT não podem ser narrados. - Códigos de idioma.
responseLanguageaceita nome ("Japanese"), não "ja". - Entradas muito grandes. Resuma uma fonte de 40 páginas em um esboço de slides antes da geração; o deck só é tão claro quanto o resumo.
- Surpresas na contagem automática de páginas.
page: 0deixa o modelo escolher a quantidade de slides; passe um número fixo quando o template downstream espera um.
Perguntas Frequentes
Para que serve uma API de apresentação com IA?
Uma API de apresentação com IA é usada para gerar decks de slides a partir de dados estruturados ou texto sem design manual, acionada por eventos em outros sistemas. Os usos mais comuns são propostas de vendas personalizadas a partir de dados CRM, decks recorrentes de relatórios analíticos, decks de onboarding e treinamento, slides de aula por turma, e carrosséis sociais a partir de calendários de conteúdo.
Quais equipes se beneficiam mais da automação de apresentações?
Equipes que produzem muitos decks semelhantes se beneficiam mais: vendas e customer success (um deck por conta), marketing e agências (um relatório por cliente por semana), educação (um deck por aula ou idioma), e comunicação em saúde (um deck por condição por idioma). Equipes que fazem um deck sob medida por mês geralmente se dão melhor com o app web.
Preciso de Zapier, Make ou n8n para usar uma API de apresentação?
Não. Qualquer linguagem que possa enviar requisição HTTPS funciona, e o worker Node.js acima é completo. Zapier, Make e n8n são úteis quando o gatilho já está lá (linha Sheets, mudança de estágio HubSpot) e você quer o passo de entrega (email, Slack, Drive) sem escrever código.
Quanto custa gerar 100 apresentações com uma API?
Com a API 2Slides, 100 decks PPTX editáveis de 10 páginas custam 10.000 créditos, o que dá $22,50 no pacote de 10.000 créditos. Cem decks com design por imagem em 2K custam cerca de 101.000 créditos, aproximadamente $202 no preço do pacote de 40.000 créditos a $0,002 por crédito. Consulta de jobs, busca de temas e exportação por página são grátis.
Um agente de IA como Claude Code pode executar essas receitas?
Sim. As sete operações da API são expostas como servidor MCP (hospedado ou via npx -y 2slides-mcp@latest) e como Agent Skill, então Claude Code, Codex, Cursor e agentes similares podem buscar temas, gerar decks, adicionar narração e baixar resultados usando a mesma chave e créditos da API REST.
Próximos passos
- Crie uma chave API em 2slides.com/api; os 500 créditos grátis cobrem cerca de 50 páginas editáveis, suficiente para testar qualquer receita aqui.
- Comece pela receita mais próxima do seu gatilho: propostas de vendas a partir de Sheets, decks de onboarding a partir de Closed Won, ou slides de aula a partir de currículo.
- Para a comparação no nível de desenvolvedor com a API da Gamma e a referência completa de endpoints, leia Gamma Generate API vs 2Slides API e Melhor API de apresentação com IA para desenvolvedores.
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
