Panoramica
Puoi esaminare l'utilizzo dell'API in due modi:
Usa la dashboard Utilizzo per esaminare l'attività nei periodi di fatturazione correnti e passati.
Leggi le informazioni sull'utilizzo contenute in una risposta API per controllare una singola richiesta.
Playground usa le stesse chiamate API delle tue applicazioni. I relativi token vengono conteggiati nell'utilizzo dell'API del tuo account e seguono le stesse regole di utilizzo e gli stessi prezzi.
Accesso alla dashboard
Per accedere alla dashboard Utilizzo, devi essere proprietario dell'organizzazione o disporre dell'autorizzazione Dashboard Utilizzo.
Esaminare l'utilizzo nella dashboard
Apri la dashboard Utilizzo, seleziona l'organizzazione da esaminare e scegli il periodo di rendicontazione pertinente.
I dati della dashboard sono visualizzati in UTC. Tieni presente questo fuso orario quando confronti l'attività della dashboard con i log della tua applicazione.
Selezionare i progetti
La dashboard dispone di un proprio selettore dei progetti. Funziona indipendentemente dal progetto selezionato altrove nella Piattaforma API.
Usa il selettore della dashboard per esaminare uno, più o tutti i progetti. Per visualizzare i dati complessivi dell'organizzazione, deseleziona i progetti. Quando non è selezionato alcun progetto, la dashboard mostra i dati di tutti i progetti.
Esaminare l'utilizzo di un singolo utente
Per esaminare l'utilizzo di Responses e Chat Completions da parte di un utente:
Nella dashboard Utilizzo, vai a Funzionalità API > Responses e Chat Completions.
Seleziona Filtra per.
In Utenti, seleziona l'utente, quindi Applica filtri.
Visualizzare i token al minuto
Le pagine con i dettagli sull'utilizzo consentono di selezionare l'intervallo. Seleziona un intervallo di 1 minuto per esaminare i token al minuto (TPM).
Questo intervallo si applica ai dati di utilizzo, non a quelli di fatturazione.
Esportare i dati di utilizzo
Non sono previsti limiti per l'intervallo di date dell'esportazione. Le esportazioni relative a periodi estesi possono essere suddivise in più file.
Per la riconciliazione delle fatture mensili e l'esportazione delle singole voci, consulta Esportare i dettagli mensili sull'utilizzo.
Visualizzare le assegnazioni di crediti
I dettagli sulle assegnazioni di crediti sono disponibili nella pagina Fatturazione della tua organizzazione.
Le assegnazioni di crediti e l'utilizzo dell'API forniscono informazioni diverse: le prime mostrano i crediti associati all'organizzazione, mentre l'utilizzo ne mostra l'attività API.
Esaminare l'utilizzo e i costi di Scale Tier
Se Scale Tier è abilitato per la tua organizzazione e disponi dell'accesso necessario, apri la pagina di utilizzo di Scale Tier per visualizzare informazioni dettagliate.
I costi dei pacchetti Scale Tier vengono attribuiti all'organizzazione, non ai singoli progetti.
L'utilizzo è superiore a zero, ma la spesa del progetto è pari a zero
Verifica se l'utilizzo del modello è coperto dalla tua allocazione Scale Tier. Se l'intero utilizzo del modello rientra nell'allocazione TPM di Scale Tier, il progetto può mostrare utilizzo senza spese aggiuntive per il modello.
Il costo dell'abbonamento Scale Tier rimane a livello dell'organizzazione. Per esaminarlo:
Cancella il filtro dei progetti nella dashboard Utilizzo.
Seleziona Categorie di spesa.
Esaminare più organizzazioni
La dashboard Utilizzo non combina i dati sui costi o sull'utilizzo di organizzazioni diverse. Ogni organizzazione, comprese le organizzazioni secondarie, viene gestita separatamente.
Per visualizzare un'organizzazione secondaria, selezionala nel selettore delle organizzazioni.
Se hai bisogno di una rendicontazione combinata, valuta l'uso di progetti all'interno di un'unica organizzazione anziché di organizzazioni secondarie separate, oppure usa l'API Utilizzo per un'analisi personalizzata.
Controllare l'utilizzo dei token in una risposta API
I nomi dei campi relativi all'utilizzo dei token dipendono dall'endpoint.
| Numero di token | Chat Completions | Responses |
| Token di input | usage.prompt_tokens | usage.input_tokens |
| Token di output | usage.completion_tokens | usage.output_tokens |
| Token totali | usage.total_tokens | usage.total_tokens |
Ad esempio, una risposta di Chat Completions può includere:
| { "usage": { "prompt_tokens": 13, "completion_tokens": 7, "total_tokens": 20 }} |
A seconda dell'endpoint e del modello, i dettagli sull'utilizzo possono includere anche il numero di token di input memorizzati nella cache e di token di ragionamento. Questi dati aiutano a capire perché la lunghezza visibile di una risposta non ne riflette l'utilizzo complessivo dei token.
Per una spiegazione delle diverse categorie di token, consulta Capire e contare i token.
Ottenere i dati di utilizzo da Chat Completions in streaming
Per una richiesta Chat Completions in streaming, includi:
| { "stream": true, "stream_options": { "include_usage": true }} |
Quando include_usage è abilitato, un chunk aggiuntivo prima di data: [DONE] contiene i dati di utilizzo dell'intera richiesta. Il relativo array choices è vuoto. Gli altri chunk hanno un valore usage pari a null.
Se lo stream viene interrotto, potresti non ricevere il chunk finale con i dati di utilizzo. L'assenza del chunk finale non dimostra che la richiesta non abbia utilizzato token.
Questa configurazione è specifica per Chat Completions. Per maggiori dettagli, consulta la documentazione di riferimento dell'API Chat Completions.