Limiti di frequenza

I limiti di frequenza sono restrizioni che la nostra API impone sul numero di volte in cui un utente o un client può accedere ai nostri servizi entro 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 affidabile! Pensa ai limiti di frequenza come a dei buttafuori amichevoli: si assicurano che nessuno possa sovraccaricare la nostra API con troppe richieste in una sola volta. Questo aiuta a proteggere il nostro servizio da possibili abusi e mantiene tutto in funzione senza intoppi.

• Per assicurarci che tutti ricevano la propria giusta quota. Proprio come condividere i giochi in un parco giochi, vogliamo assicurarci che tutti i nostri utenti abbiano pari accesso all'API. Limitando delicatamente il numero di richieste che ogni utente può effettuare, garantiamo che nessuno debba aspettare troppo a lungo il proprio turno.

• Per mantenere prestazioni rapide 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 affollata: il traffico scorre meglio quando preveniamo la congestione!

---

Come funzionano i limiti

I limiti di frequenza vengono misurati in 2 modi:

• Richieste al secondo: è il numero di richieste di rete che puoi effettuare al secondo.
• Task in coda: è 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 sue esigenze. Ecco i limiti attuali per livello:

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

• Request Hit: si verifica quando effettui troppe richieste al secondo. Riceverai una risposta 429 Too Many Requests con un messaggio Rate limit exceeded.
• Queue Hit: si verifica quando hai troppi task di generazione concorrenti in esecuzione. Riceverai una risposta 429 Too Many Requests con un messaggio NoMorePendingTasks (oppure, quando i tuoi crediti finiscono, NoMoreConcurrentTasks). Questo 429 non ha Retry-After: attendi che uno dei tuoi task termini prima di crearne un altro.

---

Header dei limiti di frequenza

Le risposte dell'API includono questi header in modo da poter regolare il ritmo delle tue richieste:

Quando Retry-After è presente, attendi quel numero di secondi prima di inviare la richiesta successiva.