Limiti di frequenza

Verifica quante richieste e attività consente il tuo piano, e cosa fare quando raggiungi un limite.

Limiti per piano

Per mantenere l'API veloce e disponibile per tutti, Meshy limita ogni account in due modi:

Richieste al secondo: quante richieste API puoi inviare ogni secondo.
Attività simultanee: quante delle tue attività possono essere PENDING o IN_PROGRESS contemporaneamente.

I limiti dipendono dal tuo piano:

Piano	Richieste al secondo	Attività simultanee	Priorità
Pro	20	10	Predefinita
Premium	20	30	Superiore a Pro
Ultra	20	100	Massima
Studio	20	60, o 20 su alcuni piani Studio precedenti	Superiore a Pro
Enterprise	100	100 per impostazione predefinita, o un limite personalizzato	Massima

La priorità non è un limite. Quando la coda è occupata, Meshy avvia per prime le attività con priorità più alta.

Cosa conta ai fini di ciascun limite

Ogni richiesta API conta ai fini delle richieste al secondo, incluse le richieste che ottengono, elencano o trasmettono in streaming le attività. Le richieste provenienti dall'app web di Meshy non contano.

Il limite di attività simultanee conta le attività, non le richieste. Ogni endpoint che crea un'attività verifica questo limite prima di crearne una. Ad esempio, Testo in 3D, Immagine in 3D, Multi-immagine in 3D, Retexture, Remesh, Rigging, Animazione, Testo in immagine, gli endpoint di stampa 3D e Creative Lab lo verificano.

Le richieste che non creano un'attività non contano ai suoi fini. Ad esempio, Balance, Usage, e le richieste che ottengono, elencano o trasmettono in streaming le attività non contano.

A chi si applicano i limiti

La tabella seguente mostra a chi si riferiscono i limiti delle tue chiavi API, del Playground e dell'app web:

Dove lavori	Account personale	Team
Chiavi API	I tuoi limiti	I limiti del team, condivisi da ogni chiave API nel team
Playground	I tuoi limiti	I tuoi limiti personali come membro autenticato
App web	Le tue attività simultanee	Le tue attività simultanee personali. Anche le attività avviate dal proprietario del team contano ai fini dei limiti del team.

Quando raggiungi un limite

Quando superi un limite, l'API restituisce 429 Too Many Requests. Il messaggio indica quale limite hai raggiunto:

Troppe richieste al secondo: il messaggio è Rate limit exceeded. Attendi il numero di secondi indicato nell'header Retry-After, quindi riprova.
Troppe attività simultanee: il messaggio inizia con NoMorePendingTasks. Su un piano illimitato senza crediti rimasti, inizia con NoMoreConcurrentTasks. Questo 429 non ha un header Retry-After. Attendi che una delle tue attività termini, quindi creane una nuova.

Header del limite di frequenza

Le risposte dell'API includono questi header per aiutarti a regolare il ritmo delle tue richieste:

Header	Descrizione
`X-RateLimit-Limit`	Richieste consentite al secondo sul tuo piano.
`X-RateLimit-Remaining`	Richieste rimanenti nel secondo corrente.
`X-RateLimit-Reset`	Secondi mancanti prima che il tuo budget torni pieno.
`Retry-After`	Secondi da attendere prima della prossima richiesta. Inviato con un `429` per troppe richieste al secondo, e quando ottieni un'attività ancora `PENDING` o `IN_PROGRESS`.

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