Proporções, Resoluções e Formatos de Saída
Nesta página
Atualizado em 2 de novembro de 2026 — Imagine. O modelo
grok-imagine-image-qualityfoi removido a partir de 2 de novembro de 2026 (os seus pedidos são agora processados pelo Imagine 2.0 na qualidadelow): os exemplos atuais utilizamgrok-imagine-image(Imagine 1.0) egrok-imagine-image-2.0(Imagine 2.0, com qualidadelow,mediumouauto). Com o SDK da OpenAI, os parâmetrosaspect_ratio,resolutionequalitysão transmitidos viaextra_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ção1k, Imagine 1.0 - Story/Reel:
9:16, resolução1k, Imagine 1.0 - Banner Web:
16:9ou2:1, resolução1k, Imagine 1.0 - Póster de Evento:
3:4, resolução2k, Imagine 2.0 com qualidademedium - Ilustração de Artigo:
16:9, resolução2k, Imagine 2.0 com qualidademedium
Pontos-chave
- Mais de 10 proporções disponíveis, além do modo
auto - Duas resoluções:
1k(rápida, web) e2k(detalhada, impressão) - Dois formatos de resposta:
url(temporária) eb64_json(persistente) - Os tipos MIME devolvidos podem ser PNG, JPEG ou WebP
- Adapte a proporção ao canal de distribuição da sua imagem