OpenAI
Esta página se tradujo automáticamente. Ver el artículo original en inglés.

Consultar el uso y los costes de la API

Consulta la actividad de la API en Analíticas, comprueba los recuentos de tokens en las respuestas de la API y conoce los filtros de proyectos, las exportaciones y los costes del Nivel de capacidad.

Actualización: 11 hours ago

Descripción general

Puedes consultar el uso de la API de dos formas:

  • Usa Analíticas > Uso para consultar la actividad de la API en el periodo actual y en periodos anteriores.

  • Lee la información de uso en 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 se rigen por las mismas reglas de uso y tarifas.

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

En la Plataforma API, abre Analíticas y selecciona Uso para consultar el proyecto actual. Para consultar los datos de toda la organización, selecciona Analíticas de la organización. Selecciona el periodo de consulta que quieres revisar y vuelve a comprobarlo después de cambiar entre las analíticas del proyecto y las de la organización.

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.

El uso reciente puede tardar en aparecer en el panel. Si falta actividad reciente, vuelve a comprobarlo más tarde.

Filtrar el uso

En Analíticas del proyecto, el uso se limita al proyecto seleccionado. En Analíticas de la organización, usa Proyecto para seleccionar los proyectos que quieres consultar. Todos los proyectos incluye todos los proyectos de la organización, sujetos a los demás filtros que hayas seleccionado.

Usa Filtros para acotar el uso por Orígenes de la API, Claves de API, Modelos, Usuarios o Nivel de procesamiento. Orígenes de la API te permite seleccionar Todos los orígenes de la API, API de agentes o API directa.

Elimina selecciones individuales o selecciona Borrar filtros para restablecer el panel Filtros. Borrar los filtros no cambia entre las analíticas del proyecto y las de la organización.

Usa Filtrar en el gráfico Uso para filtrar por Lote. Selecciona Restablecer filtros del gráfico para restablecer los filtros de ese gráfico.

Si una funcionalidad no admite los filtros seleccionados, es posible que sus valores no estén disponibles. Que los valores no estén disponibles no significa que el uso sea cero.

Si un filtro muestra un error de permisos, es posible que no tengas acceso a sus opciones. Esto no significa que no se haya registrado uso.

Consultar el uso de un usuario concreto

  1. Abre Uso en la vista Analíticas del proyecto o de la organización que quieres consultar. En la tabla Funcionalidades de la API, selecciona Ver junto a Respuestas y completado de chats.

  2. En Filtros, selecciona Usuarios y elige al usuario. Los resultados se actualizan de inmediato.

  3. Consulta el gráfico y la tabla de ese usuario.

Para consultar el uso de un usuario en todas las funcionalidades, aplica el filtro Usuarios en la vista general de Uso. Para comparar usuarios, borra ese filtro y selecciona la pestaña Usuarios de la tabla.

Ver tokens por día, hora o minuto

Cuando los controles de intervalo estén disponibles en Uso, selecciona 1d o 1h para ver los tokens por día u hora, o 1m para examinar los tokens por minuto (TPM). Selecciona Automático para que el panel elija el intervalo de tiempo para tu periodo de consulta. Estos intervalos se aplican a los datos de uso, no a los de facturación.

Si 1m está deshabilitado, selecciona un periodo de consulta más corto o usa Seleccionar para ampliar y arrastra sobre el gráfico para acotar el rango. A continuación, selecciona 1m. Pulsa Esc para cancelar una selección de ampliación. Selecciona el rango de fechas actual en la barra de herramientas de Analíticas para elegir otro periodo de consulta.

Consultar gráficos y tablas de uso

Usa Métricas para seleccionar una o varias series que se mostrarán juntas, como Tokens de entrada, Tokens de entrada sin caché, Tokens de entrada en caché, Tokens de entrada escritos en caché, Tokens de audio de entrada, Tokens de salida y Tokens de audio de salida. Las métricas disponibles dependen de la funcionalidad. Usa la leyenda para identificar cada serie.

Usa Agrupar por para organizar el uso por categorías como Proyecto, Usuario o Modelo, cuando estén disponibles. Los filtros determinan qué datos de uso se incluyen; la agrupación determina cómo se muestran. Alterna entre gráficos de líneas y de barras para examinar tendencias o comparar categorías.

Usa las pestañas de la tabla Uso para consultar los desgloses disponibles. Las tablas muestran las medidas pertinentes de cada fila, como solicitudes, tokens de entrada y salida o unidades específicas de cada funcionalidad.

En Funcionalidades de la API, selecciona Ver junto a una funcionalidad para abrir sus gráficos y desgloses detallados. Respuestas y completado de chats incluye gráficos independientes de Tokens y Solicitudes, así como una métrica de Solicitudes al modelo. Sus pestañas de desglose usan las mismas dimensiones que la vista general, sin la pestaña Funcionalidades de la API. Usa el enlace Uso de la ruta de navegación para volver a la vista general.

Tras seleccionar una opción de Agrupar por, el gráfico puede agrupar categorías adicionales en Otros. Si aparece Otros en la leyenda del gráfico, selecciona esa etiqueta para ver las categorías incluidas y sus valores de uso.

Selecciona Comparar paneles para ver Uso junto a otro panel del mismo periodo de consulta. Usa Panel izquierdo y Panel derecho para seleccionar las vistas. Si el intervalo de tiempo seleccionado no está disponible para ambos paneles, la vista cambia a Automático. Selecciona Salir de la comparación para volver al panel.

Investigar el uso que no reconoces

Si Uso muestra actividad que no puedes relacionar con solicitudes de los registros de tu aplicación, realiza estas comprobaciones:

  1. Confirma la organización, los proyectos incluidos y el periodo de consulta. Usa UTC al comparar las marcas de tiempo del panel con los registros de tu aplicación.

  2. Usa la vista del proyecto afectado o selecciónalo en Proyecto, dentro de Analíticas de la organización. A continuación, usa Filtros para acotar el uso por clave de API y modelo, y selecciona un periodo de consulta más corto.

  3. Compara la actividad con los registros del mismo periodo, proyecto y clave de API. Comprueba si tus registros abarcan todas las aplicaciones o integraciones que usan esa clave.

  4. Si varias aplicaciones o integraciones comparten el mismo proyecto o clave de API, puede que el total por sí solo no permita identificar cuál envió una solicitud. Compara el panel con los registros de cada aplicación correspondientes al mismo periodo en UTC.

  5. Si sigues sin poder explicar el uso, ponte en contacto con el soporte de OpenAI e indica el periodo afectado en UTC, los ID de la organización y del proyecto, el identificador de la clave de API y las capturas de pantalla o los registros pertinentes. Incluye los ID de las solicitudes si están disponibles. No incluyas claves de API secretas.

Exportar datos de uso

Para exportar el uso, selecciona el icono Exportar CSV en la barra de herramientas de Analíticas y, a continuación, selecciona Datos de actividad.

  1. Selecciona la Funcionalidad de la API y una o varias dimensiones de Agrupar por.

  2. Revisa Origen de la API, Proyectos, Usuarios, Claves de API y Modelos. Proyectos y Origen de la API se preseleccionan a partir de Analíticas; selecciona los demás filtros de exportación en el cuadro de diálogo.

  3. Selecciona Formato de archivo, Hora de inicio, Hora de fin e Intervalo de tiempo y, a continuación, selecciona Descargar. Las fechas incluyen días completos en UTC.

Puedes consultar y exportar los datos de actividad y costes desde las 00:00 UTC de la fecha de hace un año hasta hoy. Para obtener datos anteriores, ponte en contacto con el soporte de OpenAI. Los datos diarios se exportan en archivos que abarcan periodos de 31 días.

Para conciliar las facturas mensuales y exportar las partidas, 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. Usa 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.

Consultar el gasto

Abre Analíticas y selecciona Gasto para consultar los costes del proyecto actual. Para consultar los costes de toda la organización, selecciona Analíticas de la organización y, a continuación, Gasto.

Comprueba el rango de fechas actual y los filtros antes de comparar los costes con el uso. Uso y Gasto ofrecen filtros diferentes; puede que un filtro disponible en un panel no sea aplicable al otro.

Usa Orígenes de la API, Claves de API, Modelos y Partidas para acotar el gasto. En las analíticas de la organización, usa Proyecto para incluir los proyectos que quieres consultar. Usa las pestañas Partidas, Claves de API, Usuarios, Proyectos y Modelos de la tabla para consultar los desgloses disponibles.

Que el valor del límite de gasto no esté disponible no significa que tu límite sea cero ni que se haya aplicado uno nuevo. Los permisos de acceso, un límite sin establecer o una solicitud fallida pueden impedir que el panel muestre un valor.

Consultar el estado del servicio

Si tu organización tiene acceso a Estado del servicio, abre ese panel en Analíticas para consultar el rendimiento de la API. Para conocer los requisitos de acceso y las definiciones de las métricas, consulta: solucionar problemas de errores y latencia de la API.

Ver las 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 concesiones 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 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 gasto adicional en el modelo.

El coste de la suscripción al Nivel de capacidad sigue imputándose a la organización. Consulta el gasto de toda la organización en lugar de basarte en el de un único proyecto.

Consultar varias organizaciones

El panel de uso no combina los datos de costes o 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, considera usar proyectos dentro de una misma organización en lugar 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.

Recuento de tokensChat CompletionsResponses
Tokens de entradausage.prompt_tokensusage.input_tokens
Tokens de salidausage.completion_tokensusage.output_tokens
Tokens totalesusage.total_tokensusage.total_tokens

Las respuestas de Chat Completions pueden incluir información sobre el uso de tokens. Algunos ejemplos son:

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

¿Te ha resultado útil este artículo?