

Gamma Generate API vs 2Slides API: un confronto per sviluppatori (2026)
L'API pubblica di Gamma (POST /v1.0/generations e circa venti endpoint complementari) e l'API di 2Slides (POST /api/v1/slides/*) generano entrambe presentazioni in modo programmato, ma sono costruite attorno a prodotti diversi. Gamma genera una "gamma" web-native (presentazione, documento, pagina web o post social), la esporta in PPTX/PDF/PNG, e ora espone anche remix di template, generazione immagini standalone, ricerca nello spazio di lavoro, analisi di engagement, OAuth e un server MCP ospitato. Le chiavi API richiedono un piano Pro ($25/mese) o superiore. 2Slides espone quattro superfici di generazione (PPTX nativo guidato da template, slide disegnate da prompt, matching di stile da immagine di riferimento e narrazione vocale per pagina) più esportazione gratuita PNG + WAV per pagina, con chiavi API su qualsiasi account e crediti pay-as-you-go da $5. Entrambe sono API asincrone basate su job. La scelta giusta dipende dal formato di output, dalla struttura dei prezzi e dal fatto che tu stia automatizzando il tuo workspace o integrando la generazione in un prodotto.
Dichiarazione di trasparenza: 2Slides è il nostro prodotto. Ogni dato su Gamma qui sotto proviene dalla documentazione per sviluppatori di Gamma, dalla sua pagina prodotto API e dalla pagina prezzi aggiornata a settembre 2026, e segnaliamo chiaramente dove Gamma è la scelta migliore.
Aggiornato a settembre 2026. La prima versione di questo confronto (agosto 2026) descriveva Gamma come "un endpoint di generazione con molti formati di output". Non è più accurato. Il changelog di Gamma mostra che l'API è passata da beta (luglio 2025) a v1.0 (novembre 2025), ha ritirato gli endpoint v0.2 a gennaio 2026, ha reso disponibile Create from Template a febbraio 2026 e ha rilasciato parità con Zapier, Make e n8n più un'app ChatGPT a marzo 2026. La tabella degli endpoint, la matrice funzionalità e i calcoli prezzi qui sotto riflettono la superficie attuale.
La superficie completa degli endpoint
Le due API hanno strutture diverse. Gamma è un'API workspace unica: gli endpoint di generazione convivono con quelli di gestione, esportazione, analisi e immagini che operano su documenti già presenti nel tuo workspace Gamma. 2Slides è diversi pipeline specializzati di generazione su un unico sistema di job, senza alcun livello workspace.
| Capacità | Gamma | 2Slides |
|---|---|---|
| Prompt → deck | POST /v1.0/generations (format: "presentation") | POST /api/v1/slides/generate (Fast PPT, PPTX nativo) |
| Documenti / pagine web / post social | Stesso endpoint, parametro format; array pages costruisce un sito multipagina (fino a 50 pagine) | — |
| Slide disegnate da immagini (stile design personalizzato) | Stesso endpoint + imageOptions (35+ modelli immagine su 4 livelli di prezzo) | POST /api/v1/slides/create-pdf-slides (512px–4K, qualsiasi rapporto d’aspetto, prompt designStyle) |
| Abbinare lo stile di un’immagine di riferimento | — (immagini di riferimento solo su standalone POST /v1.0/images) | POST /api/v1/slides/create-like-this (referenceImageUrl) |
| Generare da deck/template esistente | POST /v1.0/generations/from-template (GA da feb 2026; gammaId + prompt) | Selezione tema via GET /api/v1/themes/search (1.500+ template) |
| Generazione immagini standalone | POST /v1.0/images + GET /v1.0/images/{id} | — |
| Narrazione vocale | — | POST /api/v1/slides/generate-narration (singolo o due speaker, 30 voci) |
| Esportazione asset per pagina | ZIP PNG via exportAs: "png" | POST /api/v1/slides/download-slides-pages-voices (PNG + WAV, gratuito) |
| Esportare un documento esistente | POST /v1.0/gammas/{id}/export → GET /v1.0/exports/{id} | — (ogni job restituisce già URL di download) |
| Stato job | GET /v1.0/generations/{id} (poll ogni 5 s) | GET /api/v1/jobs/{id} (o mode: "sync") |
| Gestione workspace | GET /v1.0/themes, GET /v1.0/folders, GET /v1.0/gammas/search, GET /v1.0/templates/search, get/archive/delete gamma, lista commenti | Ricerca temi, echo auth |
| Analisi engagement | GET /v1.0/gammas/{id}/analytics (doc, per card, per viewer) | — |
| Autenticazione | X-API-KEY o OAuth 2.0 (PKCE, dynamic client registration) | Authorization: Bearer |
Due note per correttezza. L’API di Gamma è ora davvero una piattaforma workspace: se la tua integrazione deve leggere, cercare, esportare o misurare documenti già creati in Gamma, non esiste equivalente 2Slides perché 2Slides non ha un workspace documentale dietro l’API. E l’endpoint Create-from-Template di Gamma, ora fuori beta, copre il caso "riusa il mio deck esistente" che 2Slides affronta diversamente (temi e immagini di riferimento). Dall’altra parte, il matching con immagine di riferimento, la narrazione vocale e l’esportazione audio per pagina di 2Slides non hanno ancora equivalenti nell’API Gamma. La pagina API di Gamma mostra video narrati come ricetta n8n che concatena Synthesia ed ElevenLabs.
Le richieste, a confronto
Entrambe le API seguono lo stesso schema: invii un job, fai polling per lo stato, scarichi il risultato.
Gamma: header X-API-KEY, polling ogni 5 secondi, un formato di esportazione per richiesta:
curl -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",
"textMode": "generate",
"format": "presentation",
"numCards": 10,
"cardOptions": { "dimensions": "16x9" },
"imageOptions": { "source": "aiGenerated", "model": "flux-2-pro" },
"exportAs": "pptx"
}'
# → { "generationId": "..." } poi poll GET /v1.0/generations/{generationId}
# completato → { "status": "completed", "gammaId": "...", "gammaUrl": "...", "exportUrl": "...", "credits": { "deducted": 15, "remaining": 485 } }2Slides Fast PPT: chiave Bearer, PPTX nativo da template disegnato. sync è default e restituisce il deck finito in una chiamata; async restituisce un job id:
curl -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"
}'
# → job id, poi poll GET /api/v1/jobs/{id}2Slides pipeline per slide disegnate da immagini: i due endpoint per cui Gamma non ha equivalente. create-pdf-slides genera slide art-directed da prompt con controllo di risoluzione e rapporto d’aspetto; create-like-this deriva tutto il sistema di design da un’immagine di riferimento:
curl -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,
"contentDetail": "concise",
"imageModel": "gemini-3-pro-image",
"mode": "async"
}'
# page: 0 = auto-detect numero pagine (max 100); resolution: 512px | 1K | 2K | 4K
# create-pdf-slides ha la stessa struttura con designStyle invece di referenceImageUrlI job di queste due pipeline possono poi essere inviati a generate-narration (jobId, mode: "single" | "multi", nomi speaker e voci, includeIntro) ed esportati per pagina come PNG + WAV con download-slides-pages-voices, che è come si assemblano deck video narrati.
Tre differenze strutturali emergono subito. Gamma sceglie contenuto e design in un colpo solo, con textMode (generate, condense, preserve), textOptions (quantità, tono, pubblico, oltre 60 lingue), imageOptions, cardOptions.headerFooter e sharingOptions tutti nella stessa richiesta; 2Slides separa la selezione tema (GET /api/v1/themes/search) dalla generazione, che è ciò che garantisce coerenza visiva tra esecuzioni. L’inputText di Gamma accetta fino a circa 100.000 token e rispetta le interruzioni \n---\n per card, quindi funge anche da endpoint documento→deck; l’userInput di 2Slides è un brief o outline, e l’input file vive nel prodotto workspace, non nell’API. Inoltre 2Slides offre una modalità sincrona su ogni endpoint di generazione, utile in script dove il polling è solo formalità.
Confronto funzionalità
| Gamma API | 2Slides API | |
|---|---|---|
| Output primario | Gamma web-native (URL) + exportUrl (PPTX / PDF / PNG zip; URL scade dopo ~1 settimana e non è legato alla tua chiave) | PPTX nativo (Fast PPT); slide disegnate come PDF (512px–4K); PNG + WAV per pagina |
| Modalità di generazione | Genera da testo, da template, array multipagina pages; 4 formati (presentation, document, webpage, social) | 3 pipeline: PPTX template, prompt stile design, matching immagine di riferimento |
| Immagini standalone | POST /v1.0/images (illustrazione/foto/astratto, preset dimensioni, immagini di riferimento) | — |
| Narrazione vocale / asset video | — (ricette usano Synthesia + ElevenLabs via n8n) | 30 voci, dialogo singolo o a due speaker; esportazione PNG + WAV per assemblaggio video |
| Autenticazione | X-API-KEY o OAuth 2.0 con PKCE e dynamic client registration (scope generate / gamma:read) | Authorization: Bearer |
| Accesso API richiede | Piano Pro ($25/mese), Ultra ($100/mese), Teams o Business; Free e Plus non possono creare chiavi API | Qualsiasi account; 500 crediti gratuiti all’iscrizione |
| Struttura prezzi | Abbonamento con crediti mensili (Pro 4.000, Ultra 20.000, Business 10.000/seat; rollover fino a 2×) + 1–3 crediti/card testo + 2–125 crediti/immagine per tier modello | Pay-as-you-go: 10/page Fast PPT; 10 pianificazione + 100/page (512px–2K) o 200/page (4K) pipeline immagini; 210/page narrazione; $5 per 2.000 crediti, fino a $80 per 40.000 |
| Controllo numero slide | numCards 1–75, o cardSplit: "inputTextBreaks" | page 0 (auto) a 100 |
| Controllo aspetto / risoluzione | cardOptions.dimensions: presentation fluid/16x9/4x3, social 1x1/4x5/9x16, document letter/a4; nessun controllo pixel | resolution 512px / 1K / 2K / 4K; aspectRatio qualsiasi w:h |
| Template | themeId via GET /v1.0/themes; Create from Template (gammaId + prompt) | themeId via ricerca temi su 1.500+ template |
| Rate limit | Applicati per chiave con burst, finestre orarie e giornaliere esposte come header x-ratelimit-*; backoff 30 s su 429 | 6 richieste/min per chiave su endpoint generazione, 10/min su polling job, restituiti in header X-RateLimit-* |
| Modalità sync | — (solo async, polling ogni 5 s) | mode: "sync" su ogni endpoint generazione |
| Integrazioni agenti | Server MCP ospitato (17 tool, OAuth con DCR) che alimenta connettori Claude e ChatGPT; Zapier, Make, n8n, Workato; Slack, Superhuman Go, Atlassian Rovo | Server MCP (hosted Streamable HTTP o npx -y 2slides-mcp@latest, 7 tool) + Agent Skill per Codex, Claude Code, OpenClaw, Cursor |
| Post-generazione | Ricerca, commenti, archiviazione/cancellazione, esporta esistenti, analytics per card e viewer | Solo stato job e download |
| Modifica documento esistente | Non supportato; rigenera o usa Create from Template | Non applicabile (file sono il deliverable) |
| Lingue output | 60+ via textOptions.language | 20+ incl. nativo CJK/RTL via responseLanguage |
Cosa significano i modelli di prezzo nella pratica
I modelli differiscono più dei numeri. Gamma raggruppa i crediti API in seat. Per creare una chiave API devi avere un abbonamento Pro o superiore (gli account Free hanno 400 crediti non ricaricabili e nessuna chiave; Plus ha crediti ma non chiavi). I crediti si rinnovano mensilmente, si accumulano fino a 2 volte la quantità mensile, e il costo per generazione varia: il testo si paga 1–3 crediti per card a seconda del modello scelto da Gamma, e le immagini da 2 (Flux 1 Quick) a 125 (Recraft V4 Pro) crediti ciascuna. La stima illustrativa di Gamma è 20–60 crediti per un deck da 10 card con 5 immagini base; un documento da 20 card con 15 immagini premium costa 320–1.070. L’uso reale è riportato nel campo credits.deducted della risposta di polling, quindi il budgeting è a posteriori. La ricarica automatica è il modo documentato per evitare generazioni fallite.
2Slides fattura a pagina, per pipeline. Un deck Fast PPT da 10 pagine costa sempre 100 crediti (circa $0.25 al livello $5/2.000), un deck 2K disegnato da immagini costa 10 pianificazione + 1.000 crediti ($2.53), la narrazione aggiunge 210 per pagina, e polling job, ricerca temi ed esportazione per pagina sono gratuiti. Il prezzo è noto prima della chiamata, che tu generi un deck o mille, e non c’è un abbonamento obbligatorio per la chiave (un piano Pro opzionale aggiunge 10.000 crediti mensili, ma l’API non lo richiede).
Traduzione pratica: per un team già su Gamma Pro che genera qualche deck programmaticamente, il costo marginale API è praticamente zero, e i 4.000 crediti mensili coprono circa 65–200 deck secondo l’illustrazione Gamma da 20–60 crediti. Per un servizio che genera deck per altri (feature SaaS, report per cliente, pipeline batch), un prezzo prevedibile per pagina senza requisiti di seat è la differenza tra una feature costabile e una bolletta variabile. Esempi batch: batch-generating presentations by API.
Formato output: PPTX esportato vs PPTX composto
Questa è la differenza architetturale più profonda, e non è cambiata con l’espansione di Gamma. Gamma è web-native prima di tutto: i deck sono documenti gamma progettati per la visualizzazione e condivisione browser, con PPTX/PDF/PNG prodotti tramite exportAs (o successivamente tramite endpoint export), un formato per richiesta. Questo rende eccellente l’esperienza web di Gamma, e significa che PowerPoint è un artefatto derivato. La pipeline Fast PPT di 2Slides compone il PPTX stesso come artefatto primario: caselle di testo, layout e grafici sono costruiti nel file, perciò i deck restano completamente modificabili in PowerPoint dopo. Se il tuo deliverable è un link, il modello Gamma è probabilmente migliore; se è un .pptx che un cliente aprirà e modificherà, il PPTX generato nativamente evita la seam di esportazione (perché quella seam conta: perché gli strumenti AI per slide rompono l’export PowerPoint). E quando il deliverable è visivo, slide immagine brand-matched o video narrato, le pipeline immagini più narrazione coprono casi che nessuna superficie Gamma raggiunge.
Integrazioni agenti: due server MCP, forme diverse
Entrambi i vendor ora offrono un server MCP, quindi la domanda è cosa espongono. Quello di Gamma è ospitato e solo OAuth (dynamic client registration; integrazioni custom tramite form e URI redirect HTTPS richiesti). Espone 17 tool che rispecchiano l’API REST: genera, genera da template, generazione multipagina, immagini standalone, esporta, ricerca e lettura gamma esistenti, commenti e quattro strumenti di analytics. Funziona su tutti i piani Gamma perché si autentica come utente e non con chiave API, ed è ciò che alimenta i connettori Gamma dentro Claude e ChatGPT. È una scelta forte se il lavoro dell’agente è operare dentro il workspace Gamma di qualcuno.
Il server MCP di 2Slides espone 7 tool con la stessa chiave API e crediti dell’API REST: slides_generate, slides_create_pdf_slides, slides_create_like_this, slides_generate_narration, slides_download_slides-pages-voices, themes_search e jobs_get. Funziona ospitato (Streamable HTTP, una riga claude mcp add) o localmente via npx, e la stessa superficie è confezionata come SKILL.md per agenti di coding. È una scelta forte se il lavoro dell’agente è restituire un file finito. I compromessi tra i due stili di integrazione sono in Agent Skills vs MCP servers for presentations.
Dove vince ciascuna API
Scegli l’API Gamma quando:
- Ti servono più tipi di canvas oltre alle slide: documenti, pagine web, caroselli social o un sito multipagina da una singola richiesta
pages - La tua integrazione opera su un workspace Gamma esistente: ricerca, esportazione, commenti, analytics di engagement o remix di template con Create from Template
- Il tuo team paga già Gamma Pro/Ultra e il deliverable è un link web condivisibile con la cura del design Gamma
- Vuoi controlli di contenuto dettagliati (
textMode, tono, pubblico, 60+ lingue, header/footer, permessi di condivisione) direttamente nella richiesta di generazione - La tua app agisce per conto di utenti finali che hanno ciascuno un proprio account Gamma, quindi OAuth è il modello giusto invece di una chiave condivisa
Scegli l’API 2Slides quando:
- Il deliverable è un PPTX nativo, modificabile, a costo prevedibile per pagina
- Ti serve design abbinato a un’immagine di riferimento (
create-like-this) o slide art-directed con controllo di risoluzione e rapporto d’aspetto (create-pdf-slides) - Ti serve narrazione o asset audio/immagine per pagina per video dalla stessa pipeline, senza concatenare strumenti TTS e video di terze parti
- Ti integri tramite agenti di coding e vuoi che MCP server o Agent Skill rendano l’integrazione Codex/Claude Code un blocco di configurazione, non un progetto OAuth (guida skills vs MCP)
- Generi a volume per altri e non vuoi abbonamenti per seat davanti alla chiave, o vuoi chiamate sincrone per lavori piccoli
FAQ
L’API Gamma richiede un piano a pagamento?
Sì. Secondo la documentazione di accesso Gamma, le chiavi API sono disponibili su piani Pro, Ultra, Teams e Business, non su Free o Plus. I connettori ChatGPT e Claude di Gamma (che girano sul suo server MCP) funzionano su tutti i piani, incluso Free, ma agiscono come utente autenticato e non come chiave sviluppatore. L’API 2Slides emette chiavi su qualsiasi account, con 500 crediti gratuiti iniziali.
L’API Gamma può esportare file PowerPoint reali?
Sì. Imposta "exportAs": "pptx" e la generazione completata include un exportUrl accanto a gammaUrl, oppure chiama POST /v1.0/gammas/{id}/export su un documento esistente. Un solo formato di esportazione per richiesta, e l’URL scade dopo circa una settimana e non è legato alla tua chiave API, quindi scarica subito e trattalo come un segreto. Il file è esportato da un documento web-native, quindi layout complessi sono tradotti e non composti nativamente; testa la fedeltà con i tuoi template.
L’API Gamma può modificare un deck dopo averlo generato?
No. La pagina scope API di Gamma dichiara che l’API crea gamma ma non modifica quelli esistenti; la soluzione è rigenerare con input rivisto o usare Create from Template con un prompt tipo "on card 9, update the pricing." 2Slides ha la stessa limitazione per ragioni diverse: i suoi job restituiscono file, e le modifiche avvengono in PowerPoint.
Cosa offre l’API 2Slides oltre prompt→PPTX?
Tre superfici aggiuntive: create-pdf-slides (slide disegnate da prompt stile design, 512px–4K, qualsiasi rapporto d’aspetto), create-like-this (deriva tutto il design da URL immagine di riferimento), e generate-narration (narrazione singola o a due speaker su quei job, 30 voci), più esportazione gratuita PNG + WAV per pagina per assemblare video narrati.
Quale API è più economica per generazione bulk?
Per deck testuali, i 10 crediti fissi per pagina di 2Slides (circa $0.025 per pagina al livello $5) sono più semplici da calcolare rispetto al modello Gamma per card (1–3 crediti) più immagine (2–125 crediti), e non richiede abbonamento. Per deck con immagini AI, 2Slides costa 100–200 crediti fissi per pagina a seconda della risoluzione contro i tier modello per immagine di Gamma, dove un’immagine Ultra costa più di una pagina 2Slides intera. Calcola i tuoi conteggi reali di pagine e immagini; il campo credits.deducted di Gamma facilita l’audit a posteriori.
Entrambe le API funzionano con agenti AI come Claude o Codex?
Sì, entrambe forniscono server MCP. Il MCP ospitato di Gamma (17 tool, OAuth) alimenta i connettori Claude e ChatGPT e funziona su ogni piano. 2Slides fornisce un endpoint MCP ospitato e un server stdio open-source (7 tool, chiave API) più un SKILL.md per agenti di coding, coperto nelle guide agent skills.
Esiste un confronto completo tra Gamma e 2Slides oltre l’API?
Sì. Il confronto a livello prodotto (editor, template, collaborazione, prezzi) è in 2Slides vs Gamma; questo post copre solo la superficie per sviluppatori. Per ricette di automazione scenario per scenario (proposte di vendita, presentazioni di onboarding, video di marketing, diapositive delle lezioni, educazione del paziente), vedi AI presentation API use cases by team.
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free