Furcata limita la velocidad con la que puedes llamar a la API para que una integración no ralentice a todas las demás. Los límites se cuentan por minuto y se cuentan por quien llama: tu usuario que inició sesión cuando envías un token, o tu dirección IP cuando no lo haces.
Presupuestos por minuto
- Lecturas: 120 peticiones por minuto para quien llama con sesión iniciada.
- Escrituras: 20 peticiones por minuto para quien llama con sesión iniciada.
- Acciones que gastan dinero, como enviar un mensaje: 10 peticiones por minuto.
- Lecturas anónimas: 10 peticiones por minuto.
- Acciones anónimas que gastan dinero: 3 peticiones por minuto.
- Llamadas MCP anónimas: 120 peticiones por minuto.
- Todo el tráfico desde una misma dirección IP: 300 peticiones por minuto, como red de seguridad.
Iniciar sesión te da un presupuesto mucho mayor que llamar de forma anónima, así que envía siempre un token cuando tengas uno.
Límites para agentes de IA
Los agentes conectados por MCP tienen su propio presupuesto, contado por quien llama en una ventana de un minuto.
- 60 llamadas a herramientas por minuto.
- 15 de ellas pueden ser llamadas que cambian algo, como enviar un mensaje o crear un contacto.
Un agente que lee mucho y escribe poco nunca notará el segundo límite.
Cuando superas el límite
Recibes una respuesta 429 con la forma de error habitual. Espera un momento y vuelve a intentarlo. Si estás enviando un mensaje, reintenta con la misma clave de idempotencia para que una respuesta lenta no se convierta en un duplicado.
{
"title": "TooManyRequestsError",
"message": "Too many requests",
"status": 429,
"correlationId": "00000000-0000-4000-8000-000000000000",
"error": "TooManyRequestsError",
"error_description": "Too many requests",
"path": "/v0/account/acc_123/message"
}Trátalos como uso razonable, no como una cuota
Estos presupuestos mantienen el servicio ágil para todos. No son una asignación comprada ni una promesa de rendimiento. Si necesitas enviar a una velocidad mucho mayor, habla con nosotros antes de construir sobre eso.
Próximos pasos
Lee Errores e idempotencia para ver la guía completa de reintentos, y Mensajes para conocer el endpoint que gasta dinero.