Visió general
Pots consultar l'ús de l'API de dues maneres:
Utilitza Analítica > Ús per consultar l'activitat de l'API en períodes actuals i anteriors.
Llegeix la informació d'ús d'una resposta de l'API per comprovar una sol·licitud concreta.
Playground utilitza les mateixes crides a l'API que les teves aplicacions. Els seus segments compten per a l'ús de l'API del teu compte i estan subjectes a les mateixes normes d'ús i tarifes.
Accés al tauler
Per accedir al Tauler d'ús, heu de ser propietari de l'organització o tenir el permís Tauler d'ús.
Consulta l'ús al tauler
A la Plataforma d'API, obre Analítica i selecciona Ús per consultar el projecte actual. Per consultar les dades de tota l'organització, selecciona Analítica de l'organització. Selecciona el període que vols consultar i torna'l a comprovar després de canviar entre l'analítica del projecte i la de l'organització.
Les dades del tauler es mostren en UTC. Tingues en compte aquest fus horari quan comparis l'activitat del tauler amb els registres de l'aplicació.
L'ús recent pot trigar a aparèixer al tauler. Si hi falta activitat recent, torna-ho a comprovar més tard.
Filtra les dades d'ús
A Analítica del projecte, les dades d'ús es limiten al projecte seleccionat. A Analítica de l'organització, utilitza Projecte per seleccionar els projectes que vols consultar. Tots els projectes inclou tots els projectes de l'organització, tenint en compte la resta de filtres que hagis seleccionat.
Utilitza Filtres per acotar l'ús per Orígens de l'API, Claus d'API, Models, Usuaris o Nivell de processament. Orígens de l'API et permet seleccionar Tots els orígens de l'API, API d'agents o API directa.
Elimina seleccions individuals o selecciona Esborra els filtres per restablir el tauler Filtres. Esborrar els filtres no canvia entre l'analítica del projecte i la de l'organització.
Utilitza Filtra al gràfic Ús per filtrar per Lot. Selecciona Restableix els filtres del gràfic per restablir els filtres d'aquest gràfic.
Si una funcionalitat no admet els filtres seleccionats, pot ser que els seus valors no estiguin disponibles. Que els valors no estiguin disponibles no vol dir que l'ús sigui zero.
Si un filtre mostra un error de permisos, pot ser que no tinguis accés a les seves opcions. Això no vol dir que no s'hagi registrat cap ús.
Consulta l'ús d'un usuari concret
Obre Ús a la vista d'Analítica del projecte o de l'organització que vols consultar. A la taula Funcionalitats de l'API, selecciona Mostra a Respostes i complecions de xat.
A Filtres, selecciona Usuaris i tria l'usuari. Els resultats s'actualitzen immediatament.
Consulta el gràfic i la taula d'aquest usuari.
Per consultar l'ús d'un usuari en totes les funcionalitats, aplica el filtre Usuaris a la vista general d'Ús. Per comparar usuaris, esborra aquest filtre i selecciona la pestanya Usuaris de la taula.
Consulta els segments per dia, hora o minut
Quan els controls d'interval estiguin disponibles a Ús, selecciona 1d o 1h per veure els segments per dia o hora, o 1m per examinar els segments per minut (TPM). Selecciona Automàtic perquè el tauler triï l'interval de temps adequat per al període de consulta. Aquests intervals s'apliquen a les dades d'ús, no a les de facturació.
Si 1m està desactivat, selecciona un període de consulta més curt o utilitza Selecciona per ampliar i arrossega sobre el gràfic per acotar l'interval. A continuació, selecciona 1m. Prem Esc per cancel·lar la selecció d'ampliació. Selecciona l'interval de dates actual a la barra d'eines d'Analítica per triar un altre període de consulta.
Consulta els gràfics i les taules d'ús
Utilitza Mètriques per seleccionar una o més sèries que es mostraran juntes, com ara Segments d'entrada, Segments d'entrada no emmagatzemats a la memòria cau, Segments d'entrada emmagatzemats a la memòria cau, Segments d'entrada d'escriptura a la memòria cau, Segments d'àudio d'entrada, Segments de sortida i Segments d'àudio de sortida. Les mètriques disponibles depenen de la funcionalitat. Utilitza la llegenda per identificar cada sèrie.
Utilitza Agrupa per per organitzar l'ús per categories com ara Projecte, Usuari o Model, quan estiguin disponibles. Els filtres determinen quines dades d'ús s'inclouen; l'agrupació determina com es mostren. Alterna entre gràfics de línies i de barres per examinar tendències o comparar categories.
Utilitza les pestanyes de la taula Ús per consultar els desglossaments disponibles. Les taules mostren les mesures pertinents per a cada fila, com ara sol·licituds, segments d'entrada i de sortida o unitats específiques de cada funcionalitat.
A Funcionalitats de l'API, selecciona Mostra en una funcionalitat per obrir-ne els gràfics i els desglossaments detallats. Respostes i complecions de xat inclou gràfics separats de Segments i Sol·licituds, així com una mètrica de Sol·licituds al model. Les seves pestanyes de desglossament utilitzen les mateixes dimensions que la vista general, però sense la pestanya Funcionalitats de l'API. Utilitza Ús a la ruta de navegació per tornar a la vista general.
Després de seleccionar una opció d'Agrupa per, el gràfic pot agrupar categories addicionals a Altres. Si Altres apareix a la llegenda del gràfic, selecciona'n l'etiqueta per veure les categories que inclou i els seus valors d'ús.
Selecciona Compara taulers per veure Ús al costat d'un altre tauler amb dades del mateix període. Utilitza Tauler esquerre i Tauler dret per seleccionar les vistes. Si l'interval de temps seleccionat no està disponible per a la parella de taulers, la vista passa a Automàtic. Selecciona Surt de la comparació per tornar al tauler.
Investiga l'ús que no reconeixes
Si Ús mostra activitat que no pots relacionar amb les sol·licituds dels registres de l'aplicació, fes aquestes comprovacions:
Confirma l'organització, els projectes inclosos i el període de consulta. Utilitza l'hora UTC quan comparis les marques de temps del tauler amb els registres de l'aplicació.
Utilitza la vista del projecte afectat o selecciona'l a Projecte dins d'Analítica de l'organització. A continuació, utilitza Filtres per acotar l'ús per clau d'API i model, i selecciona un període de consulta més curt.
Compara l'activitat amb els registres del mateix període, projecte i clau d'API. Comprova si els registres inclouen totes les aplicacions o integracions que utilitzen aquesta clau.
Si diverses aplicacions o integracions comparteixen el mateix projecte o clau d'API, pot ser que el total, per si sol, no permeti identificar quina ha enviat una sol·licitud. Compara el tauler amb els registres de cada aplicació per al mateix període en UTC.
Si encara no pots explicar l'ús, contacta amb el suport d'OpenAI i facilita el període afectat en UTC, els identificadors de l'organització i del projecte, l'identificador de la clau d'API i les captures de pantalla o els registres pertinents. Inclou-hi els identificadors de les sol·licituds, si en tens. No hi incloguis claus d'API secretes.
Exporta les dades d'ús
Per exportar les dades d'ús, selecciona la icona Exporta en CSV a la barra d'eines d'Analítica i, a continuació, selecciona Dades d'activitat.
Selecciona la Funcionalitat de l'API i una o més dimensions d'Agrupa per.
Revisa Origen de l'API, Projectes, Usuaris, Claus d'API i Models. Projectes i Origen de l'API ja tenen les opcions seleccionades a Analítica; selecciona la resta de filtres d'exportació al quadre de diàleg.
Selecciona Format de fitxer, Hora d'inici, Hora de finalització i Interval de temps i, a continuació, selecciona Baixa. Les dates inclouen dies complets en UTC.
Pots consultar i exportar les dades d'activitat i de costos des de les 00:00 UTC del mateix dia de fa un any fins avui. Per obtenir dades més antigues, contacta amb el suport d'OpenAI. Les dades diàries s'exporten en fitxers que cobreixen períodes de 31 dies.
Per conciliar les factures mensuals i exportar les partides, consulta: Exportació dels detalls d'ús mensuals.
Si una exportació d'activitat inclou files amb valors negatius, compara les files que tinguin la mateixa unitat, agrupació i dates. Utilitza Dades de costos per consultar els imports facturats. Una fila d'activitat amb un valor negatiu no demostra, per si sola, que s'hagi aplicat un abonament a la factura.
Consulta la despesa
Obre Analítica i selecciona Despesa per consultar els costos del projecte actual. Per consultar els costos de tota l'organització, selecciona Analítica de l'organització i, a continuació, Despesa.
Comprova l'interval de dates actual i els filtres abans de comparar els costos amb l'ús. Ús i Despesa ofereixen filtres diferents; un filtre disponible en un tauler pot no ser aplicable a l'altre.
Utilitza Orígens de l'API, Claus d'API, Models i Partides per acotar la despesa. A l'analítica de l'organització, utilitza Projecte per incloure els projectes que vols consultar. Utilitza les pestanyes Partides, Claus d'API, Usuaris, Projectes i Models de la taula per consultar els desglossaments disponibles.
Que el valor del límit de despesa no estigui disponible no vol dir que el límit sigui zero ni que se n'hagi aplicat un de nou. Els permisos d'accés, un límit sense definir o una sol·licitud fallida poden impedir que el tauler mostri un valor.
Consulta l'estat del servei
Si la teva organització té accés a Estat del servei, obre aquest tauler a Analítica per consultar el rendiment de l'API. Per conèixer els requisits d'accés i les definicions de les mètriques, consulta: Resolució d'errors i problemes de latència de l'API.
Consulta els crèdits concedits
Els detalls dels crèdits concedits estan disponibles a la pàgina de facturació de la teva organització.
Els crèdits concedits i l'ús de l'API responen a preguntes diferents: els crèdits concedits mostren els crèdits associats a la teva organització, mentre que l'ús mostra la seva activitat a l'API.
Consultar l'ús i els costos del nivell d'escalat
Si la vostra organització té activat el nivell d'escalat i disposeu de l'accés necessari, obriu la pàgina d'ús del nivell d'escalat per consultar-ne els detalls.
Els costos dels paquets del nivell d'escalat s'atribueixen a l'organització, no als projectes individuals.
L'ús és superior a zero, però la despesa del projecte és zero
Comprova si l'ús del model està cobert per la teva assignació del nivell d'escalat. Si tot l'ús d'aquest model queda dins de l'assignació de TPM del nivell d'escalat, el projecte pot mostrar ús sense cap despesa addicional del model.
El cost de la subscripció al nivell d'escalat continua imputant-se a l'organització. Consulta la despesa del conjunt de l'organització en lloc de basar-te en la d'un sol projecte.
Consulta diverses organitzacions
El tauler d'ús no combina les dades de costos ni d'ús de diferents organitzacions. Cada organització, incloses les suborganitzacions, es tracta per separat.
Per veure una suborganització, tria-la al selector d'organitzacions.
Si necessites informes conjunts, considera utilitzar projectes dins d'una sola organització en lloc de suborganitzacions separades, o utilitza l'API d'ús per fer anàlisis personalitzades.
Comprova l'ús de segments en una resposta de l'API
Els noms dels camps d'ús de segments depenen del punt final.
| Recompte de segments | Complecions de xat | Respostes |
|---|---|---|
| Segments d'entrada | usage.prompt_tokens | usage.input_tokens |
| Segments de sortida | usage.completion_tokens | usage.output_tokens |
| Total de segments | usage.total_tokens | usage.total_tokens |
Les respostes de complecions de xat poden incloure informació sobre l'ús de segments. Alguns exemples són:
{
"usage": {
"prompt_tokens": 13,
"completion_tokens": 7,
"total_tokens": 20
}
}Segons el punt final i el model, els detalls d'ús també poden incloure el recompte de segments d'entrada en memòria cau i de segments de raonament. Aquests recomptes ajuden a explicar per què la llargada visible d'una resposta no reflecteix el consum total de segments.
Per obtenir una explicació de les diferents categories de segments, consulta: Entendre i comptar els segments.
En una resposta de transcripció que informa de l'ús de segments, els segments d'entrada d'àudio i de text ja estan inclosos a input_tokens. No tornis a sumar aquests components al total d'entrada. Compara output_tokens per separat.
Obtén dades d'ús de les complecions de xat en temps real
En una sol·licitud de complecions de xat en temps real, inclou:
{
"stream": true,
"stream_options": {
"include_usage": true
}
}Amb include_usage activat, un fragment addicional abans de data: [DONE] conté les dades d'ús de tota la sol·licitud. La seva matriu choices és buida. Als altres fragments, el valor de usage és null.
Si el flux s'interromp, és possible que no rebis aquest fragment final amb les dades d'ús. L'absència del fragment final no demostra que la sol·licitud no hagi utilitzat cap segment.
Aquesta configuració és específica de les complecions de xat. Per obtenir-ne més informació, consulta la documentació de referència de l'API de complecions de xat.
