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 al proyecto seleccionado en otras partes de la Plataforma API.
Usa el selector del panel para consultar uno, varios o todos los proyectos. Para ver los datos generales de la organización, borra los proyectos seleccionados. Si no hay ningún proyecto seleccionado, el panel muestra los datos de todos los proyectos.
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 ningún límite para el intervalo de fechas de exportación. Las exportaciones que abarcan un periodo largo pueden dividirse en varios archivos.
Para conciliar las facturas mensuales y exportar partidas, consulta Exportar los detalles de uso mensuales.
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.
Comprobar 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 |
| 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 el número de tokens de entrada almacenados en caché y de razonamiento. Estos datos ayudan a explicar por qué la longitud visible de una respuesta no refleja todo su uso de tokens.
Para obtener una explicación de las distintas categorías de tokens, consulta Comprender y contar tokens.
Obtener datos de uso de Chat Completions en streaming
En una solicitud de Chat Completions en streaming, incluye:
| { "stream": true, "stream_options": { "include_usage": true }} |
Con include_usage habilitado, un fragmento adicional anterior a data: [DONE] contiene el uso de toda la solicitud. Su matriz choices está vacía. Los demás fragmentos tienen un valor usage nulo.
Si se interrumpe el streaming, es posible que no recibas ese fragmento final 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.