> ## Documentation Index > Fetch the complete documentation index at: https://docs.venice.ai/llms.txt > Use this file to discover all available pages before exploring further. # Come funziona il catalogo dei modelli > Come Venice costruisce il catalogo dei modelli: famiglie e varianti di modelli, prezzi normalizzati per ogni modalità, livelli di privacy, la suite di prompt di riferimento e come verranno misurati prestazioni e benchmark. Il [catalogo dei modelli](https://docs.venice.ai/it/models/overview.md) viene generato ogni ora da [`GET /models`](https://docs.venice.ai/it/api-reference/endpoint/models/list). 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: | Tipo di variante | Esempio | Perché è separata | | - | - | - | | Privacy | `z-ai-glm-5-3` e `e2ee-glm-5-3-p` | La variante E2EE viene eseguita in un enclave attestato e può avere limiti diversi | | Velocità | `claude-opus-5-5` e `claude-opus-5-5-fast` | Erogazione più veloce a un prezzo più alto | | Modalità | `kling-v3-pro-text-to-video`, `-image-to-video`, `-motion-control` | Input e prezzi diversi | | Attività | `nano-banana-pro` e `nano-banana-pro-edit` | Endpoint di generazione e di modifica | 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. | Modalità | Unità nativa | Prezzo di riferimento | | - | - | - | | Testo | Per 1M di token di input e di output | **Combinato**: `(3 × input + output) / 4`, la proporzione 3:1 usata da Artificial Analysis. Lo sconto sull'input in cache è `1 − cached ÷ input`. | | Immagini | Per immagine, in base al livello di risoluzione | Prezzo per immagine al livello selezionato (1K, 2K o 4K). Le modifiche aggiungono un supplemento per immagine per gli input aggiuntivi. | | Video | Per clip, in base a risoluzione, durata e audio | Prezzo al secondo e per clip con le impostazioni selezionate, da una matrice completa di preventivi (vedi sotto). | | Text to speech | Per 1M di caratteri | Per minuto di parlato a 150 parole (circa 825 caratteri) al minuto. | | Speech to text | Per secondo di audio | Per ora di audio e per 1.000 minuti. | | Musica ed effetti sonori | Per traccia, al secondo o per fascia di durata | Per minuto di audio quando il modello lo consente; altrimenti per traccia. | | Embedding | Per 1M di token di input | Invariato. | > [!NOTE] > > I modelli di ragionamento possono consumare molti più token di output rispetto ai modelli senza ragionamento per la stessa attività, quindi il prezzo combinato ne sottostima il costo reale. È previsto un costo per attività, misurato sulle esecuzioni dei benchmark; vedi [Benchmark](#benchmarks). ### Prezzi dei video I modelli video non pubblicano i prezzi in `GET /models`. In fase di build, Venice chiama [`POST /video/quote`](https://docs.venice.ai/it/api-reference/endpoint/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 | Livello | Cosa significa | | - | - | | **E2EE** | I prompt vengono cifrati sul tuo dispositivo e decifrati solo all'interno di un enclave hardware attestato. Vedi [Modelli TEE ed E2EE](https://docs.venice.ai/it/guides/features/tee-e2ee-models.md). | | **TEE** | L'inferenza viene eseguita in un enclave hardware con attestazione crittografica. | | **Private** | Erogato su infrastruttura controllata da Venice, senza alcuna conservazione dei dati. | | **Anonymized** | Inoltrato tramite proxy al laboratorio upstream senza la tua identità. Il laboratorio potrebbe conservare i prompt. | 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. | Modalità | Prompt | | - | - | | Immagini | Testo nell'immagine, fotorealismo, aderenza alle istruzioni, stile illustrativo | | Video | Paesaggio cinematografico, loop senza interruzioni, scena urbana cinematografica | I modelli senza render mostrano **Render di riferimento in arrivo**. ## Prestazioni > [!NOTE] > > Non ancora pubblicate. Questa sezione descrive ciò che mostrerà il catalogo. Venice misurerà i modelli con sonde sintetiche, mai con i prompt dei clienti, e pubblicherà: | Modalità | Metriche | | - | - | | Testo | Uptime, tempo al primo token, token di output al secondo, tempo per una risposta di 500 token, tasso di cache hit, tasso di successo | | Immagini | Uptime, tempo di generazione di un'immagine 1K (p50 e p95), tasso di successo | | Video | Uptime, tempo in coda e tempo di generazione per una clip di 5 secondi a 720p (riportati separatamente), tasso di successo | | Audio | Uptime, tempo al primo audio, fattore di velocità, tasso di successo | | Embedding | Uptime, latenza per un input di 1K token, tasso di successo | 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 > [!NOTE] > > Non ancora pubblicati. Questa sezione descrive ciò che mostrerà il catalogo. 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. | Modalità | Set principale previsto | | - | - | | Testo | Artificial Analysis Intelligence Index, più Humanity's Last Exam, Terminal-Bench, τ³-bench, AA-LCR, IFBench, AA-Omniscience e un Venice Openness Score | | Immagini | Elo di preferenza umana dalle arene di Artificial Analysis e LMArena, GenEval 2 e un tasso di rifiuti eccessivi | | Video | Elo text-to-video (con e senza audio) e image-to-video di Artificial Analysis, text-to-video di LMArena | | Text to speech | Elo della Speech Arena di Artificial Analysis, word error rate, tempo al primo audio | | Speech to text | Word error rate di Artificial Analysis, Open ASR Leaderboard, fattore di velocità | | Musica | Music Arena di Artificial Analysis (strumentale e con voce) | | Embedding | MTEB Multilingual, RTEB e un set di retrieval riservato di Venice | 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`](https://docs.venice.ai/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`](https://docs.venice.ai/it/api-reference/endpoint/models/list). | Campo | Contenuto | | - | - | | `version` | Versione dello schema, attualmente `1` | | `generatedAt` | Ora ISO 8601 dell'ultima build che ha modificato i dati | | `counts` | Totali di modelli e famiglie, complessivi e per modalità | | `providers` | Produttori di modelli indicizzati per slug, con `name` e `logo` | | `families` | Array di famiglie: `slug`, `name`, `modality`, `task`, `provider`, `description`, `primary` (l'ID della variante predefinita), `variants` (ID di modello), `created` e `updated` (secondi Unix), `privacy` (tutti i livelli offerti), `uncensored` e `openWeights` | | `models` | Oggetto indicizzato per ID di modello: `name`, `type` (come in `GET /models`), `modality`, `task`, `variant`, `provider`, `family` (lo slug della sua famiglia), `privacy`, un blocco di limiti e capacità con il nome della modalità (`text`, `image`, `video`, `audio` o `embedding`), `pricing` nell'unità nativa, `headline` (il prezzo di riferimento descritto sopra) e `media` (render di riferimento) | | `benchmarks` | Definizioni dei benchmark; `null` finché i benchmark non vengono pubblicati | | `mediaSuite` | La suite di prompt di riferimento, per modalità | 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`](https://docs.venice.ai/it/api-reference/endpoint/models/list) per specifiche, capacità e prezzi. * [`POST /video/quote`](https://docs.venice.ai/it/api-reference/endpoint/video/quote) per i prezzi dei video. * [`GET /models/traits`](https://docs.venice.ai/it/api-reference/endpoint/models/traits) per i valori predefiniti come `default_code`. I prezzi sono in USD. DIEM viene fatturato alla pari. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.