Guide
Modelli e prezzi
Comprendi gli ID dei modelli, i fornitori, le tariffe pubblicate, gli sconti, le unità di fatturazione e come viene calcolato il prezzo di una richiesta.
I prezzi dei modelli sono pubblicati in USD. Un modello può essere disponibile tramite più di un provider upstream e ogni provider può pubblicare un prezzo cliente diverso. Questa guida spiega da dove vengono questi prezzi e come calcolare una richiesta prima di inviarla.
Trovare l'ID di un modello
Usa l'ID del modello restituito dall'API. Non costruire un ID a partire dal nome visualizzato o dallo slug della pagina.
| Endpoint | Restituisce |
|---|---|
GET /api/v1/models | Ogni categoria di modello abilitata |
GET /api/v1/videos/models | I modelli di generazione video |
GET /api/v1/decisions/models | I modelli di decisione |
GET /api/v1/models accetta anche exclude_video_and_decisions=true e un filtro facoltativo provider. La scoperta legge il catalogo e non comporta costi per una chiamata al modello.
I modelli di immagine non hanno un endpoint di elenco dedicato. Filtra GET /api/v1/models per model_kind: "image_generation"; vedi Generazione di immagini.
Per una vista navigabile, apri il catalogo dei modelli o la pagina dei prezzi. Le pagine di dettaglio dei modelli mostrano i limiti di contesto, i protocolli e ogni prezzo pubblicato dei fornitori.
Provider e canali
Ogni modello ha un elenco di canali pubblici. Un canale è una configurazione di un provider upstream per quel modello, come Anthropic, Azure, Google o un canale Claude scontato.
is_defaultindica il canale usato per il prezzo in evidenza e per la route predefinita.runnableindica se il canale è attualmente disponibile per le richieste.standard_pricingcontiene le tariffe standard del provider.discount_multiplierè il moltiplicatore di vendita da 0 a 1.pricing_modeèconfigured_ratesoupstream_cost.
La pagina del modello ordina i fornitori mettendo per primo il predefinito, poi per prezzo di input cliente dal più basso al più alto. Per scegliere un fornitore in modo esplicito, vedi Canali e routing dei provider.
Come si calcola il prezzo cliente
Per un canale configured_rates:
customer price = standard rate × discount multiplierPer esempio, un canale con una tariffa di input standard di $1.00 per 1M di token e un moltiplicatore 0.8 addebita $0.80 per 1M di token.
Per un canale upstream_cost, standard_pricing è null, non zero. La fatturazione si basa sul costo di generazione riportato moltiplicato per lo sconto congelato. La pagina del modello mostra la regola effettiva per quel canale.
Le tariffe per token sono mostrate per 1 milione di token per leggibilità. La fatturazione usa la precisione per token dello snapshot dei prezzi corrente.
Unità di fatturazione
| Unità | Uso tipico | Come viene misurata |
|---|---|---|
| Token | Chat, ragionamento, embeddings, generazione di testo | Token di input e di output separatamente; le letture e scritture in cache possono avere tariffe proprie |
| Token immagine | Generazione e modifica di immagini | Token immagine di input e di output separatamente; il numero di token di output per immagine dipende dalla risoluzione |
| Richieste | Alcuni endpoint per immagini e utilità | Un costo fisso per chiamata |
| Secondi o livelli | Generazione di video | Durata, risoluzione, input di riferimento o un'altra condizione pubblicata |
Se corrispondono più condizioni di prezzo, si applica la prima condizione corrispondente elencata nei dettagli dei prezzi del modello. Controlla i livelli nella pagina di dettaglio del modello prima di stimare un job di grandi dimensioni.
Tariffe della cache
Quando un modello pubblica input_cache_read o input_cache_write, queste tariffe compaiono nel catalogo e nella pagina del modello. L'uso della cache è riportato dalla risposta del protocollo; un cache hit non è garantito e dipende dal provider upstream e dalla richiesta. Felo non aggiunge un interruttore separato per la cache.
Dove controllare i prezzi
- Pagina dei prezzi — confronta modelli e fornitori.
- Pagina di dettaglio del modello — tabella completa delle tariffe, livelli e condizioni.
- API del catalogo dei modelli — gli stessi dati in JSON, aggiornati entro 60 secondi.
Non inserire i prezzi nel codice della tua applicazione. Leggi il catalogo o mostra un link alla pagina dei prezzi, così un cambio di prezzo non compromette silenziosamente la tua stima dei costi.
Stimare una richiesta
- Individua l'ID del modello e il canale che intendi usare.
- Leggi le tariffe di input, output e cache di quel canale.
- Moltiplica per i token previsti oppure usa la tariffa per richiesta o per durata per i modelli non basati sui token.
- Aggiungi l'eventuale livello condizionale applicabile.
- Lascia un margine per i retry e la variabilità dell'output.