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

Revisar el uso y los costos de la API

Revisa la actividad de la API en Análisis, consulta los recuentos de tokens en las respuestas de la API y conoce los filtros de proyectos, las exportaciones y los costos del Nivel de capacidad.

Última actualización: yesterday

Vista general

Puedes revisar el uso de la API de dos maneras:

  • Usa Análisis > Uso para revisar la actividad de la API en períodos de informe actuales y anteriores.

  • Lee 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 están sujetos a las mismas reglas de uso y tarifas.

Acceso al panel

Para acceder al Panel de uso, debes ser propietario de la organización o tener el permiso Panel de uso.

Revisa el uso en el panel

En la Plataforma API, abre Análisis y selecciona Uso para revisar el proyecto actual. Para consultar informes de toda la organización, selecciona Análisis de la organización. Selecciona el período de informe que quieras revisar y compruébalo de nuevo después de cambiar entre las vistas de análisis del proyecto y 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 consultar más tarde.

Filtra el uso

En Análisis del proyecto, el uso se limita al proyecto seleccionado. En Análisis de la organización, usa Proyecto para seleccionar los proyectos que quieres revisar. Todos los proyectos incluye cada proyecto de la organización, sujeto 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 de Filtros. Borrar los filtros no cambia entre las vistas de análisis del proyecto y de la organización.

Usa Filtrar en el gráfico de 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.

Revisa el uso de un usuario específico

  1. Abre Uso en la vista de Análisis del proyecto o de la organización que quieras revisar. En la tabla Funcionalidades de la API, selecciona Ver en Respuestas y completado de chats.

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

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

Para revisar el uso de un usuario en las distintas 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.

Consulta los 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 según tu período de informe. Estos intervalos se aplican a los datos de uso, no a los de facturación.

Si 1m está deshabilitado, selecciona un período de informe más corto o usa Seleccionar para ampliar y arrastra sobre el gráfico para acotar el rango. Luego, selecciona 1m. Presiona Esc para cancelar una selección de ampliación. Selecciona el rango de fechas actual en la barra de herramientas de Análisis para elegir otro período de informe.

Revisa los gráficos y las tablas de uso

Usa Métricas para seleccionar una o más series que se mostrarán juntas, como Tokens de entrada, Tokens de entrada sin caché, Tokens de entrada en caché, Tokens de entrada para escritura 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 de Uso para revisar los desgloses disponibles. Las tablas muestran las medidas pertinentes para cada fila, como solicitudes, tokens de entrada y salida o unidades específicas de cada funcionalidad.

En Funcionalidades de la API, selecciona Ver en una funcionalidad para abrir sus gráficos detallados y desgloses. Respuestas y completado de chats incluye gráficos separados de Tokens y Solicitudes, y 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 Uso en la ruta de navegación para volver a la vista general.

Después de seleccionar una opción de Agrupar por, el gráfico puede combinar 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 período de informe. Usa Panel izquierdo y Panel derecho para seleccionar las vistas. Si el intervalo de tiempo seleccionado no está disponible para ese par de paneles, la vista cambia a Automático. Selecciona Salir de la comparación para volver al panel.

Investiga el uso que no reconozcas

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

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

  2. Usa la vista de proyecto para el proyecto afectado o selecciónalo en Proyecto, dentro de Análisis de la organización. Luego, usa Filtros para acotar el uso por clave de API y modelo, y selecciona un período de informe más corto.

  3. Compara la actividad con los registros del mismo período, 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, es posible que el total por sí solo no permita identificar cuál envió una solicitud. Compara el panel con los registros de cada aplicación para el mismo período en UTC.

  5. Si aún no puedes explicar el uso, ponte en contacto con el soporte de OpenAI e incluye el período 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.

Exporta datos de uso

Para exportar el uso, selecciona el ícono Exportar CSV en la barra de herramientas de Análisis y luego selecciona Datos de actividad.

  1. Selecciona la Funcionalidad de la API y una o más dimensiones de Agrupar por.

  2. Revisa Origen de la API, Proyectos, Usuarios, Claves de API y Modelos. Proyectos y Origen de la API conservan la selección de Análisis; selecciona los demás filtros de exportación en el cuadro de diálogo.

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

Puedes consultar y exportar datos de actividad y costos desde las 00:00 UTC de la misma fecha del año pasado hasta hoy. Para obtener datos anteriores, ponte en contacto con el soporte de OpenAI. Los datos diarios se exportan en archivos que abarcan períodos de 31 días.

Para conciliar facturas mensuales y exportar partidas, consulta: exportar los detalles de uso mensual.

Si una exportación de actividad incluye filas con valores negativos, compara las filas que tengan la misma unidad, agrupación y fechas. Usa Datos de costos 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.

Revisa los gastos

Abre Análisis y selecciona Gastos para revisar los costos del proyecto actual. Para consultar los costos de toda la organización, selecciona Análisis de la organización y luego Gastos.

Comprueba el rango de fechas actual y los filtros antes de comparar los costos con el uso. Uso y Gastos ofrecen filtros diferentes; un filtro disponible en un panel puede no aplicarse al otro.

Usa Orígenes de la API, Claves de API, Modelos y Partidas para acotar los gastos. En el análisis de la organización, usa Proyecto para incluir los proyectos que quieres revisar. 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 configurar o una solicitud fallida pueden impedir que el panel muestre un valor.

Revisa el estado del servicio

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

Consulta los 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 a preguntas distintas: los créditos otorgados muestran los créditos asociados con 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 por el modelo.

El costo de la suscripción al Nivel de capacidad sigue correspondiendo a la organización. Revisa el gasto de toda la organización en lugar de basarte en el gasto de un solo proyecto.

Revisa varias organizaciones

El panel de uso no combina datos de costos 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, considera usar proyectos dentro de una misma organización en lugar de suborganizaciones separadas, o usa la API de uso para realizar análisis personalizados.

Consulta 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
Total de tokensusage.total_tokensusage.total_tokens

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

{
"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 extensión visible de una respuesta no refleja su uso total de tokens.

Para obtener una explicación de las distintas categorías de tokens, consulta: entender y contar tokens.

En una respuesta de transcripción que informa el uso 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.

Obtén 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 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 el valor null en usage.

Si se interrumpe el streaming, 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 detalles, consulta: referencia de la API para completar chats.

¿Este artículo te fue útil?