Documentación

Créditos y medición

Comprende el sistema de créditos, sigue el consumo y configura alertas de presupuesto.

Créditos y medición

betool cobra por uso en créditos: 1 crédito = 0,0001 $ (una diezmilésima de dólar). Recargas tu saldo por adelantado; cada ejecución debita el coste correspondiente.

Por qué créditos

El sistema de créditos permite:

  • Granularidad fina — una llamada de API que cuesta 0,000003 $ es medible sin redondeo.
  • Estabilidad de precios — tus precios unitarios en créditos no cambian cuando un proveedor revisa sus tarifas.
  • Aislamiento por organización — cada organización tiene su propio saldo y sus propias alertas.

¿Qué se factura?

Consulta los detalles en Precios. Resumen:

  • LLM — por token de entrada / salida. Incluido con BYOK (pagas directamente a tu proveedor; betool no cobra nada por los tokens).
  • Voz — ASR por segundo, TTS por carácter.
  • Minutos de teléfono — según el número de destino.
  • Operadores HTTP / BD / transform — no medidos.

Recargar tu saldo

Dos modos:

  • Manual — desde Administración → Facturación → Saldo, añade un importe puntual.
  • Recarga automática — recarga automática cuando el saldo cae por debajo de un umbral. Recomendado para evitar interrupciones del servicio.

En el plan Enterprise, la facturación puede pasar a pospago mensual con un compromiso mínimo.

Seguir el consumo

Administración → Facturación → Consumo:

  • Saldo actual
  • Consumo a 7 días / 30 días / rango personalizado
  • Top 10 de los pipelines / agentes más caros
  • Desglose por tipo de recurso

La tabla es exportable como CSV para integrarla con tu reporting interno.

Alertas

Configura hasta 5 umbrales de alerta por organización:

  • Saldo bajo — cuando el saldo cae por debajo de X créditos, notifica a Y (email, Mattermost, webhook).
  • Pico de uso — cuando el consumo horario supera Z, alerta de inmediato.
  • Pipeline caro — cuando un pipeline específico consume más de lo esperado.

Rechazo previo a la llamada

Si tu saldo es insuficiente para ejecutar una llamada LLM o una llamada telefónica, betool rechaza la ejecución antes de cualquier débito. Verás un mensaje explícito en el historial, y el pipeline se marca como out_of_credits.

Ningún sobrecargo es posible: una llamada nunca comienza sin crédito disponible.

Para desarrolladores

Si llamas a la API de administración, el endpoint /api/admin/billing/balance devuelve tu saldo y tu límite de crédito. Todo llamador que capture Exception debe re-lanzar OutOfCreditsError primero — es una señal de facturación, no un error de negocio.