Cos'è la Gamma API?
Hai una presentazione che ti piace? E se potessi crearne altre 100 simili, 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 backend.
E se sei uno sviluppatore, puoi integrare Gamma nella tua applicazione per darle superpoteri di design!
💎 Consiglio Pro: Chiunque può accedere all'API oggi con qualsiasi piano, incluso Free, con limiti di utilizzo generosi.
L'API è pronta?
La Gamma API v1.0 è stata Generally Available (GA) dal 5 novembre 2025. Chiunque può accedere all'API oggi con qualsiasi piano 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: Generare una chiave API
Vai su Impostazioni and Membri nel tuo account, poi nella 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 integra 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.
🌀 Insight: 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 può fare l'API
La Gamma API copre l'intero ciclo di vita di una gamma, dalla creazione all'esportazione.
Generare contenuti: Crea presentazioni, documenti, pagine web e post social dal tuo testo.
Crea da modello: Genera nuove gammas da un modello che hai creato in Gamma, mantenendo il layout e la struttura delle schede.
Modifica gammas esistenti: POST /v1.0/agent/gammas/{gammaId}/edits applica una modifica in linguaggio naturale a una pagina.
Generazione agent: POST /v1.0/agent/generations avvia una generazione da un modello workspace, una gamma esistente o un modello ufficiale Gamma.
Leggi, esporta e analizza gammas esistenti: Endpoint per ottenere, commenti, esportazione e analisi.
Generazione immagine standalone: Genera immagini singole separatamente da una gamma completa.
Formato pagina web: Genera pagine web oltre a presentazioni, documenti e post social.
Personalizzazione intestazioni e piè di pagina: Personalizza intestazioni e piè di pagina dei tuoi contenuti.
URL immagine in input: Riferisci immagini direttamente nel tuo contenuto.
Organizzazione Cartelle: Organizza i contenuti generati in Cartelle.
Condivisione via email: Condividi contenuti via email programmaticamente.
API di elenco: Endpoint per elencare i tuoi Temi e Cartelle.
Cerca gammas: Cerca nei titoli e nel testo completo dei gammas a cui puoi accedere e filtra i risultati prima di aprirli.
Limiti di input generosi: Fino a 100.000 token (circa 400.000 caratteri).
Posso generare immagini standalone con l'API?
Puoi generare immagini standalone con la Gamma 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. La generazione di immagini tramite MCP è disponibile in Claude, ChatGPT e altri client MCP.
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 collegarsi 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, così il risultato più vicino appare per primo. 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.
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 workflow. 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é "modelli" significa cose diverse per utenti diversi, ecco cosa è disponibile.
Temi visivi: Puoi definire l'aspetto delle tue presentazioni creando temi personalizzati in Gamma, quindi facendo riferimento a essi nell'API usando il loro ID tema. Usa l'API List Themes (GET /v1.0/themes) per ottenere gli ID tema disponibili.
Modelli di struttura del contenuto: Usa Create from template. Crea un modello in Gamma, quindi chiama POST /v1.0/generations/from-template con il suo ID e un prompt. Il layout e la struttura delle schede del modello sono mantenuti di default, e il tuo prompt modifica il contenuto, il pubblico o la lingua. I modelli devono essere gammas a pagina singola dal tuo workspace (una pagina può contenere molte schede). Trova gli ID modello con GET /v1.0/templates/search.
Generazione agente: POST /v1.0/agent/generations può anche partire da un modello workspace, un gamma esistente o un modello ufficiale Gamma (templateId).
Ottenere Aiuto e Supporto
Documentazione e risorse
Per riferimento tecnico completo, visita la documentazione per sviluppatori. L'accesso API è incluso in tutti i piani, incluso Free.
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 Supporto Clienti. Includi sempre il x-request-id dalla 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 ID richiesta, 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 ID richiesta, 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'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 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 rivedere la nostra documentazione completa per sviluppatori per riferimenti API dettagliati ed esempi.
FAQ e Problemi Comuni
Posso modificare un gamma esistente con l'API?
Sì.
POST /v1.0/agent/gammas/{gammaId}/editsapplica un'istruzione in linguaggio naturale a una pagina di un gamma che puoi modificare, per esempio "aggiorna la scheda prezzi con le nuove fasce."Interroga
GET /v1.0/agent/edits/{editId}per il risultato.Le Modifica non possono aggiungere pagine, e solo una Modifica può essere eseguita su una pagina alla volta.
La stessa funzionalità è disponibile in Claude, ChatGPT, Slack e altri client MCP.
Il mio agente AI può usare Gamma?
Sì. Collega qualsiasi client MCP a
https://mcp.gamma.app/mcpe accedi con il tuo account Gamma. Funziona su ogni piano.I client personalizzati devono prima registrare i loro URI di reindirizzamento OAuth.
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 sono mostrate solo una volta quando vengono 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 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.Editor: elimina questa FAQ se la ricerca è confermata al 100%.
Cosa succede se esaurisco i crediti?
Abilita la ricarica automatica nelle tue impostazioni di billing 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 (All, Recently Viewed, o Created by You).
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.