Questa pagina è stata tradotta automaticamente. Visualizza l'articolo originale in inglese.

Esaminare utilizzo e costi dell'API

Esamina l'attività API in Analisi, controlla il conteggio dei token nelle risposte API e scopri come funzionano i filtri per progetto, le esportazioni e i costi di Scale Tier.

Aggiornato: 4 days ago

Panoramica

Puoi esaminare l'utilizzo dell'API in due modi:

  • Usa Analisi > Utilizzo per esaminare l'attività API nel periodo di riferimento corrente e in quelli passati.

  • Leggi le informazioni sull'utilizzo in una risposta API per controllare una singola richiesta.

Playground usa le stesse chiamate API delle tue applicazioni. I suoi token vengono conteggiati nell'utilizzo dell'API del tuo account e sono soggetti alle stesse regole di utilizzo e tariffe.

Accesso alla dashboard

Per accedere alla dashboard Utilizzo, devi essere proprietario dell'organizzazione o disporre dell'autorizzazione Dashboard Utilizzo.

Esaminare l'utilizzo nella dashboard

Nella Piattaforma API, apri Analisi e seleziona Utilizzo per esaminare il progetto corrente. Per i report sull'intera organizzazione, seleziona Analisi dell'organizzazione. Seleziona il periodo di riferimento da esaminare e ricontrollalo dopo il passaggio tra l'analisi del progetto e quella dell'organizzazione.

I dati della dashboard sono visualizzati in UTC. Tieni presente questo fuso orario quando confronti l'attività nella dashboard con i log della tua applicazione.

L'utilizzo recente potrebbe richiedere del tempo per comparire nella dashboard. Se l'attività recente non compare, ricontrolla più tardi.

Filtrare i dati di utilizzo

Nella sezione Analisi del progetto, i dati di utilizzo riguardano solo il progetto selezionato. In Analisi dell'organizzazione, usa Progetto per selezionare i progetti da esaminare. Tutti i progetti include ogni progetto dell'organizzazione, tenendo conto degli eventuali altri filtri selezionati.

Usa Filtri per limitare i dati di utilizzo in base a Origini API, Chiavi API, Modelli, Utenti o Livello di elaborazione. Origini API consente di selezionare Tutte le origini API, API Agents o API diretta.

Rimuovi le singole selezioni oppure seleziona Cancella filtri per reimpostare il pannello Filtri. La cancellazione dei filtri non cambia la vista selezionata tra analisi del progetto e analisi dell'organizzazione.

Usa Filtra nel grafico Utilizzo per filtrare in base a Batch. Seleziona Reimposta filtri del grafico per reimpostare i filtri di quel grafico.

Se una funzionalità non supporta i filtri selezionati, i relativi valori potrebbero non essere disponibili. I valori non disponibili non indicano un utilizzo pari a zero.

Se un filtro mostra un errore di autorizzazione, potresti non avere accesso alle sue opzioni. Questo non significa che non sia stato registrato alcun utilizzo.

Esaminare l'utilizzo di un singolo utente

  1. Apri Utilizzo nella vista Analisi del progetto o dell'organizzazione che vuoi esaminare. Nella tabella Funzionalità API, seleziona Visualizza per Risposte e completamenti delle chat.

  2. In Filtri, seleziona Utenti e scegli l'utente. I risultati si aggiornano immediatamente.

  3. Esamina il grafico e la tabella relativi a quell'utente.

Per esaminare l'utilizzo di un utente nelle diverse funzionalità, applica il filtro Utenti nella panoramica Utilizzo. Per confrontare gli utenti, rimuovi quel filtro e seleziona la scheda Utenti della tabella.

Visualizzare i token per giorno, ora o minuto

Dove sono disponibili i controlli dell'intervallo in Utilizzo, seleziona 1g o 1h per visualizzare i token per giorno o per ora, oppure 1m per esaminare i token al minuto (TPM). Seleziona Automatico per lasciare che la dashboard scelga l'intervallo temporale per il tuo periodo di riferimento. Questi intervalli si applicano ai dati di utilizzo, non a quelli di fatturazione.

Se 1m è disabilitato, seleziona un periodo di riferimento più breve oppure usa Seleziona per ingrandire e trascina sul grafico per restringere l'intervallo. Poi seleziona 1m. Premi Esc per annullare la selezione dell'area da ingrandire. Seleziona l'intervallo di date corrente nella barra degli strumenti di Analisi per scegliere un periodo di riferimento diverso.

Esaminare grafici e tabelle di utilizzo

Usa Metriche per selezionare una o più serie da visualizzare insieme, tra cui Token di input, Token di input non memorizzati nella cache, Token di input memorizzati nella cache, Token di input per la scrittura nella cache, Token audio di input, Token di output e Token audio di output. Le metriche disponibili dipendono dalla funzionalità. Usa la legenda per identificare ogni serie.

Usa Raggruppa per per organizzare l'utilizzo in categorie come Progetto, Utente o Modello, dove disponibili. I filtri determinano quali dati di utilizzo includere; il raggruppamento determina come visualizzarli. Passa dai grafici a linee a quelli a barre per esaminare le tendenze o confrontare le categorie.

Usa le schede della tabella Utilizzo per esaminare le suddivisioni disponibili. Le tabelle mostrano le misure pertinenti per ogni riga, come richieste, token di input e output o unità specifiche della funzionalità.

In Funzionalità API, seleziona Visualizza per una funzionalità per aprire i relativi grafici e le suddivisioni dettagliate. Risposte e completamenti delle chat include grafici separati per Token e Richieste e la metrica Richieste al modello. Le schede di dettaglio usano le stesse dimensioni della panoramica, senza la scheda Funzionalità API. Usa la voce Utilizzo nel percorso di navigazione per tornare alla panoramica.

Dopo aver selezionato un'opzione in Raggruppa per, il grafico potrebbe riunire le categorie aggiuntive in Altro. Se nella legenda del grafico compare Altro, seleziona l'etichetta per vedere le categorie incluse e i relativi valori di utilizzo.

Seleziona Confronta dashboard per affiancare Utilizzo a un'altra dashboard relativa allo stesso periodo di riferimento. Usa Dashboard sinistra e Dashboard destra per selezionare le viste. Se l'intervallo temporale selezionato non è disponibile per la coppia di dashboard, la vista passa ad Automatico. Seleziona Esci dal confronto per tornare alla dashboard.

Verificare l'utilizzo che non riconosci

Se Utilizzo mostra attività che non riesci a ricondurre alle richieste nei log della tua applicazione, esegui questi controlli:

  1. Verifica l'organizzazione, i progetti inclusi e il periodo di riferimento. Usa il fuso orario UTC quando confronti i timestamp della dashboard con i log della tua applicazione.

  2. Usa la vista del progetto interessato oppure selezionalo in Progetto all'interno di Analisi dell'organizzazione. Poi usa Filtri per limitare i dati di utilizzo in base alla chiave API e al modello e seleziona un periodo di riferimento più breve.

  3. Confronta l'attività con i log relativi allo stesso periodo, progetto e chiave API. Verifica che i log coprano tutte le applicazioni o integrazioni che usano quella chiave.

  4. Se più applicazioni o integrazioni condividono lo stesso progetto o la stessa chiave API, il solo totale potrebbe non bastare a identificare quale ha inviato una richiesta. Confronta la dashboard con i dati registrati da ogni applicazione per lo stesso periodo in UTC.

  5. Se ancora non riesci a spiegare l'utilizzo, contatta l'assistenza OpenAI indicando il periodo interessato in UTC, gli ID dell'organizzazione e del progetto, l'identificativo della chiave API e gli screenshot o i log pertinenti. Includi gli ID delle richieste, se disponibili. Non includere chiavi API segrete.

Esportare i dati di utilizzo

Per esportare i dati di utilizzo, seleziona l'icona Esporta CSV nella barra degli strumenti di Analisi, poi seleziona Dati di attività.

  1. Seleziona la Funzionalità API e una o più dimensioni in Raggruppa per.

  2. Controlla Origine API, Progetti, Utenti, Chiavi API e Modelli. Progetti e Origine API sono preselezionati in base alle impostazioni di Analisi; seleziona gli altri filtri di esportazione nella finestra di dialogo.

  3. Seleziona Formato file, Ora di inizio, Ora di fine e Intervallo temporale, poi seleziona Scarica. Le date includono giornate intere in UTC.

Puoi visualizzare ed esportare i dati di attività e di costo dalle 00:00 UTC della data corrispondente a un anno fa fino a oggi. Per i dati meno recenti, contatta l'assistenza OpenAI. I dati giornalieri vengono esportati in file che coprono intervalli di 31 giorni.

Per la riconciliazione delle fatture mensili e l'esportazione delle singole voci, consulta: Esportare i dettagli di utilizzo mensile.

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. Usa Dati di costo per gli importi fatturati. Una riga di attività con valore negativo non dimostra, da sola, che sia stato applicato un accredito alla fattura.

Esaminare la spesa

Apri Analisi e seleziona Spesa per esaminare i costi del progetto corrente. Per i costi dell'intera organizzazione, seleziona Analisi dell'organizzazione e poi Spesa.

Controlla l'intervallo di date corrente e i filtri prima di confrontare i costi con l'utilizzo. Utilizzo e Spesa offrono filtri diversi; un filtro disponibile in una dashboard potrebbe non essere applicabile all'altra.

Usa Origini API, Chiavi API, Modelli e Voci di spesa per filtrare la spesa. Nell'analisi dell'organizzazione, usa Progetto per includere i progetti da esaminare. Usa le schede Voci di spesa, Chiavi API, Utenti, Progetti e Modelli della tabella per consultare le suddivisioni disponibili.

Se il valore del limite di spesa non è disponibile, non significa che il limite sia pari a zero o che ne sia stato applicato uno nuovo. Le autorizzazioni di accesso, un limite non impostato o una richiesta non riuscita possono impedire alla dashboard di mostrare un valore.

Esaminare lo stato del servizio

Se la tua organizzazione ha accesso a Stato del servizio, apri questa dashboard in Analisi per esaminare le prestazioni dell'API. Per i requisiti di accesso e le definizioni delle metriche, consulta: Risolvere gli errori e i problemi di latenza dell'API.

Visualizzare i crediti assegnati

I dettagli dei crediti assegnati sono disponibili nella pagina Fatturazione della tua organizzazione.

I crediti assegnati e l'utilizzo dell'API forniscono informazioni diverse: i primi mostrano i crediti associati alla tua 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 è maggiore di zero, ma la spesa del progetto è pari a zero

Verifica se l'utilizzo del modello è coperto dalla tua quota Scale Tier. Se tutto l'utilizzo di quel modello rientra nella quota TPM di Scale Tier, il progetto può mostrare un utilizzo senza spese aggiuntive per il modello.

Il costo dell'abbonamento Scale Tier rimane a livello di organizzazione. Esamina la spesa dell'intera organizzazione anziché basarti su quella di un singolo progetto.

Esaminare più organizzazioni

La dashboard Utilizzo non aggrega i dati di costo o di utilizzo di più organizzazioni. Ogni organizzazione, comprese le sotto-organizzazioni, viene trattata separatamente.

Per visualizzare una sotto-organizzazione, selezionala nel selettore delle organizzazioni.

Se hai bisogno di report aggregati, valuta l'uso di progetti all'interno di un'unica organizzazione anziché di sotto-organizzazioni separate, oppure usa l'API Usage per analisi personalizzate.

Controllare l'utilizzo dei token in una risposta API

I nomi dei campi relativi all'utilizzo dei token dipendono dall'endpoint.

Conteggio dei tokenChat CompletionsResponses
Token di inputusage.prompt_tokensusage.input_tokens
Token di outputusage.completion_tokensusage.output_tokens
Token totaliusage.total_tokensusage.total_tokens

Le risposte di Chat Completions possono includere informazioni sull'utilizzo dei token. Ecco alcuni esempi:

{
"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.

Questo articolo è stato utile?