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
| Endpoint | Limite | In caso di superamento |
|---|---|---|
POST /generate | 300 richieste al minuto per chiave API, 600 al minuto per account | 429 RATE_LIMITED con Retry-After |
Modalità di test (mock=true) | 30 richieste al minuto e 500 al giorno per ogni account | 429 RATE_LIMITED con Retry-After |
GET /credits | 60 richieste al minuto per chiave API | 429 RATE_LIMITED |
| Chiamate alle funzioni MCP | 60 al minuto per chiave API | Risultato dell'errore |
DELETE /results/:id, DELETE /customers/:id, DELETE /batches/:id | 120 richieste al minuto per ogni chiave API | 429 RATE_LIMITED |
GET /results/:id, GET /generations/:id, GET /batches/:id | 300 richieste al minuto per ogni chiave API | 429 RATE_LIMITED |
POST /generations, POST /batches | Viene conteggiato ai fini del limite di 300 generazioni al minuto | 429 RATE_LIMITED |
| Processi asincroni in esecuzione contemporaneamente | 50 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
| Limite | Valore |
|---|---|
| Formati | JPEG, PNG, WebP, HEIC (verifica in base al contenuto, non al nome del file) |
| Dimensione massima | 15 MB per immagine |
garment_url | URL pubblico https sulla porta 443 o 80. Gli indirizzi interni, privati e relativi ai metadati cloud sono bloccati, anche tramite reindirizzamenti |
| Risultato | Un 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 tipica | Mediana di circa 19 secondi, il 90% rientra in circa 24 secondi (traffico di produzione degli ultimi 30 giorni) |
| Tempo massimo di richiesta | 120 secondi. Imposta il timeout del client su 120 secondi |
| Capo di abbigliamento ripetuto | L'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
| Acquista | Qualsiasi importo compreso tra 50 e 100.000 per ordine |
| Scadenza | Mai |
| Prova di abbigliamento non andata a buon fine | Rimborsato automaticamente |
| Limite mensile per chiave | Opzionale, 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 chiave | Data facoltativa; la chiave smette di funzionare dopo quel giorno (UTC) |
Operazioni asincrone e elaborazioni in batch
| Dimensione del lotto | Fino a 500 articoli (10 in modalità di prova) |
| Risultati | Conservati per 7 giorni, poi cancellati |
| Risposta del webhook | Rispondere con 2xx entro 8 secondi; le altre risposte vengono riprovate per un massimo di un giorno |
| URL dei webhook | https pubblico sulla porta standard; i reindirizzamenti non vengono seguiti |
| Prova webhook | Fino a 5 al minuto dalla dashboard |