

Gamma Generate API vs 2Slides API: Confronto per Sviluppatori (2026)
La Gamma Generate API (POST /v1.0/generationsPOST /api/v1/slides/*
Premessa doverosa: 2Slides è il nostro prodotto. Tutti i dati su Gamma riportati qui sotto provengono dalla documentazione ufficiale per sviluppatori di Gamma, e segnaliamo chiaramente i casi in cui Gamma è la scelta migliore.
La superficie completa degli endpoint
Le due API hanno forme diverse: Gamma è un unico endpoint di generazione con molti formati di output; 2Slides è più pipeline specializzate su un unico sistema di job.
| Funzionalità | Gamma | 2Slides |
|---|---|---|
| Prompt → presentazione | POST /v1.0/generationsformat: "presentation" | POST /api/v1/slides/generate |
| Documenti / pagine web / post social | Stesso endpoint, parametro format | — |
| Slide con design da immagine (stile personalizzato) | Stesso endpoint + imageOptions | POST /api/v1/slides/create-pdf-slides |
| Corrispondenza stile da immagine di riferimento | — | POST /api/v1/slides/create-like-thisreferenceImageUrl |
| Generazione dal template di un file esistente | POST /v1.0/generations/from-template | Selezione tema tramite GET /api/v1/themes/search |
| Narrazione vocale | — | POST /api/v1/slides/generate-narration |
| Export asset per pagina | ZIP di PNG tramite exportAs | POST /api/v1/slides/download-slides-pages-voices |
| Stato del job | GET /v1.0/generations/{id} | GET /api/v1/jobs/{id}mode: "sync" |
| Operazioni di gestione | Temi, cartelle, archiviazione, eliminazione | Ricerca temi, echo di autenticazione |
Due note per correttezza: il design a endpoint singolo di Gamma è genuinamente elegante se vuoi quattro tipi di canvas dietro un'unica integrazione, e la sua API Create-from-Template (beta) copre il caso "riutilizza il mio deck esistente" che 2Slides gestisce in modo diverso (tramite temi) — mentre la corrispondenza da immagine di riferimento e la narrazione di 2Slides non hanno alcun equivalente nell'API Gamma.
Le richieste, a confronto
Entrambe le API seguono lo stesso schema: invia un job, fai polling sullo stato, scarica il risultato.
Gamma — header
X-API-KEYcurl -X POST https://public-api.gamma.app/v1.0/generations \ -H "X-API-KEY: sk-gamma-xxxxx" \ -H "Content-Type: application/json" \ -d '{ "inputText": "Q3 sales review for the leadership team", "format": "presentation", "numCards": 10, "exportAs": "pptx" }' # → { "generationId": "..." } poi polling su GET /v1.0/generations/{generationId}
2Slides Fast PPT — chiave Bearer, PPTX nativo da template con design, modalità
syncasynccurl -X POST https://2slides.com/api/v1/slides/generate \ -H "Authorization: Bearer sk-2slides-xxxxx" \ -H "Content-Type: application/json" \ -d '{ "userInput": "Q3 sales review for the leadership team", "themeId": "minimal-dark", "responseLanguage": "en", "mode": "async" }' # → id del job, poi polling su GET /api/v1/jobs/{id}; la modalità sync restituisce il deck completo in una sola chiamata
Pipeline image-designed di 2Slides — i due endpoint senza equivalente in Gamma.
create-pdf-slidescreate-like-thiscurl -X POST https://2slides.com/api/v1/slides/create-like-this \ -H "Authorization: Bearer sk-2slides-xxxxx" \ -H "Content-Type: application/json" \ -d '{ "userInput": "Q3 sales review for the leadership team", "referenceImageUrl": "https://example.com/brand-slide.png", "resolution": "2K", "aspectRatio": "16:9", "page": 0, "mode": "async" }' # page: 0 = rilevamento automatico del numero di pagine; resolution: 512px | 1K | 2K | 4K # create-pdf-slides accetta la stessa struttura con designStyle al posto di referenceImageUrl
I job generati da queste due pipeline possono poi essere inviati a
generate-narrationjobIddownload-slides-pages-voicesDue differenze strutturali emergono subito. Gamma sceglie contenuto e design in un colpo solo, con controlli opzionali su
textModeimageOptionstextOptionsGET /api/v1/themes/searchConfronto delle funzionalità
| Gamma Generate API | 2Slides API | |
|---|---|---|
| Output principale | Documento Gamma web-native + exportUrl | PPTX nativo (Fast PPT); slide con design da immagine come PDF (512px–4K); PNG + WAV per pagina |
| Modalità di generazione | Un endpoint, 4 tipi di canvas (presentazione, documento, pagina web, social) | 3 pipeline: PPTX da template, prompt di design-style, corrispondenza da immagine di riferimento |
| Narrazione vocale / asset video | — | 30+ voci, singola/due voci; export PNG+WAV per assemblaggio video |
| Autenticazione | Header X-API-KEY | Authorization: Bearer |
| Accesso API richiede | Piano Pro ($25/mese), Ultra, Team o Business | Qualsiasi account; 500 crediti gratuiti alla registrazione |
| Modello di pricing | Abbonamento + crediti mensili (1–3 crediti/card testo; 2–125/immagine per tier) | Pay-as-you-go: 10/pagina Fast PPT, 100/pagina 1K–2K, 200/pagina 4K, 210/pagina narrazione ($5 per 2.000 crediti) |
| Controllo numero slide | numCards | Parametro page |
| Controllo risoluzione / aspect ratio | — | resolutionaspectRatio |
| Template | themeIdGET /v1.0/themes | themeId |
| Rate limit documentati | Non pubblicati | 10 req/min (Fast PPT), 6 req/min (pipeline immagini) |
| Modalità sincrona | — (solo async) | mode: "sync" |
| Integrazioni con agenti | Zapier; prompt a Gamma da Claude | Server MCP (npx 2slides-mcp |
| Multilingua | Supportato | 19+ lingue di output inclusi CJK/RTL nativi (responseLanguage |
Cosa significano i modelli di pricing nella pratica
I modelli differiscono più dei numeri stessi. Gamma include i crediti API nei piani a pagamento: per chiamare l'API devi avere un abbonamento Pro o superiore, i crediti si rinnovano ogni mese e il costo per generazione varia perché il testo viene fatturato per card (1–3 crediti, dipende dal modello) e le immagini per tier di qualità (2–125 crediti ciascuna) — l'utilizzo effettivo viene restituito nel campo
creditsIn termini pratici: per un team già su Gamma Pro che genera qualche deck in modo programmatico, il costo API marginale è di fatto zero. Per un servizio che genera deck per altri — una funzionalità SaaS, report per cliente, pipeline batch — un pricing prevedibile per pagina senza requisiti di seat è la differenza tra una funzionalità con costi calcolabili e una bolletta variabile. (Esempi pratici di batch: generare presentazioni in batch tramite API.)
Formato di output: PPTX esportato vs PPTX composto
Questa è la differenza architetturale più profonda. Gamma è web-native prima di tutto — i deck sono documenti Gamma pensati per la visualizzazione e la condivisione nel browser, con PPTX/PDF/PNG prodotti tramite
exportAs.pptxDove vince ciascuna API
Scegli la Gamma Generate API quando:
- Hai bisogno di più tipi di canvas oltre alle slide — genera documenti, pagine web e post social attraverso lo stesso endpoint
- Il tuo team paga già Gamma Pro/Ultra e lavora nel suo editor
- Il deliverable è un link condivisibile con la cura del design di Gamma
- Vuoi controlli sullo stile delle immagini (, opzioni di tono/audience) in un'unica richiesta
imageOptions.source
Scegli la 2Slides API quando:
- Il deliverable è un PPTX nativo e modificabile a costo prevedibile per pagina
- Hai bisogno di un design corrispondente a un'immagine di riferimento () o di slide con direzione artistica a risoluzione e aspect ratio controllati (
create-like-this)create-pdf-slides - Hai bisogno di narrazione o asset audio/immagine per pagina per video dalla stessa pipeline
- Stai integrando tramite agenti AI — il server MCP e l'Agent Skill rendono l'integrazione con Codex/Claude Code un blocco di configurazione, non un progetto SDK (guida skills vs MCP)
- Generi a volume senza voler gestire abbonamenti per seat, o hai bisogno di rate limit documentati su cui progettare
FAQ
La Gamma API richiede un piano a pagamento?
Sì. Secondo la documentazione di accesso di Gamma, le chiavi API sono disponibili sui piani Pro, Ultra, Teams e Business — non su Free o Plus. La 2Slides API rilascia chiavi su qualsiasi account, con 500 crediti gratuiti per iniziare.
La Gamma API può esportare file PowerPoint veri?
Sì — imposta
"exportAs": "pptx"exportUrlgammaUrlCosa offre la 2Slides API oltre al prompt-to-PPTX?
Tre superfici aggiuntive:
create-pdf-slidescreate-like-thisgenerate-narrationQuale API è più economica per la generazione in batch?
Per i deck prevalentemente testuali, i 10 crediti fissi/pagina di 2Slides (~$0,025/pagina al tier da $5) sono più facili da calcolare rispetto al modello di Gamma con crediti per card (1–3) più crediti per immagine (2–125) — e non richiede abbonamento. Per i deck con immagini AI, 2Slides applica una tariffa fissa di 100–200 crediti/pagina per risoluzione, contro i tier di qualità per immagine di Gamma; fai i conti con il tuo numero effettivo di pagine.
Entrambe le API funzionano con agenti AI come Claude o Codex?
In modo diverso. Gamma offre automazione tramite Zapier e la possibilità di fare prompt a Gamma da Claude. 2Slides fornisce integrazioni a livello di protocollo — un server MCP che qualsiasi client MCP può chiamare e un SKILL.md per agenti di coding — trattati nelle guide sulle agent skills.
Esiste un confronto completo tra Gamma e 2Slides che vada oltre l'API?
Sì — il confronto a livello di prodotto (editor, template, collaborazione, pricing) è in 2Slides vs Gamma; questo articolo copre solo la superficie per sviluppatori.
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free