grok-imagine-image: Geração de Imagens
Nesta página
Atualizado a 2 de novembro de 2026 — Imagine. O modelo
grok-imagine-image-qualityfoi 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 qualidadelow. Substitua o identificador nos seus exemplos e defina a qualidade desejada; ogrok-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 qualidadeauto, 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
| Funcionalidade | Imagine 1.0 | Imagine 2.0 |
|---|---|---|
| ID do Modelo | grok-imagine-image | grok-imagine-image-2.0 |
| Custo por imagem | $0.02 | $0.04 em low; medium à tarifa da grelha |
| Throughput (especificações oficiais) | 6 pedidos por segundo | 6 pedidos por segundo |
| Definição de qualidade | Não | low, medium, auto |
| Casos de uso | Volume, prototipagem | Publicaçã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