Limites de requisição da API do Grok: níveis, limites de RPS e erros 429 explicados

Como funcionam os limites de requisição da API do Grok

A SpaceXSI (antiga xAI) limita o tráfego da API por modelo, usando dois números:

• RPS (requisições por segundo): quantas chamadas você pode enviar a cada segundo. A SpaceXSI o calcula a partir de um valor por minuto: o RPS é igual ao RPM dividido por 48, com mínimo de 2.
• TPM (tokens por minuto): quantos tokens você pode processar a cada minuto. Tokens em cache contam para o TPM.

Os limites valem para cada modelo separadamente. Uma carga pesada no grok-4.7 não consome sua cota do grok-4.3. Quando você ultrapassa um limite, a API retorna HTTP 429 e a requisição não é processada.

Como os tokens em cache contam para o TPM, o cache reduz sua conta, mas não seu orçamento de tokens por minuto. Prompts longos podem bater no limite de TPM bem antes de você chegar ao limite de requisições.

Níveis de gasto de $0 a $5,000

Seu nível depende de quanto você gastou na API, no total, desde 1º de janeiro de 2026.

Quatro regras da documentação:

• Os níveis sobem automaticamente quando você ultrapassa um patamar.
• Os níveis nunca caem, mesmo que seus gastos diminuam.
• Só contam compras de crédito pré-pago e faturas pagas.
• Limites maiores para os modelos de imagem e vídeo do Grok Imagine passam pela equipe de vendas da SpaceXSI.

Exemplos de limites por modelo

A documentação publica uma tabela por modelo. Os números abaixo são o que lemos em 18 de outubro de 2026. A tabela estava embaralhada na página, então trate-os como aproximados e confira seu console para ver os limites da sua conta.

Os níveis 1 a 3 ficam entre esses valores. O console mostra os limites exatos que valem para a sua equipe.

A API de voz tem limites próprios. A documentação do Grok Voice lista 10 sessões simultâneas por equipe e sessões de no máximo 120 minutos. Veja nosso guia da API do Grok Voice.

O que fazer quando aparece um 429

Um 429 significa que você enviou mais do que seu nível permite para aquele modelo naquele intervalo. Não é um erro de cobrança. Um 429 é diferente de ficar sem créditos, o que faz as requisições serem recusadas até você recarregar.

As boas práticas de qualquer API com limite de requisições valem aqui:

1. Tente de novo após uma breve espera e aumente a espera a cada tentativa falha (backoff exponencial).
2. Acrescente um pequeno atraso aleatório para que processos paralelos não tentem de novo no mesmo instante.
3. Distribua tarefas em rajada ao longo do tempo com uma fila, em vez de disparar todas de uma vez.
4. Registre qual modelo e qual limite você atingiu. Problemas de RPS e de TPM pedem soluções diferentes.

Se você bater no limite de TPM, prompts mais curtos ajudam mais do que menos requisições. Se bater no limite de RPS, junte chamadas pequenas quando puder.

Como aproveitar melhor seus limites

• Use a Batch API para trabalhos que podem esperar. As chamadas em lote não contam para os limites de requisição e são 20% mais baratas no grok-4.3 e nos modelos grok-4.20.
• Defina uma chave de cache. A SpaceXSI recomenda fortemente o prompt_cache_key ou o cabeçalho x-grok-conv-id. Isso não aumenta seu TPM, mas reduz o preço da entrada repetida.
• Ajuste o esforço de raciocínio à tarefa. O Grok 4.7 usa esforço alto por padrão. A Artificial Analysis concluiu que o Grok 4.7 produziu cerca de 81 mil tokens de saída por tarefa nos testes dela, mais que o dobro do Grok 4.6, então raciocínio pesado consome o orçamento de tokens rapidamente.
• Escolha o modelo com os limites certos. Na tabela publicada, a família do grok-4.5 ao 4.7 começa com RPS mais alto que o grok-4.3.
• Compre créditos com antecedência. Como só compras pré-pagas e faturas pagas contam para os níveis, uma recarga maior faz você subir mais cedo.

Enterprise e limites maiores

Acima do nível 4, a SpaceXSI oferece um nível Enterprise sob solicitação. A cobrança por fatura também é combinada com a equipe de vendas; ela vem desativada por padrão. Equipes que precisam de mais capacidade no Grok Imagine também devem falar com vendas.

Para dados empresariais, a SpaceXSI diz que não treina com entradas ou saídas empresariais e as apaga em até 30 dias, a menos que precise mantê-las. Os preços de todos os modelos estão na nossa página de preços da API do Grok, e os passos de configuração, na visão geral da API do Grok.

Perguntas frequentes