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 workflow, 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 o token superati.
Per
from-template: il modello deve essere un workspace gamma a pagina singola. I Modelli Explore ufficiali e i gamma multipagina vengono rifiutati.
Controlla 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/api-keys.
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.
Passa a un piano di livello superiore.
404 Not Found
ID generazione o gamma non valido
L'ID generazione non esiste o appartiene a un altro utente. Questo errore viene restituito anche per un ID gamma a cui non puoi accedere durante la lettura, modifica o esportazione di un gamma esistente.
Verifica di utilizzare il corretto generationId dalla risposta POST, o che tu abbia accesso al gamma che stai mirando.
422 Failed
Generazione non completata
La generazione ha prodotto un output vuoto.
Controlla la tua richiesta:
Assicurati che
inputTextabbia contenuto sufficiente.Verifica 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à. I limiti sono impostati per proprietario della chiave API e per workspace, e i valori attuali sono documentati nel riferimento ai codici di errore.
🔷 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 interno del server imprevisto
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, e rinominare la presentazione non cambia come viene categorizzata.
Soluzione alternativa: Apri la presentazione e seleziona Duplicate. Il duplicato è trattato come un gamma creato regolarmente via web e apparirà nella tua lista principale Gammas.
Hai ancora bisogno di aiuto?
Supporto generale: Come contattare il supporto Gamma.
Comunità API: Unisciti al Gamma API Slack.
Problemi SSO: Contatta l'amministratore IT della tua organizzazione.