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

Endpoints suportados em lotes

Aula 3 de 12 Atualizada a 2 de novembro de 2026 Programador
Nesta página
  1. Sete endpoints, um fluxo de trabalho
  2. Endpoints de texto
  3. Endpoints de imagem
  4. Endpoints de vídeo
  5. Misturar endpoints num lote
  6. Escolher o endpoint correto
  7. Pontos-chave

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-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 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 url de 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