Plataforma

Límites y reglas de las claves

Limita cada clave de API a su propósito: cuánto gasta, a qué velocidad, qué modelos, desde dónde y durante cuánto tiempo. Configúralo al crear la clave, o en cualquier momento en Claves de API → Editar.

Las reglas

ReglaQué pasa al superarlaError
Presupuesto mensual (USD)Las solicitudes se rechazan hasta el mes siguiente (UTC)402 key_budget_exceeded
Presupuesto diario (USD)Se rechazan hasta la medianoche UTC402 key_daily_budget_exceeded
Límite de velocidad (solicitudes por minuto)Se rechaza por un momento, con retry-after429 rate_limit_exceeded
CaducidadLa clave deja de funcionar401 expired_api_key
Modelos permitidosLos demás modelos se rechazan403 model_not_allowed
Direcciones IP permitidasLas solicitudes desde otras direcciones se rechazan403 ip_not_allowed

Las solicitudes rechazadas nunca se cobran. Los presupuestos cuentan lo que han reservado las solicitudes en curso de la clave (consulta Facturación), así que una solicitud que podría llevar la clave más allá del límite se rechaza antes de empezar, y una respuesta que lo alcanza a mitad de camino se detiene ahí con el error del presupuesto. Los cambios se aplican en 15 segundos, en todas partes. El saldo de tu espacio de trabajo se aplica a todas las claves: cuando no alcanza para una solicitud, esta recibe 402 insufficient_quota.

Modelos permitidos

Elige los modelos que quieras, de texto, imagen o video. Una clave limitada, por ejemplo, a gpt-6-sol y gemini-3.7-flash no puede llamar a nada más, y el enrutamiento inteligente solo usa alternativas de esa lista. Permitir Zurelay Auto deja que la clave use el modelo que elija Auto.

Direcciones IP permitidas

Direcciones individuales y rangos CIDR, IPv4 e IPv6, hasta 100 por clave. La dirección que se comprueba es la de la que llega tu solicitud en internet (detrás de un proxy o NAT, la del proxy).

Ejemplos
203.0.113.7 one address
198.51.100.0/24 a range of 256 addresses
2001:db8::/32 an IPv6 range
Las plataformas serverless y algunas nubes envían solicitudes desde direcciones cambiantes. Usa un rango que tu proveedor publique para la salida, o deja las IP abiertas en esas claves y apóyate en las demás reglas.

Los presupuestos en la práctica

  • Dale a cada app o entorno su propia clave y su propio presupuesto, para que un bucle descontrolado no agote el saldo.
  • Un presupuesto diario detecta un fallo ese mismo día; uno mensual limita la factura.
  • La página de claves de API muestra el gasto de cada clave hoy y este mes junto a sus presupuestos.

¿Tienes dudas o falta algo? Escribe a nuestro equipo de soporte y te responderemos por email, normalmente en menos de un minuto.