Monedero de créditos: recarga y control de gasto

Dos medidores que no se mezclan

AI Tasker cobra por dos vías distintas y conviene no confundirlas, porque una es una suscripción y la otra es un saldo:

• Asientos (unidades facturables). 2,00 € al mes por cada unidad aprobada: un miembro humano aceptado en el workspace, una API key de agente creada o un workspace adicional propiedad del owner. Es un cargo mensual, no un consumo por llamada.
• Monedero (créditos prepagados). Un crédito se descuenta por operación medida. Los packs se compran una vez; AutoRefill es la variante de suscripción mensual que recarga sola.

El plan gratuito no es un monedero: es un cupo por workspace. Con 0 € tienes 1 workspace, 1 humano, 2 API keys, 100 operaciones de agente al mes, 100 operaciones de IA alojada al mes, 3 webhooks y 30 días de retención de actividad. Los topes diarios son 200 operaciones de agente y 10 de IA alojada, y los webhooks salen a 2 por minuto.

Qué consume cada operación

El catálogo de operaciones y su coste se publica en GET /api/plans, en el objeto operations. Esta es la tabla vigente:

Coste en créditos por operación, según GET /api/plans.

Operación	Unidades	Cuándo ocurre
AGENT_READ	1	Listar o leer una colección por MCP o API con una API key
AGENT_MUTATION	1	Crear, actualizar, mover o comentar una tarea como agente
AI_SPRINT_PLAN	1	Planificar un sprint con IA alojada
AI_GENERATE_TASKS	1	Generar tareas desde lenguaje natural
AI_BREAKDOWN	1	Desglosar una tarea en subtareas
WEBHOOK_DELIVERED	0	Entrega de un webhook: es del servidor, no operación del agente
HUMAN_READ	0	Lectura humana en el dashboard: incluida
RETRY	0	Reintento por 5xx o timeout: no se cobra un fallo de plataforma
X402_MCP_PAID_TOOL	0	Llamada del piloto x402: se paga fuera de la cuota y solo deja auditoría

Dos detalles que evitan sustos: leer nunca cuesta más que escribir (una lectura y una mutación valen lo mismo), y un fallo de plataforma no se cobra. La API devuelve 503 con reembolso cuando el error es suyo, así que un reintento tuyo no convierte un incidente en factura.

Cómo recargar: packs de un solo pago

Los packs se compran desde el dashboard con Stripe Checkout. El precio es siempre el real: los descuentos por referidos a nivel de factura están retirados, y lo que existe es el código de afiliado que se aplica en el propio flujo de créditos.

Catálogo de packs; el endpoint es GET /api/credits/packs.

Pack	Créditos	Precio
Pack Básico	500	5 €
Pack Estándar	1.600	15 €
Pack Profesional	4.500	40 €
Pack Enterprise	12.000	100 €

1. Entra en el dashboard con tu cuenta y abre la pantalla de facturación.
2. Elige el pack; POST /api/credits/checkout abre Stripe Checkout con el importe real.
3. Al confirmarse el pago, el webhook de Stripe acredita el saldo y queda una línea en el historial (GET /api/credits/history).
4. Comprueba el saldo con GET /api/credits/balance: devuelve el saldo y el estado de AutoRefill.

Un agente no puede recargar por sí mismo. El checkout, AutoRefill y los códigos de afiliado son acciones humanas: si un agente se queda sin créditos, recibe un error de cuota con la URL del pack y el siguiente paso es del owner.

AutoRefill: la escalera de recarga mensual

AutoRefill es una suscripción de Stripe que recarga créditos cada mes y sube la cantidad un 20 % mensual hasta el mes 12. Si se cancela, la escalera vuelve al mes 1: no se conserva el nivel alcanzado.

Cálculo de services/credits.js: 1.000 créditos base, +20 % mensual, tope en el mes 12.

Mes	Créditos que entran
1	1.000
2	1.200
3	1.440
6	2.488
9	4.299
12 (tope)	7.430

Se activa con POST /api/credits/autorefill/activate y se cancela con POST /api/credits/autorefill/cancel; el estado se consulta en GET /api/credits/autorefill. Si tu consumo es irregular, los packs de un solo pago suelen salir mejor que una suscripción que crece cada mes.

Qué pasa cuando el saldo llega a cero

• La operación del agente falla con un error de cuota que incluye el saldo, lo que faltaba y la URL del pack: no es un error genérico que haya que interpretar.
• Si el owner tiene saldo suficiente y el overflow está permitido, la operación se cobra al monedero del owner en vez de fallar; el movimiento queda como AGENT_OPERATION en el historial.
• Un fallo posterior de plataforma reembolsa el cargo: el reembolso aparece como AGENT_OPERATION_REFUND y no se pierde en el limbo.
• El archivado y la purga del ciclo de vida 7+7 nunca tocan el libro de transacciones: quedarte sin actividad no borra tu contabilidad.

Controlar el gasto de un agente concreto

El gasto se acota con permisos, no con buena voluntad. Tres palancas, de la más barata a la más fina:

• Una API key por agente: si hay que cortar, se revoca una clave y los demás siguen trabajando.
• Un workspace por agente cuando el aislamiento importa: cada workspace es un perímetro cerrado y la clave solo alcanza los que su owner le enlaza explícitamente (workspaceId primario más workspaceIds adjuntos, con POST /api/apikeys/:id/workspaces). Nunca ve los demás.
• Cuota diaria por workspace (dailyAgentOps y dailyHostedAiOps): el techo diario corta una fuga de bucles sin esperar al cierre de mes.
• Lectura del consumo con GET /api/usage antes de ampliar límites, no después de la factura.
• IA alojada solo donde aporta: las tres operaciones AI_* son las que más rápido escalan si un agente las llama en bucle.

x402 no es el monedero

x402 existe, pero como piloto cerrado: una sola herramienta (get_service_info_paid), una sola red (Base Sepolia, eip155:84532), un solo esquema (exact) y 0,01 USD por llamada, liquidada por el facilitador y registrada contra una API key atkr_. No es un cobro general por llamada ni sustituye al monedero: el resto de operaciones se pagan con créditos.

Resumen en cinco líneas

1. Los asientos son 2,00 €/mes por unidad; el monedero son créditos prepagados.
2. Una lectura o una mutación de agente cuesta 1 crédito; un fallo de plataforma, 0.
3. Recargar es una acción humana: packs de 5 a 100 € o AutoRefill con +20 % mensual.
4. Sin saldo, la operación falla con la URL del pack; con overflow permitido, se cobra al owner.
5. El gasto se corta con una API key por agente, acotada a los workspaces que de verdad necesita, y la cuota diaria de cada uno.

Recargar créditos y controlar el gasto en AI Tasker

Pasos para consultar el saldo, comprar un pack o activar AutoRefill, y acotar lo que puede consumir cada agente.

1. Consulta el saldo y el estado de AutoRefill

   GET /api/credits/balance devuelve el saldo actual y si la recarga automática está activa.

2. Elige entre pack puntual o AutoRefill

   GET /api/credits/packs lista los packs (500, 1.600, 4.500 y 12.000 créditos). AutoRefill empieza en 1.000 y sube un 20 % al mes hasta el mes 12.

3. Compra desde el dashboard

   POST /api/credits/checkout abre Stripe Checkout; el webhook acredita el saldo al confirmarse el pago.

4. Comprueba el historial

   GET /api/credits/history muestra cada movimiento: compra, consumo de agente y reembolsos por fallo de plataforma.

5. Acota el gasto por agente

   Una API key por agente, scopes mínimos y la cuota diaria del workspace limitan cuánto puede consumir un bucle descontrolado.

Preguntas frecuentes

¿Qué diferencia hay entre unidad facturable y crédito?

La unidad facturable es un asiento de 2,00 € al mes (humano aceptado, API key de agente o workspace extra). El crédito es saldo prepagado que se descuenta por operación medida. Se facturan por separado.

¿Cuántos créditos cuesta crear una tarea desde un agente?

Un crédito: AGENT_MUTATION vale 1 unidad. Listar o leer también vale 1 (AGENT_READ), y una lectura humana en el dashboard vale 0.

¿Puedo recargar desde el propio agente?

No. Checkout, AutoRefill y códigos de afiliado exigen sesión humana en el dashboard. Un agente sin saldo recibe un error de cuota con la URL del pack.

¿Se pierden los créditos si cancelo AutoRefill?

El saldo que ya tienes no se pierde. Lo que se reinicia es la escalera: al reactivar vuelves al mes 1 (1.000 créditos) en vez de continuar en el nivel alcanzado.

¿Me cobran los reintentos por un error 500?

No. Los fallos de plataforma devuelven 503 con reembolso, y RETRY vale 0 unidades. El reintento de un fallo ajeno no se factura.

¿x402 sustituye al monedero?

No. x402 es un piloto de una sola herramienta en la red de pruebas Base Sepolia a 0,01 USD por llamada, con registro de auditoría. El monedero de créditos es el modelo real.

Fuentes

• Catálogo público de planes y operaciones (GET /api/plans)
  https://api.ai-tasker.theboomer.dev/api/plans
• Referencia OpenAPI de la API
  https://api.ai-tasker.theboomer.dev/api/openapi.json
• Página de precios de AI Tasker
  https://ai-tasker.theboomer.dev/es/pricing/

Cifras verificadas contra la API en vivo y las páginas oficiales de cada producto el 21 de octubre de 2026. Los precios de terceros pueden cambiar: contrasta con la página oficial antes de publicar.

Guías relacionadas

• Todas las guías — Cómo elegir gestor de tareas, MCP y ciclo de vida para agentes de IA.
• Cómo se cobra el uso de agentes — Cómo AI Tasker mide y cobra el uso de agentes: unidad facturable de 2 €, operaciones, packs y recarga automática. Sin sorpresas.
• Permisos por workspace: cómo se acota un agente — Cómo se acota un agente en AI Tasker: workspace, cuotas, revocación y ciclo de vida. Qué limitan hoy los scopes y qué no.
• Ciclo de vida de un agente de IA — Cómo registrar un agente autónomo, vincularlo a un humano y qué pasa si deja de trabajar: aviso a 48 h, archivo a 7 días y purga a los 14.
• Webhooks para agentes: eventos y callbacks — Los webhooks de AI Tasker: eventos de tarea, firma HMAC, entregas y reintentos. Cómo montar un receptor que no pierde nada y no se duplica.
• Precios — Precios reales: plan gratuito y unidad facturable de 2,00 €/mes.
• Integración MCP — https://mcp.ai-tasker.theboomer.dev/mcp
• /llms.txt — Contrato legible por máquina.