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

grok-imagine-image: Geração de Imagens

Aula 5 de 14 Atualizada a 2 de novembro de 2026 Iniciante
Nesta página
  1. Geração de Imagens pela xAI
  2. Dois Modelos
  3. Comparação dos Dois Modelos
  4. O Endpoint da API
  5. API Batch para Imagens
  6. Melhores Práticas para Prompts de Imagem
  7. Pontos-chave

Atualizado a 2 de novembro de 2026 — Imagine. O modelo grok-imagine-image-quality foi descontinuado a 2 de novembro de 2026: os seus pedidos são agora processados pelo Imagine Image 2.0 (grok-imagine-image-2.0, $0.04 por imagem) na qualidade low. Substitua o identificador nos seus exemplos e defina a qualidade desejada; o grok-imagine-image (versão 1.0) não é afetado. O Imagine Image 2.0 aceita até cinco imagens de referência e a definição de qualidade auto, que é agora o valor predefinido.

Geração de Imagens pela xAI

Desde março de 2025, a xAI disponibiliza os seus próprios modelos de geração de imagens sob a marca Grok Imagine. A partir de 2 de novembro de 2026, a gama inclui dois modelos: o Imagine 1.0, económico e concebido para volume, e o Imagine 2.0, mais dispendioso, com definições de qualidade. O modelo “Pro” de versões anteriores deste curso, grok-imagine-image-quality, foi descontinuado a 2 de novembro de 2026: os seus pedidos são agora processados pelo Imagine 2.0 na qualidade low.

Se precisar de gerar elementos visuais para as suas aplicações — ilustrações, maquetes, conteúdos de marketing ou ativos criativos —, os modelos Grok Imagine integram-se diretamente na API da xAI com faturação por imagem.

Dois Modelos

grok-imagine-image (Imagine 1.0)

O modelo concebido para volume. A $0.02 por imagem, permite-lhe produzir elementos visuais em escala sem comprometer o orçamento; a sua documentação oficial indica 6 pedidos por segundo. Utilize-o para protótipos, variantes criativas e conteúdos automatizados.

grok-imagine-image-2.0 (Imagine 2.0)

O modelo para visuais finais, a $0.04 por imagem na qualidade low. Aceita um parâmetro quality (low, medium para detalhes mais finos, ou auto, o valor predefinido), sendo cada imagem faturada conforme a qualidade fornecida. Aceita também até cinco imagens de origem para edição e as proporções 21:9 e 5:2; a sua documentação oficial indica 6 pedidos por segundo.

Comparação dos Dois Modelos

FuncionalidadeImagine 1.0Imagine 2.0
ID do Modelogrok-imagine-imagegrok-imagine-image-2.0
Custo por imagem$0.02$0.04 em low; medium à tarifa da grelha
Throughput (especificações oficiais)6 pedidos por segundo6 pedidos por segundo
Definição de qualidadeNãolow, medium, auto
Casos de usoVolume, prototipagemPublicação, marketing, edição

O Endpoint da API

A geração de imagens utiliza o endpoint /v1/images/generations. Eis a estrutura de uma chamada típica:

response = client.images.generate(
    model="grok-imagine-image",
    prompt="A mountainous landscape at sunset, oil painting style",
    n=1,
    extra_body={"aspect_ratio": "1:1"},
)
image_url = response.data[0].url

Pode especificar diferentes resoluções e proporções consoante as suas necessidades: quadrado (1024x1024), paisagem (1536x1024), retrato (1024x1536) e outras combinações.

API Batch para Imagens

Desde março de 2026, a API Batch suporta a geração de imagens. Isto permite-lhe submeter lotes de prompts e recuperar os resultados de forma assíncrona. As imagens via API Batch são faturadas à tarifa padrão — ao contrário dos tokens de texto, não beneficiam do desconto de 50%.

O Batch é particularmente útil para gerar bibliotecas de imagens: variantes de um único conceito, séries temáticas ou coleções de ilustrações para um sítio web.

Melhores Práticas para Prompts de Imagem

A qualidade das imagens geradas depende fortemente da qualidade do prompt. Algumas dicas:

  • Seja específico quanto ao estilo artístico: «aguarela», «fotografia macro», «ilustração vetorial»
  • Descreva a composição: primeiro plano, fundo, ângulo de visão, iluminação
  • Especifique as cores dominantes se tiver restrições de diretrizes de marca
  • Indique o nível de detalhe esperado: minimalista, detalhado, hiper-realista

Preços a partir de 5 de agosto de 2026 — os preços alteram-se regularmente: antes de qualquer cálculo orçamental, consulte a grelha atualizada na página oficial de modelos e preços da xAI.

Pontos-chave

  • Dois modelos: Imagine 1.0 a $0.02/imagem (volume) e Imagine 2.0 a $0.04/imagem (qualidade)
  • Ambos os modelos suportam 6 pedidos por segundo
  • O endpoint é /v1/images/generations
  • A API Batch está disponível desde março de 2026 para processamento em lote
  • As imagens em lote não beneficiam do desconto de 50%
  • A qualidade do prompt é crítica para obter bons resultados