2Slides Team
13 min read
Casi d'Uso dell'API per Presentazioni AI: 12 Ricette di Automazione per Team (2026)
Un'API per presentazioni AI trasforma un trigger (una nuova riga CRM, un cron di lunedì, un foglio di curriculum, un documento clinico approvato) in un deck finito senza che nessuno apra PowerPoint. Questo hub mappa 12 ricette di produzione ai team che le eseguono: Sales, Customer Success, Marketing, Content, Education, Healthcare, Consulting, E-commerce, Finance, HR e team di ingegneria che costruiscono agenti AI. Ogni ricetta usa gli stessi 7 endpoint della 2Slides API, costa prevedibilmente 10 crediti per pagina PPTX modificabile (circa $0.025) o 100-200 crediti per pagina con design immagine, e funziona con Zapier, Make, n8n, Python o Node plain, e agenti di coding via MCP.
Dichiarazione: 2Slides è il nostro prodotto. Dove un altro fornitore copre una ricetta, lo indichiamo. La pagina API di Gamma pubblica un set simile di ricette di automazione (Make + caroselli Claude, n8n + onboarding HubSpot, Zapier + proposte Sheets); le differenze a livello sviluppatore tra le due API sono in Gamma Generate API vs 2Slides API.
Punti chiave
- Ogni ricetta qui sotto si riduce a uno schema: trigger → costruire un prompt da dati strutturati →
POSTa uno dei tre endpoint di generazione → interrogareGET /api/v1/jobs/{id}ogni 5-10 secondi → consegnare il file. - I deck PPTX modificabili costano 10 crediti per pagina; una proposta di 10 pagine costa circa $0.25 al livello $5 per 2.000 crediti e $0.20 al livello 40.000 crediti.
- I deck con design immagine (direzione artistica personalizzata o matching brand da immagine di riferimento) costano 10 crediti di pianificazione più 100 crediti per pagina a 2K, possono essere narrati a 210 crediti per pagina ed esportati come MP4.
- Le chiavi API sono emesse su qualsiasi account con 500 crediti gratuiti, quindi un proof of concept non costa nulla; i limiti di richiesta sono 6 al minuto per chiave sugli endpoint di generazione e 10 al minuto sul polling dei job.
- Le stesse 7 operazioni sono esposte come server MCP e Agent Skill, così una sessione Claude Code o Codex può eseguire qualsiasi ricetta in modo interattivo prima di automatizzarla.
A chi è rivolto
Questo hub è per ingegneri operativi, responsabili RevOps e marketing ops, sviluppatori edtech e health-tech, e team di agenzie che già generano il contenuto dei deck da dati e vogliono eliminare il passaggio manuale del design. Se fai un deck a settimana a mano, l'app web su 2slides.com/fast-ppt è più veloce di un'integrazione; l'API conviene quando i deck sono ripetitivi, personalizzati o attivati da tempo.
Le 12 ricette a colpo d'occhio
| # | Team | Trigger | Endpoint(s) | Output | Costo per deck 10 pagine | Ricetta |
|---|---|---|---|---|---|---|
| 1 | Content | Nuova riga in un foglio topic o database Notion | create-pdf-slides (4:5 o 9:16), opzionale generate-narration | PDF carosello + PNG per pagina, MP4 opzionale | ~1.010 crediti ($2.53) | Automatizza caroselli social media |
| 2 | Sales | Nuova riga prospect in Google Sheets o esportazione CRM | themes/search + generate | Proposta PPTX modificabile per account | 100 crediti ($0.25) | Proposte di vendita personalizzate su scala |
| 3 | Sales | Cambio fase deal HubSpot | generate (async) | Pitch deck PPTX modificabile allegato al deal | 100 crediti ($0.25) | Automazione sales deck HubSpot |
| 4 | Customer Success | Webhook Closed Won; schedule giorno 85 | generate; opzionale create-like-this per matching brand | Deck kickoff onboarding, deck review 90 giorni | 100 crediti ($0.25) | Automatizza deck onboarding clienti |
| 5 | Marketing | Cron di lunedì su metriche campagna | create-pdf-slides → generate-narration → download-slides-pages-voices | Deck riepilogo + MP4 narrato con due speaker | ~3.110 crediti ($7.78) | Report marketing e video narrati |
| 6 | Finance / Ops | Dati report settimanale in Sheets | generate via Zapier | Report settimanale PPTX modificabile | 100 crediti ($0.25) | Report settimanali in slide con Zapier |
| 7 | Education | Foglio curriculum o esportazione LMS | generate per lezione; percorso opzionale con narrazione | PPTX lezione per classe e lingua; lezioni video | 100 crediti ($0.25) per lezione | Genera slide lezioni programmaticamente |
| 8 | Education / Language | Lista parole per livello | generate in batch | 100 deck vocabolario | 10.000 crediti ($22.50) per 100 deck | Genera batch di deck vocabolario |
| 9 | Healthcare | Documento sorgente approvato e de-identificato | generate per condizione e lingua; create-pdf-slides + narrazione per formazione staff | Deck educazione pazienti in 20+ lingue; video narrati in servizio | 100 crediti ($0.25) per deck paziente | Automazione slide educazione pazienti |
| 10 | Consulting / Research | Form argomento o schedule | Tavily o Exa → LLM → generate o create-pdf-slides | Brief di 12 slide con fonti | 120 crediti ($0.30) modificabile; ~1.210 crediti design immagine | Pipeline ricerca a deck |
| 11 | E-commerce | Nuovo SKU o lancio stagionale catalogo | generate per sell sheet; create-like-this con key visual campagna | Deck retailer + deck lancio brandizzato | 100 crediti ($0.25) / ~1.010 crediti ($2.53) | Catalogo prodotti a sales deck |
| 12 | Engineering / AI agents | Prompt in Claude Code, Codex, Cursor o agente custom | Strumenti MCP themes_search → slides_generate (stessa API, stessi crediti) | Qualsiasi di sopra, in modo interattivo | Stesso costo endpoint usato | Agent Skills vs MCP servers |
I costi usano il livello $5 per 2.000 crediti ($0.0025 per credito). Il pacchetto 40.000 crediti porta a $0.002 per credito. I deck con design immagine assumono risoluzione 2K e 10 pagine; 4K raddoppia il costo per pagina a 200 crediti.
Come è strutturata ogni ricetta
Authorization: Bearer <key>; le chiavi si creano nella tab API Keys e devono restare server-side.
Tutte le 12 ricette condividono quattro componenti.
1. Un trigger con dati strutturati. Una riga di foglio, un payload webhook CRM, un cron job che interroga un warehouse, o un documento passato in revisione. La qualità del deck dipende dalla qualità di questo input, quindi la maggior parte dei team dedica più tempo al template del prompt che alla chiamata API.
2. Un prompt costruito da quei dati. O formatti tu i campi in un brief (Company: Acme. Industry: logistics. Pain points: ...) oppure fai scrivere a un LLM una scaletta slide per slide. Entrambi funzionano; il passaggio LLM è più importante se la fonte è non strutturata (note di ricerca, trascrizioni di chiamate).
3. Uno dei tre endpoint di generazione.
| Endpoint | Cosa produce | Ideale per | Crediti |
|---|---|---|---|
POST /api/v1/slides/generate | PPTX nativo modificabile da uno dei 1.500+ template (themeId) | Qualsiasi cosa che un umano modificherà dopo: proposte, report, deck lezioni | 10 per pagina |
POST /api/v1/slides/create-pdf-slides | Slide con design immagine da prompt designStyle; 512px a 4K; qualsiasi ratio | Output visual-first: caroselli, deck lancio, sorgente video | 10 + 100 per pagina (2K) |
POST /api/v1/slides/create-like-this | Stesso, ma design derivato da referenceImageUrl | Matching brand rigoroso su centinaia di deck | 10 + 100 per pagina (2K) |
responseLanguage accetta un nome lingua come "Spanish" e di default è Auto.
4. Polling, poi consegna. Fast PPT generate è sincrono di default e restituisce un URL di download in una chiamata, comodo per script. Per batch, passa mode: "async", salva il jobId accanto al record che lo ha attivato, e interroga GET /api/v1/jobs/{id} finché status è success o failed. La consegna è quello che fa già il tuo stack: email PPTX, post Slack, salvataggio Drive, allegato record CRM.
Un worker Node.js minimale che ogni ricetta può riutilizzare:
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`);
}Mantieni una coda davanti a questa funzione: gli endpoint di generazione permettono 6 richieste al minuto per chiave, quindi 200 deck richiedono circa 35 minuti di tempo reale, non 35 minuti del tuo tempo.
Come scegliere la pipeline per un caso d'uso
La domanda ricorrente in ogni ricetta è "PPTX modificabile o slide con design immagine?" La risposta dipende da chi tocca il deck dopo.
| Situazione | Scegli | Perché |
|---|---|---|
| Un umano modificherà numeri, prezzi o testo dopo | generate (Fast PPT) | Caselle di testo reali e layout nel PPTX; 10 crediti per pagina |
| Centinaia di deck devono essere identici a una slide brand | create-like-this | Il sistema di design deriva dall'immagine di riferimento, non da un template |
| Output è un carosello, un post social o un video | create-pdf-slides | Controllo ratio (4:5, 9:16, 1:1) ed esportazione PNG per pagina |
| Il deck viene consegnato come video narrato | create-pdf-slides o create-like-this → generate-narration | Narrazione ed esportazione MP4 solo sulle pipeline con design immagine |
| Serve il costo unitario più basso possibile a volume | generate | 100 deck vocabolario da 10 pagine costano 10.000 crediti ($22.50) |
GET /api/v1/themes/search. Scegli un tema una volta, fissa il suo themeId, e ogni deck generato eredita il design.
referenceImageUrl a create-like-this quando vuoi un look specifico senza progettare da te.
Eseguire ricette da un agente AI invece che da uno strumento workflow
Ogni endpoint sopra è anche uno strumento MCP (slides_generate, slides_create_pdf_slides, slides_create_like_this, slides_generate_narration, slides_download_slides_pages_voices, themes_search, jobs_get) e le stesse operazioni sono confezionate come SKILL.md per agenti di coding. In pratica, i team prototipano una ricetta in una sessione Claude Code o Codex ("cerca un tema consulting, genera un brief di 12 slide da questa ricerca, in tedesco") e la spostano su n8n o cron solo quando il prompt è stabile.
I compromessi tra i due stili di integrazione sono trattati in Agent Skills vs MCP servers for presentations e la configurazione specifica Claude in Come usare Claude MCP per generare presentazioni.
Quanto costano le ricette a volume realistico
| Team e volume | Pipeline | Crediti al mese | USD al mese (a $0.0025) |
|---|---|---|---|
| Sales: 200 proposte × 10 pagine | generate | 20.000 | $50 (o $42.50 con pacchetto 20.000 crediti) |
| Customer Success: 60 onboarding + 60 review deck × 10 pagine | generate | 12.000 | $30 |
| Marketing: 4 riepiloghi settimanali × 8 pagine, narrati | create-pdf-slides + narrazione | ~10.000 | $25 |
| Content: 30 caroselli × 7 pagine a 2K | create-pdf-slides | 21.300 | $53 |
| Education: 40 lezioni × 12 pagine | generate | 4.800 | $12 |
| Healthcare: 25 condizioni × 8 pagine × 6 lingue | generate | 12.000 | $30 |
Nessun abbonamento è richiesto per nessuna riga; il piano Pro opzionale aggiunge 10.000 crediti al mese per team che preferiscono una fattura fissa.
Errori comuni in tutte le ricette
- Rate limiting. Sei richieste di generazione al minuto per chiave. Metti in coda e attendi; non riprovare un 429 in loop stretto.
- Chiavi nel posto sbagliato. La chiave API deve stare sul server, nelle credenziali n8n o nel webhook Zapier, mai in browser o Sheet condivisi.
- Narrazione sulla pipeline sbagliata.
generate-narrationaccetta solo job dacreate-pdf-slidesocreate-like-this. I deck Fast PPT non possono essere narrati. - Codici lingua.
responseLanguageprende un nome ("Japanese"), non "ja". - Input troppo grandi. Riassumi una fonte di 40 pagine in una scaletta slide prima della generazione; il deck è chiaro quanto il brief.
- Sorprese nel conteggio pagine automatico.
page: 0lascia scegliere il modello; passa un numero fisso se il template a valle lo richiede.
Domande Frequenti
A cosa serve un'API per presentazioni AI?
Un'API per presentazioni AI serve a generare deck di slide da dati strutturati o testo senza design manuale, attivata da eventi in altri sistemi. Gli usi più comuni sono proposte di vendita personalizzate da dati CRM, report ricorrenti da analytics, deck di onboarding e formazione, slide per lezioni per classe, e caroselli social da calendari contenuti.
Quali team traggono più vantaggio dall'automazione delle presentazioni?
I team che producono molti deck simili traggono più vantaggio: sales e customer success (un deck per account), marketing e agenzie (un report per cliente a settimana), education (un deck per lezione o lingua), e comunicazioni healthcare (un deck per condizione per lingua). I team che fanno un deck su misura al mese di solito preferiscono l'app web.
Serve Zapier, Make o n8n per usare un'API per presentazioni?
No. Qualsiasi linguaggio che può inviare richieste HTTPS funziona, e il worker Node.js sopra è completo. Zapier, Make e n8n sono utili quando il trigger è già lì (una riga Sheets, un cambio fase HubSpot) e vuoi la consegna (email, Slack, Drive) senza scrivere codice.
Quanto costa generare 100 presentazioni con un'API?
Con la 2Slides API, 100 deck PPTX modificabili da 10 pagine costano 10.000 crediti, cioè $22.50 con il pacchetto 10.000 crediti. 100 deck con design immagine a 2K costano circa 101.000 crediti, circa $202 al prezzo del pacchetto 40.000 crediti a $0.002 per credito. Polling job, ricerca temi ed esportazione per pagina sono gratuiti.
Un agente AI come Claude Code può eseguire queste ricette?
Sì. Le sette operazioni API sono esposte come server MCP (ospitato o via npx -y 2slides-mcp@latest) e come Agent Skill, così Claude Code, Codex, Cursor e agenti simili possono cercare temi, generare deck, aggiungere narrazione e scaricare risultati usando la stessa chiave e crediti della REST API.
Prossimi passi
- Crea una chiave API su 2slides.com/api; i 500 crediti gratuiti coprono circa 50 pagine modificabili, abbastanza per testare qualsiasi ricetta qui.
- Parti dalla ricetta più vicina al tuo trigger: proposte vendita da Sheets, deck onboarding da Closed Won, o slide lezioni da curriculum.
- Per il confronto a livello sviluppatore con l'API Gamma e la reference completa degli endpoint, leggi Gamma Generate API vs 2Slides API e Migliore API per presentazioni AI per sviluppatori.
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
