Felo API PlatformFelo API Platform

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.

EndpointRestituisce
GET /api/v1/modelsOgni categoria di modello abilitata
GET /api/v1/videos/modelsI modelli di generazione video
GET /api/v1/decisions/modelsI 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_default indica il canale usato per il prezzo in evidenza e per la route predefinita.
  • runnable indica se il canale è attualmente disponibile per le richieste.
  • standard_pricing contiene le tariffe standard del provider.
  • discount_multiplier è il moltiplicatore di vendita da 0 a 1.
  • pricing_mode è configured_rates o upstream_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 multiplier

Per 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 tipicoCome viene misurata
TokenChat, ragionamento, embeddings, generazione di testoToken di input e di output separatamente; le letture e scritture in cache possono avere tariffe proprie
Token immagineGenerazione e modifica di immaginiToken immagine di input e di output separatamente; il numero di token di output per immagine dipende dalla risoluzione
RichiesteAlcuni endpoint per immagini e utilitàUn costo fisso per chiamata
Secondi o livelliGenerazione di videoDurata, 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

  1. Individua l'ID del modello e il canale che intendi usare.
  2. Leggi le tariffe di input, output e cache di quel canale.
  3. Moltiplica per i token previsti oppure usa la tariffa per richiesta o per durata per i modelli non basati sui token.
  4. Aggiungi l'eventuale livello condizionale applicabile.
  5. Lascia un margine per i retry e la variabilità dell'output.

Correlati