Endpoints suportados em lotes
Nesta página
Atualizado em 2 de novembro de 2026, com base na documentação da xAI: o desconto para lotes é de 20% em 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 tem precedência sobre as Conclusões de Chat, um endpoint legado na xAI. Fontes: Batch API · REST reference · Batch pricing.
Sete endpoints, um fluxo de trabalho
A API de Lotes não se limita à geração de texto. Aceita sete endpoints que cobrem texto, imagens e vídeo, permitindo-lhe combiná-los num único lote para construir pipelines multimodais completos numa única operação.
Endpoints de texto
/v1/responses — A API de Respostas, a que a xAI recomenda. Oferece acesso a ferramentas do lado do servidor (pesquisa na web, pesquisa no X, execução de código, MCP), chamadas de funções e saídas estruturadas, sendo a primeira a receber novas funcionalidades.
/v1/chat/completions — O endpoint de conclusão original, no formato da OpenAI. A xAI mantém-no como um endpoint legado: continua a ser útil para código existente escrito para o mesmo, mas um novo pipeline beneficia de começar com a API de Respostas.
Em modelos elegíveis, o desconto de lote de 20% aplica-se a ambos os endpoints, em todos os tipos de tokens.
Endpoints de imagem
/v1/images/generations — Gera imagens a partir de um prompt. Os parâmetros que utilizará são aspect_ratio (por exemplo, "16:9"), resolution ("1k", "1.5k" ou "2k"), n para o número de imagens e response_format ("url" ou "b64_json").
/v1/images/edits — Edita uma imagem existente, especificada por um objeto image que contém um url (um endereço público ou dados codificados em base64) ou o file_id de um ficheiro carregado. Útil para executar transformações em série num catálogo visual.
As imagens são faturadas à tarifa padrão, sem desconto de lote: aqui, o valor do processamento em lote é operacional, não financeiro.
Endpoints de vídeo
/v1/videos/generations (ou /v1/videos) — Gera vídeos a partir de um prompt, com duração de 1 a 15 segundos (duration, 8 por predefinição), em 480p, 720p ou 1080p.
/v1/videos/edits — Edita um vídeo existente, passado num objeto video (o URL de um ficheiro .mp4 ou um file_id).
/v1/videos/extensions — Estende um vídeo com um novo segmento de 2 a 10 segundos.
Tal como nas imagens, a precificação de vídeo mantém-se na tarifa padrão no modo de lote. Os resultados de imagem e vídeo são devolvidos como URLs assinados que expiram após uma hora.
Misturar endpoints num lote
Num ficheiro JSONL, cada linha indica o seu endpoint no campo url:
{"custom_id": "text-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Summarize this article: ..."}]}}
{"custom_id": "img-1", "method": "POST", "url": "/v1/images/generations", "body": {"model": "grok-imagine-image-2.0", "prompt": "Minimalist logo for a neighborhood bookstore"}}
Desta forma, pode gerar as descrições dos seus produtos e os respetivos visuais no mesmo lote.
Escolher o endpoint correto
- Respostas: a escolha predefinida, essencial assim que necessitar de ferramentas do lado do servidor, saídas estruturadas ou das funcionalidades mais recentes.
- Conclusões de Chat: continuidade para código já escrito no formato de Conclusões de Chat, e nada mais.
- Imagens e vídeo: para produzir visuais em série, tendo em mente que não beneficiam de desconto.
Pontos-chave
- São aceites sete endpoints: dois para texto, dois para imagens e três para vídeo
- Respostas é o endpoint recomendado; Conclusões de Chat é um endpoint legado na xAI
- Apenas os tokens em modelos de texto elegíveis beneficiam do desconto de 20%
- O campo
urlde cada linha JSONL determina o endpoint de destino, podendo os endpoints ser misturados num lote - Os resultados de imagem e vídeo são URLs assinados válidos por uma hora