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 ha un proprio selettore di progetti. Funziona indipendentemente dal progetto selezionato in altre sezioni della Piattaforma API.
Usa il selettore della dashboard per esaminare uno, più o tutti i progetti. Per vedere i dati complessivi dell'organizzazione, deseleziona tutti i progetti. Se non è selezionato alcun progetto, la dashboard mostra i dati di tutti i progetti.
Se più applicazioni usano lo stesso progetto o la stessa chiave API, il totale relativo a quel progetto o a quella chiave non permette di identificare quale applicazione abbia effettuato una richiesta. Confronta i tuoi registri delle richieste per lo stesso periodo in UTC.
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 ci sono limiti all'intervallo di date per l'esportazione. Le esportazioni che coprono un periodo lungo possono essere suddivise in più file.
Per la riconciliazione delle fatture mensili e l'esportazione delle singole voci, consulta: Esportare i dettagli di utilizzo mensili.
Se un'esportazione dei dati di Attività include righe con valori negativi, confronta le righe con la stessa unità, lo stesso raggruppamento e le stesse date. Per gli importi fatturati, usa i dati di Costo. Una riga di attività con un valore negativo non dimostra, da sola, che sia stato applicato un accredito alla fattura.
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.
Controlla l’utilizzo dei token in una risposta API
I nomi dei campi relativi all’utilizzo dei token dipendono dall’endpoint.
| Conteggio dei 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 di utilizzo possono includere anche i conteggi dei token di input memorizzati nella cache e dei token di ragionamento. Questi conteggi aiutano a capire perché la lunghezza visibile di una risposta non ne rispecchia l'utilizzo totale di token.
Per una spiegazione delle diverse categorie di token, consulta: Comprendere e contare i token.
In una risposta di trascrizione che riporta l'utilizzo dei token, i token di input audio e testuali sono già inclusi in input_tokens. Non aggiungere di nuovo queste componenti al totale dei token di input. Confronta output_tokens separatamente.
Ottieni i dati di utilizzo da Chat Completions in streaming
Per una richiesta a Chat Completions in streaming, includi:
{
"stream": true,
"stream_options": {
"include_usage": true
}
}Quando include_usage è abilitato, un blocco aggiuntivo prima di data: [DONE] contiene i dati di utilizzo dell’intera richiesta. Il suo array choices è vuoto. Negli altri blocchi, il valore di usage è null.
Se lo stream si interrompe, potresti non ricevere il blocco finale con i dati di utilizzo. L’assenza del blocco finale non dimostra che la richiesta non abbia utilizzato token.
Questa configurazione è specifica di Chat Completions. Per maggiori dettagli, consulta la documentazione di riferimento dell’API per il completamento delle chat.