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

Proporções, Resoluções e Formatos de Saída

Aula 3 de 14 Atualizada a 2 de novembro de 2026 Iniciante
Nesta página
  1. Domine as Dimensões das Suas Imagens
  2. Proporções Disponíveis
  3. Resoluções: 1k vs 2k
  4. Formatos de Resposta
  5. Escolher a Combinação Certa
  6. Pontos-chave

Atualizado em 2 de novembro de 2026 — Imagine. O modelo grok-imagine-image-quality foi removido a partir de 2 de novembro de 2026 (os seus pedidos são agora processados pelo Imagine 2.0 na qualidade low): os exemplos atuais utilizam grok-imagine-image (Imagine 1.0) e grok-imagine-image-2.0 (Imagine 2.0, com qualidade low, medium ou auto). Com o SDK da OpenAI, os parâmetros aspect_ratio, resolution e quality são transmitidos via extra_body, enquanto a edição é realizada através do SDK da xAI ou de um pedido HTTP.

Domine as Dimensões das Suas Imagens

A proporção e a resolução que escolher determina diretamente a aparência e a utilidade das suas imagens geradas. A API Grok Imagine oferece uma flexibilidade significativa, com numerosas proporções predefinidas e dois níveis de resolução.

Proporções Disponíveis

Escolha a proporção com base no destino da imagem e faça essa escolha antes da geração. Recortar uma imagem quadrada para criar um banner panorâmico depois de gerada compromete a composição que o modelo construiu para o formato quadrado: o assunto fica descentrado e as margens desaparecem. Gerar diretamente no formato correto tem o mesmo custo e fornece uma imagem desenhada especificamente para essas proporções.

Proporção Orientação Utilização Típica
1:1 Quadrada Perfis, ícones, Instagram
16:9 Paisagem ampla Apresentações, banners, vídeo
9:16 Retrato vertical Stories, Reels, TikTok
4:3 Paisagem clássica Fotografias tradicionais, documentos
3:4 Retrato Pósteres, capas de livros
3:2 / 2:3 Fotografia padrão Impressões fotográficas, postais
2:1 / 1:2 Ultra ampla / ultra vertical Banners web, panoramas
auto Automática O modelo escolhe a proporção ideal

Estão também disponíveis proporções adicionais para casos específicos, como ecrãs de smartphones: 9:19.5, 19.5:9, 9:20 e 20:9.

Resoluções: 1k vs 2k

Entre 1k e 2k, a questão não é «qual é a melhor», mas «onde será visualizada esta imagem». Num ecrã, a diferença é invisível para a vasta maioria dos usos na web, e a opção 2k apenas acrescenta tempo extra de geração. No entanto, torna-se crítica para impressão, onde o número de píxeis por centímetro determina diretamente a nitidez percecionada.

  • 1k: Resolução padrão, adequada para a maioria dos usos na web. Tempo de geração mais rápido.
  • 2k: Alta resolução, ideal para impressão ou visuais que exijam muitos detalhes.
# Resolução padrão para web
response_web = client.images.generate(
    model="grok-imagine-image",
    prompt="Ícone de aplicação móvel estilo néon",
    extra_body={"resolution": "1k", "aspect_ratio": "1:1"},
)

# Alta resolução para impressão
response_print = client.images.generate(
    model="grok-imagine-image-2.0",
    prompt="Póster de concerto art déco com tipografia elegante",
    extra_body={"resolution": "2k", "aspect_ratio": "3:4"},
)

Formatos de Resposta

O parâmetro response_format determina como a imagem lhe é devolvida:

URL Temporária (Padrão)

response = client.images.generate(
    model="grok-imagine-image",
    prompt="Gato astronauta",
    response_format="url"
)
# response.data[0].url → URL temporária, descarregue rapidamente

JSON Base64

import base64

response = client.images.generate(
    model="grok-imagine-image",
    prompt="Gato astronauta",
    response_format="b64_json"
)

image_bytes = base64.b64decode(response.data[0].b64_json)
with open("astronaut_cat.png", "wb") as f:
    f.write(image_bytes)

A palavra importante é temporária: o URL devolvido expira. Uma aplicação que o armazene numa base de dados e o exiba semanas mais tarde encontrará imagens quebradas, muitas vezes muito depois da implementação. Existem duas opções viáveis: descarregar a imagem a partir do URL imediatamente ou solicitar diretamente em Base64; em qualquer dos casos, a imagem deve acabar no seu próprio armazenamento.

Escolher a Combinação Certa

Para cada caso de utilização, eis as combinações recomendadas:

  • Publicação no Instagram: 1:1, resolução 1k, Imagine 1.0
  • Story/Reel: 9:16, resolução 1k, Imagine 1.0
  • Banner Web: 16:9 ou 2:1, resolução 1k, Imagine 1.0
  • Póster de Evento: 3:4, resolução 2k, Imagine 2.0 com qualidade medium
  • Ilustração de Artigo: 16:9, resolução 2k, Imagine 2.0 com qualidade medium

Pontos-chave

  • Mais de 10 proporções disponíveis, além do modo auto
  • Duas resoluções: 1k (rápida, web) e 2k (detalhada, impressão)
  • Dois formatos de resposta: url (temporária) e b64_json (persistente)
  • Os tipos MIME devolvidos podem ser PNG, JPEG ou WebP
  • Adapte a proporção ao canal de distribuição da sua imagem