Parâmetro de Qualidade e Otimização de Renderização
Nesta página
Lição reescrita em 2 de novembro de 2026. A versão anterior descrevia um valor
highe um parâmetroqualityque não tinham efeito no preço, para um modelo “pro” agora descontinuado. De acordo com a documentação atual da xAI,qualityé específico do Imagine 2.0, aceitalow,mediumeauto, e cada imagem é faturada conforme a qualidade em que é servida.
Controlar a Qualidade da Geração

Na aplicação Grok, o seletor Velocidade / Qualidade equilibra rapidez e refinamento. Na API, este equilíbrio envolve duas escolhas: o modelo (Imagine 1.0 ou Imagine 2.0) e, para o Imagine 2.0, o parâmetro quality.
O Parâmetro quality
O parâmetro quality é aceite pelo grok-imagine-image-2.0, tanto para geração como para edição. Existem três valores:
low: a definição mais económica para o Imagine 2.0 ($0.04 por imagem às tarifas listadas), e para onde são redirecionados os pedidos do antigo modelo “pro”;medium: mais poder de computação por imagem para detalhes mais finos; reserve para imagens onde a qualidade importa mais do que o custo;auto: o valor padrão quando o parâmetro é omitido; atualmente servelowna geração emediumna edição, sendo a imagem faturada pela qualidade servida.
Para controlar tanto a renderização como a fatura, defina a qualidade explicitamente em vez de deixar o auto decidir. Com o SDK da OpenAI apontado para a API da xAI, a passagem faz-se via extra_body:
# Rascunho rápido: Imagine 1.0, o mais barato
brouillon = client.images.generate(
model="grok-imagine-image",
prompt="E-commerce website mockup, wireframe style",
)
# Visual padrão: Imagine 2.0, baixa qualidade
courant = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Illustration of a mobile fitness app",
extra_body={"quality": "low"},
)
# Visual final: Imagine 2.0, média qualidade, resolução 2k
final = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Advertising poster for a luxury perfume, photorealistic render",
extra_body={"quality": "medium", "resolution": "2k"},
)
Combinação Modelo + Qualidade + Resolução
Três parâmetros, três efeitos: o modelo define o preço base e as funcionalidades disponíveis, quality o nível de detalhe para o Imagine 2.0 (e a sua tarifa), e resolution a definição da imagem (1k por padrão, ou 2k).
| Caso de Uso | Modelo | Qualidade | Resolução |
|---|---|---|---|
| Protótipo rápido | Imagine 1.0 | — | 1k |
| Conteúdo web | Imagine 1.0 | — | 1k |
| Redes sociais | Imagine 2.0 | low | 1k |
| Visual de marketing | Imagine 2.0 | medium | 1k |
| Impressão, cartaz | Imagine 2.0 | medium | 2k |
Fluxo de Trabalho de Otimização em 3 Passos
Encontre a ideia certa onde é barato, refine-a e só pague pela renderização mais cara na imagem selecionada.
Passo 1: Explorar
prompts_candidats = [
"A robot barista making coffee, cartoon style",
"A robotic arm pouring coffee, realistic style",
"A mechanical hand holding a steaming cup, steampunk style",
]
for prompt in prompts_candidats:
response = client.images.generate(
model="grok-imagine-image",
prompt=prompt,
n=3,
)
# Custo: 3 x $0.02 = $0.06 por prompt
Passo 2: Refinar
best_prompt = "A robotic arm pouring coffee, realistic style"
response = client.images.generate(
model="grok-imagine-image-2.0",
prompt=best_prompt,
n=4,
extra_body={"quality": "low", "resolution": "1k"},
)
# Custo: 4 x $0.04 = $0.16
Passo 3: Finalizar
response = client.images.generate(
model="grok-imagine-image-2.0",
prompt=best_prompt + ", cinematic lighting, fine mechanical details",
n=2,
extra_body={"quality": "medium", "resolution": "2k"},
)
# Custo: 2 imagens à tarifa atual "medium"
Os dois primeiros passos custam $0.34 por nove rascunhos e quatro variantes; apenas as duas imagens finais são faturadas à tarifa medium.
Automatizar a Seleção de Qualidade
Centralize esta escolha numa função para evitar que se disperse pelo código. Se as tarifas mudarem ou um modelo for adicionado, apenas um local precisa de modificação.
CONFIGS = {
"prototype": {"model": "grok-imagine-image", "extra_body": {"resolution": "1k"}},
"web": {"model": "grok-imagine-image", "extra_body": {"resolution": "1k"}},
"social": {"model": "grok-imagine-image-2.0", "extra_body": {"quality": "low", "resolution": "1k"}},
"marketing": {"model": "grok-imagine-image-2.0", "extra_body": {"quality": "medium", "resolution": "1k"}},
"print": {"model": "grok-imagine-image-2.0", "extra_body": {"quality": "medium", "resolution": "2k"}},
}
def generate_smart(prompt, usage="web"):
"""Gera uma imagem com parâmetros adequados ao caso de uso."""
config = CONFIGS.get(usage, CONFIGS["web"])
return client.images.generate(prompt=prompt, **config)
Fontes oficiais: Image Generation — Quality · grok-imagine-image-quality Retirement on November 2, 2026 · Pricing
Pontos-chave
qualityé específico do Imagine 2.0 e aceitalow,mediumeauto(valor padrão)- A imagem é faturada pela qualidade servida: defina a qualidade explicitamente para controlar a fatura
- Com o SDK da OpenAI,
qualityeresolutionpassam viaextra_body - Fluxo de trabalho em 3 passos: explorar com o Imagine 1.0, refinar em
low, finalizar emmedium - Centralize a seleção de parâmetros numa função de configuração