Guide
Registro delle modifiche dell'API
Tutte le modifiche apportate all'API per sviluppatori, in ordine cronologico (dalle più recenti alle più vecchie).
Gli esempi di codice, gli endpoint e i codici di errore sono gli stessi in ogni linguaggio.
Modifiche all'API per sviluppatori, in ordine cronologico (dalle più recenti alle più vecchie). I formati esistenti delle richieste e delle risposte non subiscono modifiche senza preavviso in questa sezione; a questi si aggiungono nuovi campi e endpoint.
19 novembre 2026
- Novità: prove asincrone:
POST /api/v1/generationsrestituisce immediatamente un’attività; è possibile consultarla all’indirizzoGET /api/v1/generations/:id. Documentazione - Novità: lotti fino a 500 prove di abbigliamento da URL di immagini:
POST /api/v1/batches,GETeDELETE /api/v1/batches/:id(gli articoli annullati vengono rimborsati). Documentazione - Novità: webhook firmati
generation.completed,generation.failedebatch.completed, per richiesta (webhook_url) o come endpoint dell'account con selezione degli eventi e un evento di prova in Chiavi API > Webhook. Documentazione - Novità:
GET /api/v1/results/:idconsente di scaricare un risultato salvato associato alla propria chiave. I risultati asincroni vengono conservati per 7 giorni. - Novità: il comando
DELETE /api/v1/customers/:customer_idcancella i risultati e i record memorizzati relativi a un singolo utente finale. Il parametrocustomer_idè supportato nelle operazioni/generate,/generationse nelle operazioni in batch. Documentazione - Novità: limite di credito mensile e data di scadenza per ogni chiave, impostati al momento della creazione della chiave. Superamento del limite:
402 KEY_LIMIT_REACHED. Documentazione - Novità: modalità di prova (
?mock=true) per i processi asincroni e i batch (fino a 10 elementi), gratuita. - Più veloce: l'analisi del capo viene memorizzata nella cache per 30 giorni, quindi quando si ripete la prova dello stesso prodotto si risparmiano circa 2 secondi.
- Dashboard: ricerca per generazioni in base all’ID cliente o all’ID richiesta, filtro per periodo, visualizzazione in tempo reale ed esportazione in formato CSV. La panoramica mostra il tempo mediano e il tempo al 95° percentile, oltre alla durata residua del credito.
- Sicurezza: i webhook vengono inviati solo a indirizzi pubblici verificati al momento della connessione, senza mai seguire i reindirizzamenti.
18 novembre 2026
- Novità: intestazione
Idempotency-Keynell'POST /api/v1/generate; i tentativi non vengono mai addebitati due volte. Documentazione - Novità:
X-Request-Idin ogni risposta (erequest_idnei corpi delle risposte di errore), oltre aX-RateLimit-LimiteX-RateLimit-Remaining. - Novità: specifica OpenAPI 3.1 all'indirizzo
https://www.tryoncloud.com/api/v1/openapi.json. - Novità: dati relativi al servizio pubblico disponibili all'indirizzo
GET /api/v1/statuse nella pagina di stato. - Documentazione: risoluzione di uscita dichiarata: circa 1 megapixel (classe 1K).
14 novembre 2026
- Novità: l'intestazione webhook
x-tryoncloud-signature-v2, che firma il timestamp insieme al corpo del messaggio, in modo che le consegne non conformi possano essere rifiutate. L'intestazionex-tryoncloud-signaturerimane invariata. Documentazione - Modifica: i limiti di frequenza vengono ora applicati su tutti i server, con un limite a livello di account di 600 richieste di generazione al minuto e un limite separato per la modalità di prova. Documentazione
- Novità:
GET /api/v1/creditsper verificare il numero di prove rimanenti con la tua chiave API. Documentazione - Novità: server MCP all'indirizzo
https://www.tryoncloud.com/api/mcpper Claude Code, Cursor e VS Code. Documentazione - Novità: JavaScript/TypeScript SDK. Documentazione
- Novità: modalità di prova gratuita,
?mock=trueoX-Mock: true. Documentazione - Novità:
DELETE /api/v1/results/:idper cancellare anticipatamente un risultato salvato. Documentazione - Modifica: il prezzo per le aziende (5.000+ prove) è stato ridotto da 0,08 $ a 0,07 $. In India rimane a 6,50 ₹.
- Modifica: i download relativi a
garment_urlvengono ora controllati ad ogni reindirizzamento e al momento della connessione; gli indirizzi interni, privati e relativi ai metadati cloud vengono rifiutati. - Documentazione: nuovi documenti multipagina con versioni in Markdown di ogni pagina, un Accordo sul trattamento dei dati e un’autorizzazione alla rivendita inclusa nei Termini.
12 novembre 2026
- Modificato: nuovi prezzi per ogni fascia: 50+ 0,11 $, 300+ 0,10 $, 1.000+ 0,09 $, 5.000+ 0,08 $.
- Novità: chiavi API con nome, fino a 5 attive, date dell'ultimo utilizzo, revoca una alla volta.
5 novembre 2026
- Modificato:
POST /generaterestituisce sempreimage/png, in linea con ilContent-Typedocumentato.