Descripción general
Puedes revisar el uso de la API de dos maneras:
Usa el Panel de uso para revisar la actividad de los períodos de facturación actuales y anteriores.
Consulta la información de uso en una respuesta de la API para revisar una solicitud específica.
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 la organización o tener el permiso Panel de uso.
Revisar el uso en el panel
Abre el Panel de uso, selecciona la organización que quieras revisar y elige el período de informe correspondiente.
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.
Usa el selector del panel para revisar uno, varios o todos los proyectos. Para ver los datos generales de la organización, borra los proyectos seleccionados. Si no hay proyectos seleccionados, el panel muestra los datos de todos los proyectos.
Revisar el uso de un usuario específico
Para revisar 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 el usuario y, luego, Aplicar filtros.
Ver tokens por minuto
Las páginas de detalles de uso permiten seleccionar intervalos. Selecciona un intervalo de 1 minuto para examinar 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 exportación. Las exportaciones que abarcan un período largo pueden dividirse en varios archivos.
Para conciliar facturas mensuales y exportar partidas, consulta Exportar detalles de uso mensual.
Ver créditos otorgados
Los detalles de los créditos otorgados están disponibles en la página de Facturación de tu organización.
Los créditos otorgados y el uso de la API responden preguntas diferentes: los primeros muestran los créditos asociados a tu organización, mientras que el uso muestra su actividad en la API.
Revisar el uso y los costos del Nivel de capacidad
Si tu organización tiene habilitado el Nivel de capacidad y cuentas con el acceso necesario, abre la página de uso del Nivel de capacidad para consultar información detallada.
Los costos de los paquetes del Nivel de capacidad se atribuyen a la organización, no a proyectos individuales.
El uso es mayor que 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 costo de la suscripción al Nivel de capacidad permanece en el nivel de la organización. Para revisarlo:
Borra el filtro de proyectos en el Panel de uso.
Selecciona Categorías de gasto.
Revisar varias organizaciones
El Panel de uso no combina los datos de costos ni de uso de varias 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, considera usar proyectos dentro de una sola organización en lugar de suborganizaciones distintas o usa la API de uso para realizar un análisis personalizado.
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.
| Recuento de tokens | Chat Completions | Responses |
| Tokens de entrada | usage.prompt_tokens | usage.input_tokens |
| Tokens de salida | usage.completion_tokens | usage.output_tokens |
| Tokens totales | 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 almacenados en caché y tokens de razonamiento. Estos recuentos ayudan a explicar por qué la longitud visible de una respuesta no refleja todo su uso de tokens.
Para conocer las diferentes categorías de tokens, consulta Comprender y contar tokens.
Obtener datos de uso de Chat Completions transmitidas
Para una solicitud de Chat Completions por transmisión, incluye:
| { "stream": true, "stream_options": { "include_usage": true }} |
Con include_usage habilitado, un fragmento adicional antes de data: [DONE] contiene los datos de uso de toda la solicitud. Su arreglo choices está vacío. Los demás fragmentos tienen un valor de uso 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 usado tokens.
Esta configuración es específica de Chat Completions. Para obtener más información, consulta la referencia de la API de Chat Completions.