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 entro un periodo di tempo specificato.

Perché i Limiti

Abbiamo messo in atto limiti di frequenza sulla nostra API per aiutare a creare la migliore esperienza per tutti. Ecco perché sono importanti:

Per mantenere il nostro servizio sicuro e protetto! Pensate ai limiti di frequenza come a dei buttafuori amichevoli - assicurano che nessuno possa sovraccaricare la nostra API con troppe richieste contemporaneamente. Questo aiuta a proteggere il nostro servizio da potenziali abusi e mantiene tutto funzionante senza intoppi.
Per garantire che tutti abbiano 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 ogni utente può fare, garantiamo che nessuno debba aspettare troppo a lungo per il proprio turno.
Per mantenere le prestazioni rapide e affidabili. Gestendo il flusso complessivo delle richieste, possiamo mantenere tempi di risposta rapidi e un servizio stabile per tutti i nostri meravigliosi utenti. È come assicurarsi che un'autostrada non diventi troppo affollata - 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 fare al secondo.
Task in Coda: Questo è il numero di task di generazione concorrenti che puoi eseguire in coda in qualsiasi 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 sono applicati su base per account. Ciò significa che i limiti sono condivisi tra tutte le tue API key.

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

Ogni livello utente ha limiti di frequenza e livelli di priorità specifici progettati per soddisfare le loro esigenze. Ecco i limiti attuali per livello:

Livello Utente	Richieste al Secondo	Task in Coda	Livello di Priorità
Pro	20	10	Default
Premium	20	30	Più alto di Pro
Ultra	20	100	Massimo
Studio	20	20	Più alto di Pro
Enterprise	100	Default a 50, può essere personalizzato	Massimo

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

Colpo di Richiesta: Questo accade quando fai troppe richieste al secondo. Riceverai una risposta 429 Too Many Requests con un messaggio RateLimitExceeded.
Colpo di Coda: Questo accade quando hai troppi task di generazione concorrenti in esecuzione. Riceverai una risposta 429 Too Many Requests con un messaggio NoMoreConcurrentTasks.