Límites de tasa

Límites por espacio de trabajo y por operación, cabeceras y comportamiento de reintento para flujos de trabajo de agentes y llamadas HTTP.

UnifAPI aplica dos capas de limitación de tasa: un límite por espacio de trabajo que suaviza el tráfico a través de todas las Skills y llamadas a la API, y un límite por operación que protege cada fuente de datos públicos.

Cabeceras

Cada respuesta —2xx o 429— lleva las cabeceras estándar:

Cabecera	Significado
`X-RateLimit-Limit`	Solicitudes permitidas en la ventana actual
`X-RateLimit-Remaining`	Solicitudes restantes en la ventana actual
`X-RateLimit-Reset`	Marca de tiempo Unix (segundos) cuando se reinicia la ventana
`Retry-After`	Segundos a esperar antes de reintentar (`429` solamente)

Cuando se aplican tanto un límite de espacio de trabajo como uno de endpoint, las cabeceras reportan el que sea más estricto.

Valores por defecto

Plan	Límite de espacio de trabajo	Límite por endpoint
Free	60 req/min	Según la fuente
Pay-as-you-go	600 req/min	Según la fuente
Enterprise	Personalizado	Personalizado

Cómo manejar `429`

async function call(url: string, init: RequestInit, attempt = 0): Promise<Response> {
  const res = await fetch(url, init);
  if (res.status !== 429 || attempt >= 5) return res;

  const retryAfter = Number(res.headers.get("Retry-After") ?? 1);
  await new Promise((r) => setTimeout(r, retryAfter * 1000));
  return call(url, init, attempt + 1);
}

Dos reglas para tener siempre presentes:

Respeta Retry-After. UnifAPI devuelve el tiempo de espera que la operación necesita; adivinar suele empeorar las cosas.
Aplica backoff ante 429 repetidos. Si una Skill alcanza el límite varias veces seguidas, acota la consulta, reduce la concurrencia o aumenta el límite del espacio de trabajo.

Comportamiento de ráfaga

Los límites son de token-bucket: un espacio de trabajo que ha estado inactivo durante un minuto puede superar brevemente su límite de estado estable. No dependas de esto para tráfico de producción: diseña para la tasa de estado estable.

Pedir más

¿Necesitas un límite más alto? Envía un correo a support@unifapi.com con el ID de tu espacio de trabajo, la Skill u operación que estás ejecutando y una estimación aproximada de QPS.