Límites de uso de la API de Grok: niveles, topes de RPS y errores 429 explicados

Cómo funcionan los límites de uso de la API de Grok

SpaceXSI (antes xAI) limita el tráfico de la API por modelo con dos cifras:

• RPS (solicitudes por segundo): cuántas llamadas puedes enviar cada segundo. SpaceXSI lo calcula a partir de una cifra por minuto: RPS es igual a RPM dividido entre 48, con un mínimo de 2.
• TPM (tokens por minuto): cuántos tokens puedes procesar cada minuto. Los tokens en caché cuentan para el TPM.

Los límites se aplican a cada modelo por separado. Una carga intensa en grok-4.7 no consume tu asignación de grok-4.3. Cuando superas un límite, la API devuelve un HTTP 429 y la solicitud no se procesa.

Como los tokens en caché cuentan para el TPM, la caché reduce tu factura pero no tu presupuesto de tokens por minuto. Los prompts largos pueden llegar al tope de TPM mucho antes que al de solicitudes.

Niveles de gasto de $0 a $5,000

Tu nivel depende de cuánto hayas gastado en total en la API desde el 1 de enero de 2026.

Cuatro reglas de la documentación:

• Los niveles suben automáticamente al superar un umbral.
• Los niveles nunca bajan, aunque tu gasto se reduzca.
• Solo cuentan las compras de crédito prepago y las facturas pagadas.
• Los límites más altos para los modelos de imagen y vídeo de Grok Imagine se gestionan con el equipo de ventas de SpaceXSI.

Ejemplos de límites por modelo

La documentación publica una tabla por modelo. Las cifras de abajo son las que leímos el 18 de octubre de 2026. La tabla aparecía desordenada en la página, así que tómalas como aproximadas y revisa tu consola para ver los límites de tu cuenta.

Los niveles 1 a 3 quedan entre estos valores. La consola muestra los límites exactos que se aplican a tu equipo.

La API de voz tiene sus propios topes. La documentación de Grok Voice indica 10 sesiones simultáneas por equipo y una sesión máxima de 120 minutos. Consulta nuestra guía de la API de Grok Voice.

Qué hacer cuando recibes un 429

Un 429 significa que enviaste más de lo que tu nivel permite para ese modelo en ese intervalo. No es un error de facturación. Un 429 es distinto de quedarse sin crédito, que hace que las solicitudes se rechacen hasta que recargues.

Aquí se aplica la práctica habitual de cualquier API con límites de uso:

1. Reintenta tras una breve espera y aumenta la espera después de cada intento fallido (retroceso exponencial).
2. Añade un pequeño retardo aleatorio para que los procesos en paralelo no reintenten en el mismo momento.
3. Reparte en el tiempo los trabajos con picos mediante una cola, en lugar de lanzarlos todos a la vez.
4. Registra qué modelo y qué límite alcanzaste. Los problemas de RPS y de TPM requieren soluciones distintas.

Si alcanzas el tope de TPM, los prompts más cortos ayudan más que hacer menos solicitudes. Si alcanzas el tope de RPS, combina las llamadas pequeñas cuando puedas.

Cómo sacar más partido a tus límites

• Usa la Batch API para el trabajo que puede esperar. Las llamadas por lotes no cuentan para los límites de uso y son un 20% más baratas en grok-4.3 y los modelos grok-4.20.
• Configura una clave de caché. SpaceXSI recomienda encarecidamente prompt_cache_key o la cabecera x-grok-conv-id. No aumentará tu TPM, pero reduce el precio de la entrada repetida.
• Ajusta el esfuerzo de razonamiento a la tarea. Grok 4.7 usa esfuerzo alto por defecto. Artificial Analysis vio que Grok 4.7 generaba unos 81k tokens de salida por tarea en sus pruebas, más del doble que Grok 4.6, así que el razonamiento intenso consume rápido los presupuestos de tokens.
• Elige el modelo con los límites adecuados. En la tabla publicada, la familia grok-4.5 a 4.7 empieza con un RPS más alto que grok-4.3.
• Compra crédito por adelantado. Como solo cuentan para los niveles las compras prepago y las facturas pagadas, una recarga mayor te hace subir antes.

Enterprise y límites más altos

Por encima del nivel 4, SpaceXSI ofrece un nivel Enterprise bajo petición. La facturación con factura también se gestiona con el equipo de ventas; está desactivada por defecto. Los equipos que necesiten más capacidad de Grok Imagine también deben contactar con ventas.

En cuanto a los datos de empresas, SpaceXSI dice que no entrena con las entradas ni las salidas empresariales y que las borra en un plazo de 30 días salvo que deba conservarlas. Los precios de todos los modelos están en nuestra página de precios de la API de Grok, y los pasos de configuración en el resumen de la API de Grok.

Preguntas frecuentes