Come funziona il catalogo dei modelli

Il catalogo dei modelli viene generato ogni ora da GET /models. Questa pagina spiega come vengono ricavati i numeri che contiene, così puoi riprodurli e sapere cosa significano e cosa no.

​

Famiglie e varianti

Molti ID di modello corrispondono allo stesso modello offerto in modo diverso. Il catalogo li raggruppa in un’unica pagina di famiglia: Ogni variante mantiene il proprio ID di modello, prezzo e livello di privacy. Passa l’ID della variante come model. Gli snapshot datati come deepseek-v4-flash-0731 restano famiglie separate e compaiono in Altre versioni.

​

Prezzi normalizzati

Ogni modalità viene fatturata nella propria unità. Il catalogo mostra l’unità nativa e un prezzo di riferimento, così i modelli possono essere ordinati e confrontati.

​

Prezzi dei video

I modelli video non pubblicano i prezzi in GET /models. In fase di build, Venice chiama POST /video/quote per ogni combinazione di risoluzione × durata × audio supportata da ciascun modello, con il primo rapporto d’aspetto elencato (il rapporto d’aspetto non modifica il prezzo). Il catalogo memorizza la matrice completa e ne ricava:

• Al secondo: la mediana di price ÷ seconds tra le durate, a una data risoluzione e impostazione audio. Per quasi tutti i modelli i prezzi sono lineari rispetto alla durata.
• Clip bozza: 5 secondi, 720p, senza audio.
• Clip di produzione: 10 secondi, 1080p, con audio.

Quando un modello non offre l’impostazione richiesta, il catalogo usa quella più vicina tra quelle supportate e contrassegna il prezzo. Le modalità di modifica, motion control e upscale vengono fatturate in base alla durata del video sorgente, quindi mostrano In base alla sorgente invece di un prezzo. Chiama sempre POST /video/quote prima di mettere in coda per ottenere l’importo esatto.

​

Livelli di privacy

Una famiglia elenca tutti i livelli offerti dalle sue varianti. Filtrando per livello viene mostrata la variante di quel livello, con il suo prezzo.

​

Suite di prompt di riferimento

I modelli di immagini e video vengono renderizzati su una suite di prompt fissa, gli stessi prompt per ogni modello di una modalità, con le impostazioni predefinite. È questo che rende la galleria dell’explorer confrontabile da un modello all’altro. I modelli senza render mostrano Render di riferimento in arrivo.

​

Prestazioni

Venice misurerà i modelli con sonde sintetiche, mai con i prompt dei clienti, e pubblicherà: Ogni dato mostrerà la sua finestra temporale (30 giorni mobili per l’uptime, 7 giorni per la latenza), il percentile, il numero di campioni e la regione della sonda. L’uptime esclude gli errori 4xx causati dalla richiesta. Il tasso di cache hit è cache_read ÷ (input + cache_read + cache_write) su tutto il traffico. I modelli con troppo pochi campioni saranno contrassegnati come Preliminare.

​

Benchmark

I benchmark sono scelti per la frontiera: ancora discriminanti ai vertici, resistenti alla contaminazione ed eseguibili sul modello così come lo eroga Venice. Ogni punteggio avrà un’unica etichetta di provenienza, senza mai fare medie tra fonti diverse:

• Verificato da Venice: eseguito sull’endpoint Venice mostrato nella pagina.
• Indipendente: eseguito da terze parti, di solito sull’API del laboratorio stesso.
• Dichiarato dal laboratorio: pubblicato dal creatore del modello.

Ogni punteggio mostra anche la versione del benchmark e dell’harness, il reasoning effort, la data del test e un intervallo di confidenza. I punteggi più vecchi di 90 giorni, o superati da una nuova versione del benchmark, vengono segnalati come obsoleti. Il set viene rivisto ogni trimestre. Un benchmark diventa un controllo di soglia minima, e non più un riferimento principale, quando i modelli di frontiera lo saturano o non supera un audit di contaminazione.

​

Dati leggibili dalle macchine

Il catalogo alla base di queste pagine è pubblicato in formato JSON all’indirizzo /data/model-catalog.json e viene ricostruito a ogni sincronizzazione oraria. È adatto a confronti, analisi e agenti; per scegliere un modello a runtime, chiama GET /models. I campi senza valore vengono omessi. I prezzi sono in USD.

​

Fonti dei dati

Il catalogo è costruito a partire da endpoint pubblici che puoi chiamare anche tu:

• GET /models per specifiche, capacità e prezzi.
• POST /video/quote per i prezzi dei video.
• GET /models/traits per i valori predefiniti come default_code.

I prezzi sono in USD. DIEM viene fatturato alla pari.