Guida alla risoluzione dei problemi API Gamma
Anche se vorremmo aiutarti con tutto ciò che riguarda l'API, tieni presente che il nostro team di supporto non può creare flussi di lavoro, eseguire il debug del tuo codice backend (FastAPI, Express, Django, ecc.) o risolvere problemi specifici della piattaforma.
Possiamo aiutarti con domande specifiche su Gamma riguardo ai nostri endpoint e parametri, autenticazione API, risoluzione degli errori, crediti e verifica che la tua richiesta corrisponda alla nostra documentazione.
Per assistenza specifica della piattaforma, contatta Zapier Support, Make Support o N8N Support.
Per maggiori informazioni sull'API di Gamma, consulta: developers.gamma.app
Codici di errore comuni
400 Bad Request
Parametri non validi
Controlla la tua richiesta per:
Campi obbligatori mancanti (
inputText,textMode)Valori di parametro non validi
Limiti di caratteri/token superati
Esamina il messaggio di errore per dettagli specifici sulla validazione.
401 Unauthorized
Chiave API non valida
La tua chiave API non è valida o non è associata a un account Pro.
Verifica di utilizzare l'intestazione
X-API-KEY(non Authorization)Generare una nuova chiave API su gamma.app/settings/billing
Conferma che il tuo account abbia un piano Pro, Ultra, Teams o Business attivo
403 Forbidden
Nessun credito disponibile
Il tuo account ha esaurito i crediti API.
Risolvi questo su gamma.app/settings/billing:
Abilita la ricarica automatica (consigliato)
Acquista crediti ad hoc
Aggiorna a un piano di livello superiore
404 Not Found
ID generazione non valido
L'ID generazione non esiste o appartiene a un altro utente.
Verifica di utilizzare il corretto generationId dalla risposta POST.
422 Failed
Generazione non completata
La generazione ha prodotto un output vuoto.
Esamina la tua richiesta:
Assicurati che
inputTextabbia contenuto sufficienteControlla che i parametri siano allineati con il tuo input
Semplifica le istruzioni complesse se necessario
429 Too Many Requests
Limite di velocità superato
Hai raggiunto il limite di velocità (50 generazioni/ora).
Nota: L'API ha una capacità generosa. La maggior parte degli utenti non incontra mai questo limite nell'uso normale.
Soluzioni:
Contatta Gamma Support per una capacità maggiore
Implementa un backoff esponenziale
Distribuisci le richieste nel tempo
500 Internal Server Error
Errore imprevisto del server
Si è verificato un problema temporaneo del server.
Attendi un momento e riprova
Se persiste, contatta il supporto con il tuo
x-request-id
502 Bad Gateway
Problema temporaneo del gateway
Si è verificato un problema temporaneo di connessione.
Attendi un momento e riprova la tua richiesta.
La mia presentazione generata dall'API non è nella mia lista Gammas
Le presentazioni generate dall'API appaiono nella sezione API Generated della dashboard Gamma, non nella tua lista principale Gammas (Tutte, Visualizzate di recente o Create da te). Questo è un comportamento previsto — rinominare la presentazione non cambia la sua categoria.
Soluzione alternativa: Apri la presentazione e seleziona Duplica. Il duplicato è trattato come un gamma creato regolarmente via web e apparirà nella tua lista principale Gammas.
Serve ancora aiuto?
Supporto generale: Come contattare il supporto Gamma
Comunità API: Unisciti al Gamma API Slack
Problemi SSO: Contatta l'amministratore IT della tua organizzazione