Conceito da API de Lotes
Nesta página
Atualizado em 2 de novembro de 2026, com base na documentação da xAI: o desconto para lotes é de 20% nos modelos de texto elegíveis (não 50%), os exemplos seguem a API REST e o
xai-sdkoficial (client.batch.*; a API de Lotes da xAI não utiliza o formato da OpenAI, pelo que o SDK da OpenAI não se aplica), e a API de Respostas precede as Conclusões de Chat, um endpoint legado na xAI. Fontes: API de Lotes · Referência REST · Preços de Lotes.
Processamento assíncrono em massa
A API de Lotes da xAI permite enviar milhares de pedidos numa única operação, recuperando depois os resultados assim que o processamento terminar. Ao contrário das chamadas síncronas, onde aguarda por cada resposta, o modo de lote funciona de forma assíncrona: submete um lote, continua o seu trabalho e regressa mais tarde para obter os resultados.
Esta abordagem responde a uma necessidade real. Quando precisa de resumir 10.000 artigos, classificar 50.000 tickets de suporte ou escrever descrições de catálogo, enviar pedidos um a um seria lento, dispendioso e faria com que atingisse os limites de taxa (rate limits). Os pedidos em lote não contam para esses limites.
Um desconto de 20% em modelos elegíveis
A vantagem económica é real, mas mais modesta do que algumas fontes sugerem. A xAI aplica um desconto de 20% aos pedidos em lote para os seus modelos de texto elegíveis — a partir de 2 de novembro de 2026: grok-4.7, grok-4.6, grok-4.5, grok-4.3 e as três variantes grok-4.20-0309 — em todos os tipos de tokens: entrada, saída, cache e raciocínio. Os modelos que não constam desta lista não beneficiam de qualquer desconto, mesmo que aceitem processamento em lote.
A geração de imagens e vídeo funciona em lote, mas com a tarifação padrão. Nem todos os modelos aceitam lotes: a página de cada modelo indica se o suporta, e um pedido enviado a um modelo inelegível será rejeitado com a mensagem not supported for batch processing.
Fluxo de trabalho em quatro etapas
A API de Lotes segue um padrão simples e previsível:
- Criar um lote nomeado com
POST /v1/batches - Adicionar pedidos, seja através de chamadas sucessivas ou de uma só vez com um ficheiro JSONL
- Monitorizar o progresso utilizando os contadores do lote
- Recuperar os resultados à medida que ficam disponíveis ou no final
Este fluxo de trabalho desacopla a submissão do processamento: não precisa de manter uma ligação aberta enquanto o Grok trabalha. A maioria dos lotes é processada em menos de 24 horas, mas a xAI não o garante: o tempo de resposta varia consoante a carga e a dimensão do lote.
Endpoints suportados
A API de Lotes não se limita ao texto. Um único lote pode misturar pedidos para:
/v1/responses— a API de Respostas, com ferramentas do lado do servidor (pesquisa na web, pesquisa no X, execução de código, MCP)/v1/chat/completions— a API de Conclusões de Chat, um endpoint legado na xAI/v1/images/generationse/v1/images/edits— geração e edição de imagens/v1/videos/generations(ou/v1/videos),/v1/videos/editse/v1/videos/extensions— geração, edição e extensão de vídeos
Por exemplo, pode escrever descrições de produtos e gerar as suas imagens visuais no mesmo lote.
Quando utilizar a API de Lotes
A API de Lotes é adequada sempre que o resultado possa aguardar:
- Processamento massivo de dados: classificação, extração e resumo de milhares de documentos
- Avaliações: executar milhares de prompts de teste num modelo
- Pipelines de dados: enriquecimento de bases de dados, moderação de um backlog de conteúdos e relatórios preparados durante a noite
Se o seu caso de utilização exigir uma resposta imediata (chatbot, assistente em tempo real), a API de Lotes não é adequada: serve cargas de trabalho onde um atraso de algumas horas é aceitável.
Pontos-chave
- A API de Lotes processa pedidos de forma assíncrona, a maioria em menos de 24 horas, sem garantia
- Desconto de 20% em todos os tokens para modelos de texto elegíveis; imagens e vídeos com tarifação padrão
- O fluxo de trabalho tem quatro etapas: criar, adicionar, monitorizar, recuperar
- Texto, imagens e vídeos podem coexistir no mesmo lote
- Os pedidos em lote não contam para os limites de taxa, mas não são adequados para tempo real