Limiti di frequenza

I limiti di frequenza sono restrizioni che la nostra API impone sul numero di volte che un utente o un client può accedere ai nostri servizi all'interno di un periodo di tempo specificato.

Perché i limiti

Abbiamo introdotto limiti di frequenza sulla nostra API per contribuire a creare la migliore esperienza per tutti. Ecco perché sono importanti:

Per mantenere il nostro servizio sicuro e stabile! Pensa ai limiti di frequenza come a dei simpatici buttafuori: si assicurano che nessuno possa sovraccaricare la nostra API con troppe richieste contemporaneamente. Questo aiuta a proteggere il nostro servizio da un possibile uso improprio e mantiene tutto in funzione senza intoppi.
Per assicurarci che tutti ottengano la loro giusta parte. Proprio come condividere i giocattoli in un parco giochi, vogliamo assicurarci che tutti i nostri utenti abbiano accesso equo all'API. Limitando delicatamente il numero di richieste che ciascun utente può effettuare, garantiamo che nessuno debba aspettare troppo il proprio turno.
Per mantenere le prestazioni veloci e affidabili. Gestendo il flusso complessivo delle richieste, possiamo mantenere tempi di risposta rapidi e un servizio stabile per tutti i nostri fantastici utenti. È come assicurarsi che un'autostrada non diventi troppo congestionata: il traffico scorre meglio quando preveniamo la congestione!

Come funzionano i limiti

I limiti di frequenza sono misurati in 2 modi:

Richieste al secondo: questo è il numero di richieste di rete che puoi effettuare al secondo.
Task in coda: questo è il numero di task di generazione concorrenti che puoi eseguire in coda in un dato momento.

I task in coda includono gli endpoint Testo in 3D, Immagine in 3D, Testo in texture e Remesh. Altri endpoint come Upload e Balance non sono inclusi in questo limite.

I limiti vengono applicati su base per account. Ciò significa che i limiti sono condivisi tra tutte le tue API key.

Oltre ai limiti di frequenza, anche la priorità di elaborazione dei task influisce sulla velocità dei tuoi task.

Ogni livello utente ha limiti di frequenza e livelli di priorità specifici progettati per adattarsi alle proprie esigenze. Ecco i limiti attuali per livello:

Livello utente	Richieste al secondo	Task in coda	Livello di priorità
Pro	20	10	Predefinito
Premium	20	30	Superiore a Pro
Ultra	20	100	Massimo
Studio	20	20	Superiore a Pro
Enterprise	100	Predefinito a 100, personalizzabile	Massimo

Se superi questi limiti, riceverai una risposta 429 Too Many Requests dalla nostra API. Ci sono due tipi di eventi che possono attivare questa risposta, ciascuno con una risposta diversa:

Request Hit: questo accade quando effettui troppe richieste al secondo. Riceverai una risposta 429 Too Many Requests con un messaggio RateLimitExceeded.
Queue Hit: questo accade quando hai troppi task di generazione concorrenti in esecuzione. Riceverai una risposta 429 Too Many Requests con un messaggio NoMoreConcurrentTasks.