Cada clave de API y cada conexión de asistente tiene un tope de gasto diario en créditos. Para una conexión nueva, el tope por defecto es 5000 créditos.
Puedes añadir otros dos límites a una clave o conexión:
- un tope mensual, sobre el mes natural (UTC);
- un tope por pregunta, lo máximo que puede costar una sola pregunta.
Qué pasa al llegar al tope
Una pregunta que haría superar a la conexión cualquiera de sus topes se rechaza: la API responde 402 con spend_cap_reached (el servidor MCP lo informa como spend_cap_exceeded). El error indica cuánto queda y, en los topes diario y mensual, cuándo se reinicia. No se gasta nada. Leer resultados sigue funcionando. Una pregunta cancelada o reembolsada devuelve sus créditos al tope.
Consultar lo que queda
La consulta de saldo de tu asistente y GET /v1/billing/balance devuelven capRemaining para la clave o conexión que estás usando: lo menor entre lo que queda hoy y este mes. Un agente bien hecho lo consulta antes de preguntar, pero el tope se aplica tanto si lo consulta como si no. GET /v1/connections/current muestra los topes de la conexión y lo que ha gastado hoy y este mes.
Cambiar un tope
En Desarrolladores, abre Permisos y límites en una clave o Límites y permisos en una conexión y fija los nuevos topes. El cambio surte efecto al momento.
En un equipo, el propietario o un administrador puede cambiar el tope de una clave o de una app que creó otro miembro. Abre Claves y apps en Equipo o, para una conexión de Zapier, Ajustes, luego Integraciones. Consulta Tu equipo.
Las claves antiguas, de antes de los topes, no tienen ninguno. Aparecen en Desarrolladores en Claves antiguas para que puedas revocarlas, y las retiraremos con 90 días de aviso. Crea en su lugar una clave nueva con un tope.
Avisos
En Desarrolladores, Alertas, eliges cuáles de estos correos quieres. Van al correo de tu cuenta, y cada uno trae un enlace para darte de baja que desactiva solo esa alerta.
- Una conexión llega al 80 % de su tope diario (o de su tope mensual, si lo tiene).
- Se disparan los errores: una conexión tuvo ayer al menos 50 llamadas y más de una quinta parte falló.
- Se conecta un agente nuevo.
Las alertas están en Desarrolladores, no en Ajustes y luego Correos.
Límites de la cuenta
Los topes de las claves están dentro de los límites de tu cuenta: un agente nunca puede gastar más que tu saldo. En una clave o conexión creada para un equipo, las preguntas gastan los créditos del equipo, y el límite mensual del miembro en el equipo también se aplica.