Livelli di prezzo

Alcuni modelli sono offerti in più di un livello. Un livello è lo stesso modello venduto a un prezzo diverso, ad esempio un livello a costo inferiore accanto a quello Predefinito. Una sola chiave API raggiunge ogni livello; scegli un livello dal nome del modello, non da una chiave separata o da un'impostazione.

Livello Predefinito

Il nome del modello semplice usa sempre il livello Predefinito. Le richieste esistenti continuano a funzionare senza modifiche quando un modello guadagna un altro livello.

{ "model": "gpt-image-2" }

Scegli un livello

Aggiungi due punti e l'ID del livello al nome del modello:

{ "model": "gpt-image-2:<tier>" }

Questo funziona per modelli di testo, immagine, video e audio, ovunque la richiesta nomini un modello: il campo model di un corpo JSON, il campo modulo model di un caricamento audio, e il segmento del modello in un percorso nativo Gemini. In un percorso Gemini l'azione rimane per ultima:

POST /v1beta/models/<model>:<tier>:generateContent

Trova i livelli di un modello

• Su ogni pagina di modello, un selettore di livello appare sopra la tabella dei prezzi e mostra i prezzi di ogni livello e l'ID del modello da chiamare. Le pagine con un unico prezzo mostrano i livelli nella tabella Livelli di prezzo invece. Entrambi appaiono solo quando il modello ha più di un livello.
• La guida Markdown /models/<page>/llms.txt di ogni modello elenca i prezzi completi di tutti i livelli.
• GET /v1/models elenca <model>:<tier> accanto a <model> per ogni modello che la tua chiave può chiamare in più di un livello.

Nel Playground dei modelli di testo, il selettore di livello passa da uno all'altro degli stessi livelli. Il Playground dei modelli di immagini, video e audio usa il livello Predefinito; chiama gli altri livelli tramite l'API.

Fatturazione e comportamento

• Una richiesta di livello si esegue solo in quel livello e viene fatturata al prezzo di quel livello.
• Se il livello non riesce a servire la richiesta, la richiesta fallisce. Non passa mai a un altro livello, quindi non viene mai fatturata a un prezzo diverso.
• Le risposte e i risultati delle attività segnalano il nome del modello semplice.
• Una chiave creata per un solo livello può chiamare quel livello e nessun altro.

Errori

Vedi Errori per la forma della risposta.