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

Parâmetro de Qualidade e Otimização de Renderização

Aula 12 de 14 Atualizada a 2 de novembro de 2026 Iniciante
Nesta página
  1. Controlar a Qualidade da Geração
  2. O Parâmetro quality
  3. Combinação Modelo + Qualidade + Resolução
  4. Fluxo de Trabalho de Otimização em 3 Passos
  5. Automatizar a Seleção de Qualidade
  6. Pontos-chave

Lição reescrita em 2 de novembro de 2026. A versão anterior descrevia um valor high e um parâmetro quality que 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, aceita low, medium e auto, e cada imagem é faturada conforme a qualidade em que é servida.

Controlar a Qualidade da Geração

O seletor Velocidade / Qualidade na aplicação Grok Imagine

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 serve low na geração e medium na 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 UsoModeloQualidadeResolução
Protótipo rápidoImagine 1.0—1k
Conteúdo webImagine 1.0—1k
Redes sociaisImagine 2.0low1k
Visual de marketingImagine 2.0medium1k
Impressão, cartazImagine 2.0medium2k

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 aceita low, medium e auto (valor padrão)
  • A imagem é faturada pela qualidade servida: defina a qualidade explicitamente para controlar a fatura
  • Com o SDK da OpenAI, quality e resolution passam via extra_body
  • Fluxo de trabalho em 3 passos: explorar com o Imagine 1.0, refinar em low, finalizar em medium
  • Centralize a seleção de parâmetros numa função de configuração