La API de gestión de TokenLab añade la consulta de saldo de la organización

La API de gestión de TokenLab ahora admite la consulta directa de saldo, lo que permite a los equipos consultar el saldo total actual de su organización a través de un token de gestión en lugar de revisar el panel de control manualmente. Esto cierra una brecha común para los equipos que ejecutan comprobaciones presupuestarias automatizadas, alertas de recarga o flujos de trabajo limitados por el uso.

Puntos clave

• La API de gestión ahora expone un endpoint de saldo que devuelve el saldo total actual de su organización.
• Esto es independiente de las API keys de inferencia de modelos utilizadas para llamar a Claude Sonnet 5, GPT-5.5, Gemini 3.5 Flash y otros modelos.
• La consulta de saldo está pensada para comprobaciones presupuestarias, alertas de recarga, pausar o reanudar flujos de trabajo automatizados y alimentar paneles financieros.
• El endpoint se combina bien con el endpoint de uso de API keys existente para crear una imagen completa del gasto.

Por qué faltaba esto

Antes de esta actualización, consultar el saldo de su organización significaba iniciar sesión en el panel de control de TokenLab y leerlo en la página de facturación. Eso está bien para una persona que revisa una vez al día, pero deja de funcionar en el momento en que desea automatizar algo.

Los equipos que ejecutan cargas de trabajo de producción en modelos como DeepSeek V4 Pro, Qwen3.7 Plus o Kimi K2.7 Code a menudo quieren un script que verifique el saldo antes de iniciar un trabajo grande, o un monitor que dispare una alerta cuando el saldo caiga por debajo de un umbral. Sin un endpoint de saldo consultable, las únicas opciones eran las comprobaciones manuales o el scraping del panel de control, ninguna de las cuales es algo que desee ejecutar en producción.

La consulta de saldo a través de la API de gestión soluciona esto. Ahora, la misma automatización que activa un lote de trabajos de generación de video en Kling 3.0 o Seedance puede verificar primero el saldo disponible y decidir si proceder.

Tokens de gestión frente a API keys de inferencia de modelos

Vale la pena ser preciso al respecto, porque los dos tipos de credenciales sirven para propósitos diferentes y mezclarlos conduce a errores confusos.

Las API keys de inferencia de modelos son las que utiliza para llamar a los modelos directamente. Si está enviando una solicitud de chat completion a GPT-5.5, generando una imagen con GPT Image 2 o Nano Banana Pro, o renderizando video con Veo 3 o PixVerse V6, se está autenticando con una clave de inferencia. Estas claves tienen un alcance limitado a realizar llamadas a modelos y devolver resultados de modelos. No le dan acceso a datos a nivel de cuenta como el saldo o los resúmenes de uso.

Los tokens de gestión son un tipo de credencial independiente creado para operaciones de cuenta. Le permiten consultar cosas sobre su organización en su conjunto: saldo, uso a través de API keys y otros datos a nivel de cuenta. Un token de gestión no llama a ningún modelo directamente. Es la credencial que utiliza para el lado contable de ejecutar una cuenta en TokenLab, no para el lado de la generación.

Mantenerlos separados es importante por una razón práctica: le permite entregar un token de gestión a un proceso financiero u operativo sin darle a ese proceso la capacidad de agotar su presupuesto de modelos. Por el contrario, un servicio que solo necesita llamar a GLM-5.2 o DeepSeek V4 Flash no necesita visibilidad de su saldo o historial de gastos, por lo que solo debería tener una clave de inferencia.

Cómo funciona la consulta de saldo

El nuevo endpoint devuelve el saldo total actual de su organización como una respuesta directa. Lo llama con un token de gestión y le indica cuál es la situación.

Aquí hay un ejemplo mínimo usando valores de marcador de posición:

curl -s https://api.tokenlab.sh/v1/management/balance \
  -H "Authorization: Bearer YOUR_MANAGEMENT_TOKEN"

La respuesta le da la cifra de saldo actual de su organización. A partir de ahí, el patrón habitual es:

1. Llamar al endpoint de saldo según un horario, o justo antes de que comience un trabajo costoso.
2. Comparar el valor devuelto con un umbral que usted defina.
3. Activar cualquier acción que tenga sentido: enviar una alerta, pausar una cola, bloquear nuevas presentaciones de trabajos o simplemente registrarlo para más tarde.

Debido a que esta es una operación de lectura simple, es económico llamarla con frecuencia. Los equipos que ejecutan pipelines de alto volumen contra modelos como DeepSeek V4 Pro o Claude Sonnet 5 pueden verificar el saldo antes de cada lote grande sin añadir una sobrecarga significativa.

Los detalles completos del endpoint se encuentran en la referencia de saldo de la API de gestión.

Dónde encaja esto: comprobaciones presupuestarias, alertas y paneles

Los usos más comunes que los equipos han estado solicitando se asignan a cuatro escenarios:

Caso de uso	Cómo se ve
Comprobación presupuestaria previa al trabajo	El script verifica el saldo antes de enviar un trabajo por lotes grande a un modelo como Kling 3.0 o Veo 3, omite el trabajo si el saldo es demasiado bajo
Alertas de recarga	La verificación programada compara el saldo con un valor mínimo, envía una alerta de Slack o correo electrónico cuando se cruza
Pausa y reanudación del flujo de trabajo	La automatización pausa un pipeline que llama a Qwen3.7 Plus o GLM-5.2 cuando el saldo cae, y se reanuda una vez que se recarga
Paneles financieros	La cifra de saldo se extrae según un horario y se muestra junto con los datos de uso para la generación de informes

Si está configurando esto por primera vez, una breve lista de verificación ayuda a mantener la implementación limpia:

• Cree o confirme que su token de gestión tiene el alcance correcto para el acceso al saldo
• Almacene el token de gestión por separado de cualquier API key de inferencia
• Establezca un intervalo de sondeo sensato (una vez por trabajo, cada hora o diariamente, según su caso de uso)
• Decida su umbral de alerta de antemano, no después de que el saldo sea bajo
• Combine la consulta de saldo con el endpoint de uso de API keys si desea un desglose completo del gasto junto con la cifra de saldo

Para los equipos que también desean datos históricos de gastos en lugar de solo un número de saldo en vivo, la publicación sobre exportaciones de uso del panel de control cubre cómo extraer esos datos para la generación de informes.

Primeros pasos

Si ya está utilizando la API de gestión para la generación de informes de uso, añadir comprobaciones de saldo es sencillo: mismo patrón de autenticación, un nuevo endpoint al que llamar. Si aún no ha configurado un token de gestión, genere uno desde la configuración de su cuenta y manténgalo separado de cualquier API key de inferencia que utilice para llamar a los modelos.

Preguntas frecuentes

¿La consulta de saldo requiere una API key especial? No hay un tipo de clave especial más allá de un token de gestión estándar. Es una credencial diferente a las API keys de inferencia utilizadas para llamar a los modelos, pero no se necesita configuración adicional más allá de tener un token de gestión válido.

¿Puedo usar esto para detener automáticamente los trabajos cuando se agota el saldo? Sí. Ese es uno de los casos de uso principales. Verifique el saldo antes o durante un trabajo, y si cae por debajo de su umbral, pause el flujo de trabajo, detenga la cola o bloquee nuevas presentaciones hasta que se restablezca el saldo.

¿Es esto lo mismo que el endpoint de uso? No. La consulta de saldo devuelve su saldo total actual. El endpoint de uso de API keys devuelve datos de uso desglosados por clave. La mayoría de los paneles financieros utilizan ambos juntos.

Fuentes y frescura

Este artículo refleja el endpoint de saldo de la API de gestión observado el 2026-07-07. El comportamiento del endpoint y los formatos de respuesta pueden cambiar; consulte la documentación oficial del endpoint de saldo para obtener la referencia actual.

---

¿Listo para integrar comprobaciones de saldo en su flujo de trabajo? Inicie sesión en TokenLab, genere un token de gestión y comience a consultar el saldo de su organización hoy mismo.

Lecturas relacionadas y siguientes pasos

La consulta de saldo de la organización funciona junto con otras herramientas de informes ya disponibles en la API de gestión de TokenLab. Para obtener una visión más detallada de cómo se pueden extraer y revisar los datos de gasto de forma regular, consulte Las exportaciones de uso de TokenLab facilitan la revisión del gasto en API de IA. Si está planificando el gasto antes de un lanzamiento, la Guía de la calculadora de costos de API de IA: estime el gasto antes de lanzar explica cómo estimar los costos antes de que se realicen las solicitudes. Y para conocer cómo se comparan los proveedores entre sí, la Comparación de precios de API de IA 2026: el costo real de GPT-5.5, Claude Sonnet 5 y Gemini 3.5 Flash desglosa las tarifas actuales en los principales modelos.

Como siempre, la disponibilidad y los precios de los modelos cambian con frecuencia, así que confirme los detalles actuales antes de confiar en ellos para un uso de producción de alto volumen. ¿Listo para probar la consulta de saldo usted mismo? Cree una API key y comience a probarla hoy.