Cos'è la Gamma API?
Hai una presentazione che ti piace? E se potessi crearne altre 100 uguali, personalizzate per diversi pubblici in tutto il mondo?
La Gamma Generate API ti permette di creare presentazioni, documenti, pagine web e post social programmaticamente senza usare direttamente l'app Gamma. È perfetta per chi vuole automatizzare i propri flussi di lavoro con strumenti come Zapier, Make o n8n, integrare la generazione di presentazioni belle nelle proprie applicazioni o creare presentazioni su larga scala tramite integrazione di codice backend.
E se sei uno sviluppatore, puoi integrare Gamma nella tua applicazione per darle superpoteri di design!
💎 Consiglio Pro: Chiunque abbia un account Pro o superiore può accedere oggi all'API con limiti di utilizzo generosi.
L'API è pronta?
La Gamma API v1.0 è stata Generally Available (GA) dal 5 novembre 2025. Chiunque abbia un account Pro o superiore può accedere oggi all'API con limiti di utilizzo generosi.
Per informazioni dettagliate sui parametri specifici dell'API e su come influenzano la generazione delle presentazioni, consulta la nostra documentazione API.
Come ottengo l'accesso?
Per accedere alla Gamma API, segui questi passaggi.
Passo 1: Aggiorna il tuo account
Devi avere un account Gamma Pro, Ultra, Team o Business. Se non sei attualmente un utente Pro o superiore, esegui l'upgrade a Pro per accedere all'API.
Passo 2: Genera una chiave API
Vai su Impostazioni and Membri nel tuo account Pro, poi vai alla scheda API key. Clicca su Create API key per generare la tua chiave, quindi copiala e conservala in modo sicuro.
🔷 Nota: Le chiavi API usano il formato sk-gamma-xxxxxxxx e devono essere passate usando l'header X-API-KEY (non il formato Bearer token).
💎 Consiglio Pro: Inizia a usare l'API con i tuoi strumenti di automazione preferiti o integrala direttamente nel tuo codice backend. L'URL base è https://public-api.gamma.app/v1.0/
Posso autenticarmi con OAuth invece di una chiave API?
Puoi autenticarti con la Gamma REST API usando OAuth 2.0 invece di una chiave API statica. OAuth ti permette di collegare la Gamma API a un'applicazione senza creare o memorizzare una chiave API a lunga durata, utile per integrazioni e app partner. Le chiavi API statiche sono ancora completamente supportate, quindi puoi continuare a usare l'header X-API-KEY se preferisci. Per configurare OAuth, segui la guida Authenticate with OAuth nella documentazione per sviluppatori su developers.gamma.app/get-started/authenticate-with-oauth.
Utilizzo e limiti di velocità
Limiti API attuali
L'API di Gamma è progettata per scalare con le tue esigenze. Che tu stia generando poche presentazioni o centinaia, dovresti poter creare in base ai tuoi requisiti di utilizzo senza incontrare limiti durante l'uso normale.
🌀 Approfondimento: Se incontri limitazioni di velocità (errori HTTP 429), contatta il nostro team di supporto. Lavoreremo con te per assicurarci che l'API supporti ciò che stai costruendo!
Cosa c'è di nuovo nella v1.0?
L'API v1.0 include diverse nuove funzionalità potenti:
Formato pagina web: Genera pagine web oltre a presentazioni, documenti e post social.
Personalizzazione intestazioni e piè di pagina: Personalizza le intestazioni e i piè di pagina dei tuoi contenuti.
URL immagini in input: Riferisci immagini direttamente nei tuoi contenuti.
Organizzazione folders: Organizza i contenuti generati in folders.
Condivisione via email: Condividi contenuti via email programmaticamente.
List API: Nuovi endpoint per elencare i tuoi temi e folders.
Ricerca gammas: Cerca nei titoli e nel testo completo dei gammas a cui puoi accedere, e filtra i risultati prima di aprirli.
Migliori limiti di input: Fino a 100.000 token (circa 400.000 caratteri).
🌀 Approfondimento: Man mano che l'API evolve, continueremo ad aggiungere più opzioni per modificare e remixare i Gammas programmaticamente.
Posso generare immagini standalone con l'API?
Ora puoi generare immagini standalone con la Gamma Generate API e tramite il Model Context Protocol (MCP). Questo ti permette di creare immagini singole programmaticamente, separatamente dalla generazione di una presentazione, documento o pagina web completa. Per generare immagini tramite API o MCP, segui la guida Create image generation nella documentazione per sviluppatori su developers.gamma.app/images/create-image-generation. La generazione di immagini tramite MCP è disponibile oggi in Claude e altri client MCP; non è ancora disponibile in ChatGPT.
Posso cercare i miei gammas con l'API o MCP?
Puoi cercare l'intera biblioteca di gammas dalla Gamma API o tramite un assistente AI collegato a Gamma con il Model Context Protocol (MCP), uno standard aperto che permette agli assistenti AI di connettersi a strumenti come Gamma. La ricerca copre sia i titoli che il testo completo di ogni gamma a cui hai accesso, e ordina i risultati per rilevanza in modo che la corrispondenza più vicina appaia per prima. Ogni risultato include un link diretto, così puoi aprire il gamma direttamente dalla risposta.
Puoi restringere la ricerca in base a chi ha creato il gamma e a quando è stato aggiornato l'ultima volta. I gammas archiviati sono esclusi di default, ma puoi scegliere di includerli.
🔷 Nota: La ricerca è in fase di rilascio graduale, quindi non è ancora disponibile in tutti gli spazi di lavoro. Se l'endpoint di ricerca o lo strumento di ricerca MCP non funzionano per te, il tuo spazio di lavoro non l'ha ancora ricevuto.
Per l'elenco completo dei parametri di ricerca e richieste di esempio, segui la guida Search gammas nella documentazione per sviluppatori su developers.gamma.app/management/search-gammas.
A cosa posso usare l'API?
Sfrutta la Gamma API per piattaforme di automazione come Make, Zapier, Workato e altri strumenti di flusso di lavoro. Puoi anche costruire applicazioni personalizzate con integrazione diretta nel codice backend per alimentare le tue app, generare presentazioni in massa creando più presentazioni programmaticamente o creare contenuti personalizzati su larga scala.
🔷 Nota: Il tuo inputText dovrebbe contenere il contenuto effettivo che vuoi sulle tue slide, non istruzioni su come creare la presentazione. I Temi devono essere pre-creati in Gamma e referenziati tramite ID. Non possono essere creati tramite inputText.
Supporto Modelli
Poiché "templates" significa cose diverse per utenti diversi, ecco cosa è disponibile.
Temi visivi: Puoi definire l'aspetto delle tue presentazioni creando temi personalizzati in Gamma, poi referenziandoli nell'API usando il loro ID tema. Usa la List Temi API (GET /v1.0/themes) per ottenere gli ID temi disponibili.
Modelli di struttura contenuti: Stiamo lavorando per aggiungere supporto rigoroso alla struttura dei contenuti in aggiornamenti futuri.
Ottenere aiuto e supporto
Documentazione e risorse
Per riferimento tecnico completo, visita la documentazione API Reference. Puoi anche consultare la nostra Landing Page per una panoramica e guida introduttiva. L'accesso API è incluso con abbonamenti Pro, Ultra, Teams e Business.
Aiuto per il debug
Quando hai bisogno di aiuto con problemi API, consulta la nostra documentazione errori per problemi comuni e soluzioni, poi contatta il Supporto Clienti. Includi sempre il x-request-id dalla risposta API quando chiedi aiuto.
Ogni risposta API include questo identificatore unico negli header. Per utenti Make.com, lo trovi sotto Output → Bundle → Headers. Per Zapier, controlla la sezione Run Details → Data Out nella Cronologia Attività per esecuzioni riuscite, o la scheda Logs → Response information (espandi header) per richieste fallite.
💎 Consiglio Pro: Includi sempre il tuo request ID, il messaggio di errore esatto e un esempio del corpo della richiesta quando chiedi supporto.
Ambito del supporto
Possiamo aiutare con
Possiamo aiutare con problemi API specifici di Gamma, problemi di autenticazione e chiave API, comprensione dei messaggi di errore, domande sui limiti di velocità e domande sull'uso dei crediti.
Non possiamo aiutare con
Non possiamo fare debug o scrivere codice personalizzato, costruire flussi di lavoro completi in Zapier, Make o N8N, fare debug di applicazioni personalizzate, fornire indicazioni sull'uso di Zapier, Make o N8N, o progettare architetture personalizzate.
Quando richiedi aiuto per l'API, fornisci il tuo request ID, il messaggio di errore, un esempio del corpo della richiesta e quale piattaforma di automazione stai usando.
Codici di errore comuni
401 Unauthorized: Chiave API non valida. Assicurati di usare l'header X-API-KEY (non Authorization o Bearer).
403 Forbidden: Controlla il saldo crediti e assicurati che la ricarica automatica sia abilitata.
429 Too Many Requests: Hai raggiunto il limite di velocità. Contatta il supporto Slack per opzioni di capacità superiore.
422 Failed: La generazione non è riuscita. Controlla i parametri di input.
Hai bisogno di aiuto per iniziare?
Per la risoluzione di problemi di base e problemi API comuni, consulta la nostra guida completa alla risoluzione dei problemi. Puoi anche consultare la nostra documentazione completa per sviluppatori per riferimento API dettagliato ed esempi.
FAQ e problemi comuni
Posso condividere le mie chiavi API con altri?
Le chiavi API devono essere mantenute sicure e non condivise.
Genera chiavi separate per diversi casi d'uso se necessario.
Perché non posso copiare di nuovo la mia chiave API?
Per motivi di sicurezza, le chiavi API vengono mostrate solo una volta quando generate.
Se perdi la tua chiave, dovrai generarne una nuova.
Posso generare più chiavi API?
Sì, puoi creare più chiavi API per diversi progetti o casi d'uso tramite le impostazioni del tuo account.
Quali gammas appaiono nei risultati di ricerca API o MCP?
La ricerca restituisce solo i gammas a cui hai già accesso, quindi non espone mai contenuti che non puoi aprire in Gamma.
I risultati sono ordinati per rilevanza, con la corrispondenza più vicina alla tua query per prima.
I gammas archiviati sono esclusi a meno che tu non scelga di includerli.
Puoi anche filtrare per creatore e per quando un gamma è stato aggiornato l'ultima volta.
Perché la ricerca non funziona nel mio workspace?
La ricerca nei tuoi gammas è in fase di rilascio graduale e non è ancora abilitata per tutti gli spazi di lavoro.
Se non è disponibile, contatta il Supporto Clienti e includi il tuo
x-request-idcosì possiamo controllare il tuo workspace.
Cosa succede se esaurisco i crediti?
Abilita la ricarica automatica nelle impostazioni di billing su gamma.app/settings/billing per garantire accesso API senza interruzioni.
Dove appaiono le presentazioni generate dall'API nella dashboard Gamma?
Le presentazioni create tramite l'API appaiono nella sezione API Generated della dashboard Gamma, non nella tua lista principale di Gammas (Tutti, Visti di recente o Creati da te).
Per far apparire una presentazione generata dall'API nella tua lista regolare di Gammas, aprila e seleziona Duplicate. Il duplicato è trattato come un gamma standard creato via web e apparirà in tutte le viste usuali.