Límites y acceso

En la consola, Configuración → Límites y acceso (Settings → Limits & access) reúne los presupuestos y las reglas de acceso de todo el equipo, para evitar gastos inesperados y abusos si se filtra una API key.

Regla	Qué hace	Dónde se configura
Límite de gasto	Detiene las llamadas al alcanzar el límite	Equipo y miembros: Límites y acceso; key: API Keys
Lista blanca de IP	Permite llamar solo desde los servidores indicados	Equipo: Límites y acceso; key: menú de la key → IP Whitelist
Modelos permitidos	Limita a qué modelos se puede llamar	Equipo: Límites y acceso; key: menú de la key → Allowed models
Tasa de solicitudes	Solicitudes por minuto compartidas por todas las keys del equipo	Solo lectura; consulta Límites de tasa

Solo los propietarios y administradores del equipo pueden cambiar estas reglas. Cada cambio queda registrado en Historial de cambios (Change history), arriba a la derecha de la página.

Límite de gasto

Hay presupuestos en tres niveles —equipo, miembro y API key— y el periodo puede ser Diario (Daily), Mensual (Monthly) o Total.

Presupuesto del equipo: el gasto máximo de todo el equipo
Presupuesto predeterminado de los miembros (Default member budget): se calcula por separado para cada miembro; si un miembro tiene su propio presupuesto, se aplica ese
Presupuesto de la key: se define para cada key en la página API Keys

Los tres niveles se calculan por separado: en cuanto se agota cualquiera de ellos, la solicitud se bloquea. Dentro de un mismo periodo, el presupuesto de una key no puede superar el de su miembro, y el de un miembro no puede superar el del equipo.

Cada presupuesto tiene un modo de actuación:

Modo	Al alcanzar el límite
Notificar y bloquear (Notify and block)	Envía un correo de aviso y detiene las llamadas
Solo notificar (Notify only)	Solo envía un correo de aviso, sin bloquear

Recargar saldo no reanuda las llamadas cuando se agota un presupuesto. Hay que subir el límite o esperar a que se reinicie el periodo diario / mensual.

Lista blanca de IP

Permite llamar solo desde direcciones IPv4 o rangos CIDR concretos, hasta 100 entradas. Las solicitudes desde direcciones fuera de la lista se rechazan.

Lista blanca de IP del equipo: se aplica a todas las API keys del equipo
Lista blanca de IP de la key: restringe aún más la lista del equipo para una key concreta; una dirección de la lista de la key solo se aplica si también está en la lista del equipo

Es útil para fijar las keys de producción a tus propios servidores: aunque la key se filtre, nadie podrá usarla desde otro sitio.

Modelos permitidos

El equipo puede elegir entre tres modos, y seleccionar modelos por proveedor en bloque:

Modo	Descripción
Todos los modelos (All models)	Se puede llamar a todos los modelos, incluidos los que se publiquen más adelante
Solo estos modelos (Only these models)	Solo se puede llamar a los modelos de la lista; los modelos nuevos que se publiquen más adelante tampoco
Bloquear estos modelos (Block these models)	No se puede llamar a los modelos de la lista; el resto no se ve afectado

Cada key también puede restringirse más desde Modelos permitidos (Allowed models) en su menú. Las reglas del equipo y de la key se aplican a la vez: solo se puede llamar a un modelo que ambas permitan.

Comprobar reglas efectivas

Cada key está sujeta a dos niveles de reglas: las del equipo y las de la key. En API Keys, abre el menú de la key, haz clic en Comprobar reglas efectivas (Check effective rules) y elige un modelo: verás si la llamada se bloquearía, qué regla la bloquearía y cuánto presupuesto queda. La comprobación no consume créditos.

Respuesta cuando se bloquea una solicitud

Una solicitud detenida por un presupuesto o una regla de acceso no tendrá éxito al reintentar; primero hay que ajustar las reglas:

Código de estado	Código de error	Causa	Qué hacer
`402`	`spending_limit_exceeded`	Se superó el límite de gasto del equipo, del miembro o de la key	Sube el límite o espera a que se reinicie el periodo
`402`	`insufficient_credits`	Saldo insuficiente	Recarga saldo
`403`	`ip_not_allowed`	La IP de origen no está en la lista blanca	Añade esa IP a la lista blanca del equipo o de la key
`403`	`model_not_allowed`	El equipo o la key no permite este modelo	Usa otro modelo o ajusta los modelos permitidos
`503`	`spending_limit_check_unavailable`	No se puede comprobar el presupuesto por ahora	Reintenta más tarde

Las solicitudes bloqueadas aparecen en Actividad (Activity) con el filtro Bloqueadas (Blocked). La lista completa de códigos de error está en Manejo de errores.

Historial de cambios

En la lista blanca de IP, los modelos permitidos y los presupuestos, puedes ver quién cambió qué y cuándo en Historial de cambios (Change history), arriba a la derecha de Límites y acceso. Los ajustes de retención de registros no se registran aquí; consulta Registros de solicitudes.