# Limiti

## 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](/contact) 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 |
