Limiti di frequenza

I limiti di frequenza sono restrizioni che la nostra API impone al 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 nella 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 contemporaneamente. Questo aiuta a proteggere il nostro servizio da potenziali usi impropri e mantiene tutto fluido.

  • Per assicurarci che tutti abbiano la loro giusta quota. Proprio come condividere i giocattoli in un parco giochi, vogliamo assicurarci che tutti i nostri utenti abbiano pari accesso all'API. Limitando con delicatezza il numero di richieste che ogni utente può effettuare, ci assicuriamo che nessuno debba aspettare troppo a lungo 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 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: questo è il numero di richieste di rete che puoi effettuare al secondo.
  • task in coda: questo è il numero di task di generazione simultanei 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 saldo non sono inclusi in questo limite.

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

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

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

Livello utenterichieste al secondotask in codaLivello di priorità
Pro2010Predefinito
Studio2020Superiore a Pro
Enterprise100Predefinito a 50, può essere personalizzatoMassimo

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

  • Evento richiesta: si verifica quando effettui troppe richieste al secondo. Riceverai una risposta 429 Too Many Requests con un messaggio RateLimitExceeded.
  • Evento coda: si verifica quando hai troppi task di generazione simultanei in esecuzione. Riceverai una risposta 429 Too Many Requests con un messaggio NoMoreConcurrentTasks.