Search docs

Search the TryOnCloud API docs

Riferimento API

Limiti

Limiti di frequenza, limiti di immagini, timeout e velocità.

Gli esempi di codice, gli endpoint e i codici di errore sono gli stessi in ogni linguaggio.

Limiti di frequenza

EndpointLimiteIn caso di superamento
POST /generate300 richieste al minuto per chiave API, 600 al minuto per account429 RATE_LIMITED con Retry-After
Modalità di test (mock=true)30 richieste al minuto e 500 al giorno per ogni account429 RATE_LIMITED con Retry-After
GET /credits60 richieste al minuto per chiave API429 RATE_LIMITED
Chiamate alle funzioni MCP60 al minuto per chiave APIRisultato dell'errore
DELETE /results/:id, DELETE /customers/:id, DELETE /batches/:id120 richieste al minuto per ogni chiave API429 RATE_LIMITED
GET /results/:id, GET /generations/:id, GET /batches/:id300 richieste al minuto per ogni chiave API429 RATE_LIMITED
POST /generations, POST /batchesViene conteggiato ai fini del limite di 300 generazioni al minuto429 RATE_LIMITED
Processi asincroni in esecuzione contemporaneamente50 per account (i lotti sono separati)429 TOO_MANY_JOBS

Il limite di generazione costituisce una misura di sicurezza contro la fuga di chiavi e i cicli fuori controllo. Le integrazioni reali non lo raggiungono. In caso di volumi sostenuti molto elevati, vi preghiamo di contattarci prima del lancio, in modo da poter pianificare la capacità necessaria.

Immagini

LimiteValore
FormatiJPEG, PNG, WebP, HEIC (verifica in base al contenuto, non al nome del file)
Dimensione massima15 MB per immagine
garment_urlURL pubblico https sulla porta 443 o 80. Gli indirizzi interni, privati e relativi ai metadati cloud sono bloccati, anche tramite reindirizzamenti
RisultatoUn file PNG per ogni richiesta, di circa 1 megapixel (classe “1K”), con formato adattato alla foto della persona. Al momento non sono disponibili risoluzioni più elevate

Ora

Generazione tipicaMediana di circa 19 secondi, il 90% rientra in circa 24 secondi (traffico di produzione degli ultimi 30 giorni)
Tempo massimo di richiesta120 secondi. Imposta il timeout del client su 120 secondi
Capo di abbigliamento ripetutoL'analisi del capo viene memorizzata nella cache per 30 giorni, quindi una nuova prova dello stesso capo, a partire dalla stessa foto, richiede circa 2 secondi in meno di preparazione

Crediti

AcquistaQualsiasi importo compreso tra 50 e 100.000 per ordine
ScadenzaMai
Prova di abbigliamento non andata a buon fineRimborsato automaticamente
Limite mensile per chiaveOpzionale, da impostare al momento della creazione della chiave. Tiene conto del mese di calendario in corso (UTC); una volta superato tale limite, alla chiave viene assegnato il codice di errore 402 KEY_LIMIT_REACHED fino al primo del mese successivo.
Scadenza della chiaveData facoltativa; la chiave smette di funzionare dopo quel giorno (UTC)

Operazioni asincrone e elaborazioni in batch

Dimensione del lottoFino a 500 articoli (10 in modalità di prova)
RisultatiConservati per 7 giorni, poi cancellati
Risposta del webhookRispondere con 2xx entro 8 secondi; le altre risposte vengono riprovate per un massimo di un giorno
URL dei webhookhttps pubblico sulla porta standard; i reindirizzamenti non vengono seguiti
Prova webhookFino a 5 al minuto dalla dashboard