# Saldo de IA

El «Saldo de IA» es un saldo aparte con el que se pagan las llamadas a los modelos: las respuestas en el [chat de IA](https://support.cleverapp.pro/es/ai/chat), las respuestas del [agente de IA](https://support.cleverapp.pro/es/chatbots/blocks/ai-agent) en un bot y la [creación de un bot](https://support.cleverapp.pro/es/chatbots/ai-builder). No hay cuota de suscripción: solo se cobra lo que el modelo hizo realmente.

Hay un único saldo para toda la cuenta, compartido por todos tus proyectos. La moneda es la misma que la del saldo de tu cuenta.

> [!NOTE]
> La base de conocimiento se paga de otra forma: cada mes, con el saldo de la cuenta. El «Saldo de IA» no se gasta en ella. Consulta la página [Plan y tokens](https://support.cleverapp.pro/es/knowledge-bases/plan) para más detalles.

## Cómo recargarlo

El «Saldo de IA» se recarga con una transferencia desde el saldo de la cuenta, uno a uno y sin comisión.

1. Abre la sección «Facturación» y elige «Saldo de IA» en el menú de la derecha.
2. Haz clic en «Recargar».
3. En la ventana «Recargar saldo de IA», introduce el importe. Debe tener como máximo dos decimales, por ejemplo 500 o 99.90.
4. Haz clic en «Recargar».

Encima del campo del importe está el «Saldo interno», el dinero que hay en el saldo de la cuenta; debajo del campo, el «Saldo de IA» actual.

Si no hay suficiente dinero en el saldo de la cuenta, se abre la ventana «Fondos insuficientes» con el importe que falta: recarga primero el saldo de la cuenta y la transferencia se hará a continuación.

> [!IMPORTANT]
> Al «Saldo de IA» solo se transfiere dinero. Los puntos de bono no se pueden usar para recargarlo.

Debajo del saldo está el «Historial de recargas»: la fecha y el importe de cada transferencia. Las recargas hechas por la [recarga automática](https://support.cleverapp.pro/es/ai/balance#recarga-automática) se marcan con «auto». El «Saldo de IA» actual también se ve en las páginas «Plan» y «Transacciones», junto al saldo de la cuenta y los puntos de bono.

También puedes recargar el «Saldo de IA» directamente desde el chat: cuando se agotan los fondos, el propietario del proyecto ve el botón «Recargar» encima del campo de entrada.

## Quién paga

El consumo se descuenta del «Saldo de IA» del **propietario del proyecto**. Si un miembro del equipo trabaja en el chat de IA del proyecto o un agente de IA responde en el bot del proyecto, paga el propietario. Un miembro del equipo no necesita su propio «Saldo de IA» para trabajar en el proyecto de otra persona.

## Cómo se calcula el costo

Los modelos cuentan el texto en tokens. Un token es una palabra o parte de una palabra. El precio de un modelo se da por millón de tokens, por separado para la entrada y la salida.

- **Tokens de entrada**: todo lo que recibió el modelo: tu pregunta, toda la conversación anterior, los documentos adjuntos, los resultados de las herramientas.
- **Tokens de salida**: lo que el modelo escribió en su respuesta.

Costo de una respuesta = tokens de entrada × precio de entrada + tokens de salida × precio de salida. Los precios de los modelos están en la página [Precios de los servicios adicionales](https://support.cleverapp.pro/es/billing/services) y, en tu panel, en la sección [«Modelos de IA»](https://support.cleverapp.pro/es/ai/models).

De aquí salen tres reglas para ahorrar:

- **Una conversación larga cuesta más que una corta.** Con cada mensaje nuevo, el modelo vuelve a recibir todo el historial. Empieza una conversación nueva para cada tema nuevo y acorta las largas con «Comprimir contexto».
- **Las herramientas añaden solicitudes.** Cuando el modelo busca en la web o lee un documento, se llama a sí mismo varias veces seguidas: pregunta, obtiene el resultado y continúa. Cada una de esas llamadas se paga.
- **El modelo importa más que la longitud de la pregunta.** La misma respuesta puede costar muchas veces más o menos según el modelo.

### Caché de prompts

El principio de una solicitud en una conversación larga se repite de un mensaje a otro: las mismas instrucciones, el mismo historial. Algunos modelos pueden recordar ese principio repetido: eso es la caché.

- **Desde caché**: tokens que el modelo tomó de la memoria en lugar de volver a procesarlos. Cuestan menos que la entrada normal.
- **Escritura en caché**: tokens que el modelo guardó en la memoria para las siguientes solicitudes.

Los precios de la caché se muestran en la página del modelo: «Entrada en caché» y «Escritura en caché». Si un modelo no tiene esos precios, estos tokens se cuentan al precio de entrada normal. No necesitas hacer nada: la caché funciona sola.

### Qué se paga además de las respuestas

- **Búsqueda web**: cada búsqueda se paga aparte, además de los tokens.
- **Las solicitudes de servicio del chat**: el nombre de la conversación, los títulos de los pasos de una respuesta, la detección del idioma de un documento. Las realiza un modelo de servicio aparte; cada una aparece en «Registros» como una fila aparte.
- **Compresión del contexto**: el resumen lo escribe el modelo seleccionado.
- **Una respuesta detenida**: pagas la parte del trabajo que el modelo llegó a hacer antes de detenerse.

## Cuando se agotan los fondos

La plataforma comprueba el «Saldo de IA» antes de cada respuesta.

**En el chat de IA.** El mensaje no se envía y se queda en el campo de entrada junto con los archivos adjuntos. Encima del campo verás: «No hay suficiente saldo de IA. Recarga tu saldo para continuar.» El propietario del proyecto ve el botón «Recargar» al lado; un miembro del equipo solo ve el mensaje.

Si los fondos se agotan en mitad de una respuesta en la que el modelo trabaja con herramientas, la respuesta se detiene. Lo que el modelo llegó a escribir se queda en la conversación.

**En un bot con un agente de IA.** El agente no responde y se activa la salida «Error de IA». Qué hacer con ella se explica en la página [Agente de IA](https://support.cleverapp.pro/es/chatbots/blocks/ai-agent).

Cuando el saldo se agota, el propietario de la cuenta recibe una notificación de que se ha quedado sin saldo de IA y un email: consulta [Avisos de saldo](https://support.cleverapp.pro/es/ai/balance#avisos-de-saldo). Para no llegar a eso, activa la [recarga automática](https://support.cleverapp.pro/es/ai/balance#recarga-automática).

> [!WARNING]
> Una respuesta se paga cuando está lista, así que la última respuesta puede dejar el saldo un poco por debajo de cero. El importe negativo se cubre con la siguiente recarga.

## Avisos de saldo

La plataforma avisa dos veces al propietario de la cuenta:

- **«Se está agotando»**: cuando el saldo baja del umbral. Llega al panel y a tu app de mensajería de notificaciones.
- **«Se ha agotado»**: cuando el saldo llega a cero y las respuestas de la IA se detienen. Llega al panel, a tu app de mensajería de notificaciones y por email, si tu email está confirmado.

Cada aviso llega una sola vez. Vuelve a llegar solo después de que recargues y el saldo vuelva a bajar. Mientras el saldo esté bajo o agotado, en la página «Saldo de IA» se muestra un banner encima.

En la app de mensajería, los avisos llegan en la categoría «Plan y pagos»: cómo activarla se explica en la página [Notificaciones](https://support.cleverapp.pro/es/account/notifications).

### El umbral de «se está agotando»

El umbral se fija en «Facturación» → «Saldo de IA», bloque «Configuración», opción «Avisarme cuando el saldo se esté agotando»:

- **«Automáticamente»**: la opción predeterminada. Te avisaremos cuando el saldo baje de aproximadamente lo que gastas en 3 días. El consumo se toma de la última semana. Debajo del interruptor se ve el importe con el que llegaría el aviso ahora mismo. Si todavía no ha habido consumo, el umbral es un importe fijo pequeño.
- **«Por debajo de un importe»**: introduce tu propio importe.

Haz clic en «Guardar».

## Recarga automática

La recarga automática transfiere dinero del saldo de la cuenta al «Saldo de IA» por sí sola cuando este baja de un importe fijado. Así, las respuestas del chat de IA y los bots con un agente de IA no se detienen por un saldo vacío.

1. Abre «Facturación» → «Saldo de IA».
2. En el bloque «Configuración», activa «Recarga automática».
3. La primera vez que la activas, los campos ya están rellenados con valores predeterminados, incluido un límite mensual. Ajústalos a tu consumo:
   - «Cuando baje de»: con qué saldo recargar;
   - «Recargar»: cuánto transferir cada vez. Los importes pequeños no se transfieren: el mínimo se muestra en el campo, por ejemplo $1;
   - «Límite mensual»: el tope de recargas automáticas por mes natural. El límite no puede ser menor que el importe de recarga. Si vacías el campo, no habrá límite.
4. Haz clic en «Guardar».

![El bloque «Configuración» con la recarga automática activada](https://support.cleverapp.pro/_media/es/08-ai/_images/credit-settings.webp?v=1792562451)

Si el saldo ya está por debajo del importe «Cuando baje de», se recarga de inmediato al guardar. Tras cada recarga automática recibes una notificación de que tu saldo de IA se ha recargado automáticamente.

> [!IMPORTANT]
> Igual que una recarga normal, la recarga automática solo transfiere dinero. Los puntos de bono no se usan.

**Si no hay suficiente dinero en el saldo de la cuenta**, recibes una notificación de que no se pudo hacer la recarga automática. La recarga automática sigue activada: en cuanto recargues el saldo de la cuenta, se ejecutará sola con la siguiente respuesta de la IA.

**Si se alcanza el límite mensual**, recibes una notificación y la recarga automática no se ejecuta hasta el inicio del mes siguiente. Puedes subir el límite en la misma configuración. Debajo de los campos se ve cuánto se ha recargado automáticamente este mes.

Mientras la recarga automática funciona, el aviso de «se está agotando» no llega: si una recarga falla, te enterarás por las notificaciones anteriores.

## «Registros»

La sección «Modelos de IA» → «Registros». Aquí se registra cada llamada a un modelo en el proyecto, de la más reciente a la más antigua.

| Columna | Qué muestra |
|---|---|
| «Hora» | Cuándo se hizo la llamada |
| «Proveedor» | El desarrollador del modelo |
| «Modelo» | Qué modelo respondió |
| «Tokens de entrada» | Cuántos tokens recibió el modelo. Debajo, cuántos de ellos fueron «desde caché» y «a caché», si se usó la caché |
| «Tokens de salida» | Cuántos tokens escribió el modelo |
| «Tipo» | Qué fue la llamada |
| «Costo» | Cuánto se descontó del «Saldo de IA» |
| «Chat» | Un enlace a la conversación, si la llamada se hizo desde el chat de IA |

Tipos de llamada:

- «Mensaje»: una respuesta en el chat de IA;
- «Llamada a herramienta»: una llamada en la que el modelo pidió una herramienta;
- «Búsqueda web»: la búsqueda en sí;
- «Agente de IA»: la respuesta de un agente en un bot;
- «Compresión del contexto», «Título del chat», «Título de los pasos», «Idioma del OCR»: solicitudes de servicio.

Una respuesta del chat puede ocupar varias filas: el modelo pidió una herramienta, obtuvo el resultado y respondió.

Encima de la tabla están los filtros «Proveedor» y «Modelo» y la selección del periodo.

> [!NOTE]
> El enlace «Chat» solo abre la conversación si es tuya: las conversaciones son personales y la de otra persona no se abrirá desde el enlace.

## «Estadísticas»

La sección «Modelos de IA» → «Estadísticas». Dos gráficos para el periodo seleccionado:

- **«Uso de tokens»**: tokens de entrada y de salida. Si se usó la caché, los tokens de entrada se dividen en normales, «Desde caché» y «Escritura en caché».
- **«Solicitudes»**: el número de llamadas a los modelos.

Encima de los gráficos están el periodo y la granularidad, los filtros «Proveedor» y «Modelo», y un selector de vista: líneas o barras.

Las estadísticas muestran tokens y solicitudes, no dinero. Para ver los importes de cada llamada, consulta «Registros».

Las mismas estadísticas de un solo modelo están en la página del modelo en el catálogo.

## Quién ve los registros y las estadísticas

El propietario del proyecto lo ve todo. Un miembro del equipo necesita los permisos «Ver registros» y «Ver analítica» del grupo «Agentes de IA / Chat» de su rol. Cómo configurar un rol se explica en la página [Acceso de los miembros del equipo](https://support.cleverapp.pro/es/chatbots/settings/access).

El propio «Saldo de IA» y su recarga están en la sección «Facturación» del propietario de la cuenta: cada uno ve y recarga solo su propio saldo.
