Descripción general
Puedes consultar el uso de la API de dos formas:
Usa el Panel de uso para consultar la actividad de los periodos de facturación actuales y anteriores.
Consulta la información de uso de una respuesta de la API para comprobar una solicitud concreta.
Playground usa las mismas llamadas a la API que tus aplicaciones. Sus tokens cuentan para el uso de la API de tu cuenta y siguen las mismas reglas de uso y precios.
Acceso al panel
Para acceder al Panel de uso, debes ser propietario de una organización o tener el permiso Panel de uso.
Consultar el uso en el panel
Abre el Panel de uso, selecciona la organización que quieras consultar y elige el periodo correspondiente del informe.
Los datos del panel se muestran en UTC. Ten en cuenta esa zona horaria al comparar la actividad del panel con los registros de tu aplicación.
Seleccionar proyectos
El panel tiene su propio selector de proyectos. Funciona de forma independiente del proyecto seleccionado en otras secciones de la Plataforma API.
Utiliza el selector del panel para consultar uno, varios o todos los proyectos. Para ver los datos globales de la organización, borra la selección de proyectos. Si no hay ningún proyecto seleccionado, el panel muestra los datos de todos los proyectos.
Si varias aplicaciones utilizan el mismo proyecto o la misma clave de API, el total de ese proyecto o clave no permite identificar qué aplicación realizó una solicitud. Compara tus propios registros de solicitudes para el mismo periodo en UTC.
Consultar el uso de un usuario concreto
Para consultar el uso de Responses y Chat Completions de un usuario:
En el Panel de uso, ve a Funciones de la API > Responses y Chat Completions.
Selecciona Filtrar por.
En Usuarios, selecciona al usuario y, después, Aplicar filtros.
Ver tokens por minuto
Las páginas de detalles de uso permiten seleccionar el intervalo. Selecciona un intervalo de 1 minuto para consultar los tokens por minuto (TPM).
Este intervalo se aplica a los datos de uso, no a los de facturación.
Exportar datos de uso
No hay límite para el intervalo de fechas de la exportación. Las exportaciones que abarcan un periodo largo pueden dividirse en varios archivos.
Para conciliar las facturas mensuales y exportar los datos desglosados por concepto, consulta: exportar los detalles de uso mensual.
Si una exportación de actividad incluye filas con valores negativos, compara las filas con la misma unidad, agrupación y fechas. Utiliza los datos de costes para consultar los importes facturados. Una fila de actividad con un valor negativo no demuestra por sí sola que se haya aplicado un abono a tu factura.
Ver concesiones de créditos
Los detalles de las concesiones de créditos están disponibles en la página de facturación de tu organización.
Las concesiones de créditos y el uso de la API responden a preguntas distintas: las primeras muestran los créditos asociados a tu organización, mientras que el uso muestra su actividad en la API.
Consultar el uso y los costes del Nivel de capacidad
Si tu organización tiene habilitado el Nivel de capacidad y dispones del acceso necesario, abre la página de uso del Nivel de capacidad para consultar información detallada.
Los costes de los paquetes del Nivel de capacidad se atribuyen a la organización, no a proyectos concretos.
El uso es superior a cero, pero el gasto del proyecto es cero
Comprueba si el uso del modelo está cubierto por tu asignación del Nivel de capacidad. Si todo el uso de ese modelo está dentro de la asignación de TPM del Nivel de capacidad, el proyecto puede mostrar uso sin gastos adicionales del modelo.
El coste de la suscripción al Nivel de capacidad permanece en el ámbito de la organización. Para consultarlo:
Borra el filtro de proyectos en el Panel de uso.
Selecciona Categorías de gasto.
Consultar varias organizaciones
El Panel de uso no combina datos de costes ni de uso de distintas organizaciones. Cada organización, incluidas las suborganizaciones, se trata por separado.
Para ver una suborganización, selecciónala en el selector de organizaciones.
Si necesitas informes combinados, plantéate usar proyectos dentro de una sola organización en vez de suborganizaciones independientes, o usa la API de uso para realizar análisis personalizados.
Consultar el uso de tokens en una respuesta de la API
Los nombres de los campos de uso de tokens dependen del punto de acceso.
| Número de tokens | Chat Completions | Responses |
|---|---|---|
| Tokens de entrada | usage.prompt_tokens | usage.input_tokens |
| Tokens de salida | usage.completion_tokens | usage.output_tokens |
| Total de tokens | usage.total_tokens | usage.total_tokens |
Por ejemplo, una respuesta de Chat Completions puede incluir:
{
"usage": {
"prompt_tokens": 13,
"completion_tokens": 7,
"total_tokens": 20
}
}Según el punto de acceso y el modelo, los detalles de uso también pueden incluir recuentos de tokens de entrada en caché y de razonamiento. Estos recuentos ayudan a explicar por qué la longitud visible de una respuesta no refleja su consumo total de tokens.
Para obtener una explicación de las distintas categorías de tokens, consulta: qué son los tokens y cómo contarlos.
En una respuesta de transcripción que indique el consumo de tokens, los tokens de entrada de audio y texto ya están incluidos en input_tokens. No vuelvas a sumar esos componentes al total de entrada. Compara output_tokens por separado.
Obtener datos de uso de Chat Completions en streaming
Para una solicitud de Chat Completions en streaming, incluye:
{
"stream": true,
"stream_options": {
"include_usage": true
}
}Con include_usage activado, un fragmento adicional anterior a data: [DONE] contiene los datos de uso de toda la solicitud. Su array choices está vacío. En los demás fragmentos, el valor de usage es null.
Si se interrumpe la transmisión, es posible que no recibas ese fragmento final con los datos de uso. La ausencia del fragmento final no demuestra que la solicitud no haya utilizado tokens.
Esta configuración es específica de Chat Completions. Para más información, consulta: referencia de la API para completar chats.