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 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 è Generally Available (GA) dal 5 novembre 2025. Chiunque abbia un account Pro o superiore può accedere oggi all'API con limiti di utilizzo generosi.
🔷 Nota: L'API v0.2 è deprecata e sarà dismessa il 16 gennaio 2026. Se stai usando v0.2, migra a v1.0 prima di questa data.
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, aggiorna a Pro per accedere all'API.
Passo 2: Genera una chiave API
Vai su Impostazioni e Membri nel tuo account Pro, poi nella scheda API key. Clicca su Crea 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 assicurare che l'API supporti ciò che stai costruendo!
Novità in 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 nel tuo contenuto.
Organizzazione in 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 autonome con l'API?
Ora puoi generare immagini autonome 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 funziona 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 reale 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 Themes API (GET /v1.0/themes) per ottenere gli ID tema disponibili.
Modelli di struttura contenuti: Stiamo lavorando per aggiungere il supporto a strutture di contenuto rigide in aggiornamenti futuri.
Ottenere Aiuto e Supporto
Documentazione e Risorse
Per un riferimento tecnico completo, visita la documentazione API Reference. Puoi anche consultare la nostra Landing Page per una panoramica e una guida introduttiva. L'accesso API è incluso con gli abbonamenti Pro, Ultra, Teams e Business.
Aiuto per il Debug
Quando hai bisogno di aiuto con problemi API, consulta la nostra documentazione sugli errori per problemi comuni e soluzioni, poi contatta il Customer Support. Includi sempre il x-request-id dalla tua risposta API quando chiedi aiuto.
Ogni risposta API include questo identificatore unico nelle intestazioni. Per gli 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 intestazioni) per richieste fallite.
💎 Consiglio Pro: Includi sempre il tuo request ID, il messaggio di errore esatto e un esempio del corpo della richiesta quando richiedi supporto.
Ambito del Supporto
Possiamo Aiutare Con
Possiamo aiutare con problemi API specifici di Gamma, problemi di autenticazione e chiavi API, comprensione dei messaggi di errore, domande sui limiti di velocità e sull'uso del credito.
Non Possiamo Aiutare Con
Non possiamo fare debug o scrivere codice personalizzato, costruire workflow 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 API, fornisci il tuo request ID, il messaggio di errore, un esempio del corpo della richiesta e la piattaforma di automazione che stai usando.
Codici di Errore Comuni
401 Unauthorized: Chiave API non valida. Assicurati di usare l'intestazione X-API-KEY (non Authorization o Bearer).
403 Forbidden: Controlla il saldo del credito e assicurati che la ricarica automatica sia abilitata.
429 Too Many Requests: Hai raggiunto il limite di velocità. Contatta il supporto Slack per opzioni con 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 comuni API, consulta la nostra guida completa alla risoluzione dei problemi. Puoi anche consultare la nostra documentazione completa per sviluppatori per riferimento API dettagliato ed esempi.
FAQs e Problemi Comuni
Posso condividere le mie chiavi API con altri?
Le chiavi API devono essere mantenute sicure e non condivise.
Generare 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 sono mostrate solo una volta quando vengono generate.
Se perdi la tua chiave, dovrai Generare 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 tra i tuoi gammas è in fase di rilascio graduale e non è ancora abilitata per ogni workspace.
Se non è disponibile, contatta il Customer Support e includi il tuo
x-request-idcosì possiamo controllare il tuo workspace.
Devo migrare da v0.2 a v1.0?
Sì, v0.2 sarà dismesso il 16 gennaio 2026.
La migrazione è semplice: aggiorna la tua base URL da
/v0.2/a/v1.0/.Cambia il parametro
themeNameinthemeId(ottieni gli ID dall'API List Themes).Aggiorna i limiti di input - v1.0 usa 100k token invece di 750k caratteri.
Consulta la documentazione API per i dettagli completi dell'endpoint v1.0.
Quali sono le principali differenze tra v0.2 e v1.0?
v1.0 offre limiti di velocità molto più generosi (centinaia all'ora contro 50 al giorno).
v1.0 include il supporto per il formato pagina web.
Limiti di input migliori (100k token contro 750k caratteri).
Organizzazione delle Cartelle e API di elenco per Temi e Cartelle.
Cosa succede se esaurisco i crediti?
Abilita la ricarica automatica nelle tue impostazioni di Fatturazione su gamma.app/settings/billing per garantire un accesso API senza interruzioni.
Dove appaiono le presentazioni generate da API nella dashboard di Gamma?
Le presentazioni create tramite API appaiono nella sezione API Generated della dashboard di Gamma, non nella tua lista principale di Gammas (Tutti, Visualizzati di recente o Creati da te).
Per far apparire una presentazione generata da API nella tua lista regolare di Gammas, aprila e seleziona Duplicate. Il duplicato è trattato come un gamma creato standard via web e apparirà in tutte le viste usuali.