Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Conceito da API de Lotes

Aula 1 de 12 Atualizada a 2 de novembro de 2026 Programador
Nesta página
  1. Processamento assíncrono em massa
  2. Um desconto de 20% em modelos elegíveis
  3. Fluxo de trabalho em quatro etapas
  4. Endpoints suportados
  5. Quando utilizar a API de Lotes
  6. Pontos-chave

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-sdk oficial (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.

-20%
Tokens para modelos elegíveis
24h
Tempo de resposta típico, não garantido
50K
Pedidos por ficheiro
200 MB
Tamanho máximo JSONL

Fluxo de trabalho em quatro etapas

A API de Lotes segue um padrão simples e previsível:

  1. Criar um lote nomeado com POST /v1/batches
  2. Adicionar pedidos, seja através de chamadas sucessivas ou de uma só vez com um ficheiro JSONL
  3. Monitorizar o progresso utilizando os contadores do lote
  4. 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/generations e /v1/images/edits — geração e edição de imagens
  • /v1/videos/generations (ou /v1/videos), /v1/videos/edits e /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