Edição de Múltiplas Imagens e Referências
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 pedidos são agora processados pelo Imagine 2.0 na qualidadelow): os exemplos utilizam agoragrok-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 através deextra_body, e a edição é gerida via SDK da xAI ou através de um pedido HTTP.
Trabalhar com Múltiplas Imagens de Origem
Uma das principais vantagens do endpoint de edição é a capacidade de fornecer até 5 imagens de referência num único pedido. Isto abre possibilidades criativas avançadas: combinar elementos de várias fontes, fundir estilos ou criar composições complexas.
O Parâmetro images (Plural)
Mudar de image para images altera mais do que a estrutura do parâmetro: muda o que pede ao modelo para fazer. Com uma única fonte, o modelo modifica uma imagem; com múltiplas, tem de arbitrar entre elas — decidindo o que retirar de cada uma. Ele fará essa arbitragem de qualquer forma; a única questão é saber se você dirige esse processo, que é o foco da próxima secção.
Note que os dois parâmetros são mutuamente exclusivos: image (objeto único) e images (array) não podem ser combinados.
import requests
import os
headers = {
"Authorization": f"Bearer {os.getenv('XAI_API_KEY')}",
"Content-Type": "application/json"
}
payload = {
"model": "grok-imagine-image",
"prompt": "Combine the character from the first image with "
"the landscape from the second image",
"images": [
{"url": "https://exemple.com/personnage.jpg"},
{"url": "https://exemple.com/paysage.jpg"}
]
}
response = requests.post(
"https://api.x.ai/v1/images/edits",
headers=headers,
json=payload
).json()
Referenciar Imagens no Prompt
Quando fornece múltiplas imagens, pode referenciá-las individualmente no seu prompt usando a sintaxe <IMAGE_0>, <IMAGE_1>, etc. O índice começa em 0.
payload = {
"model": "grok-imagine-image",
"prompt": "Place the product from <IMAGE_0> on the table from <IMAGE_1>, "
"with the ambient lighting from <IMAGE_2>",
"images": [
{"url": "https://exemple.com/produit.jpg"}, # <IMAGE_0>
{"url": "https://exemple.com/table.jpg"}, # <IMAGE_1>
{"url": "https://exemple.com/ambiance.jpg"} # <IMAGE_2>
]
}
Esta sintaxe é o que distingue uma composição controlada de uma fusão aproximada. Dizer “Combine estas imagens” deixa tudo ao critério do modelo; dizer “coloque o produto de <IMAGE_0> no cenário de <IMAGE_1> mantendo a iluminação de <IMAGE_1>” não deixa margem para interpretação. Assim que fornecer mais do que uma fonte, referencie-as explicitamente.
Casos de Uso com Múltiplas Imagens
Transferência de Estilo
Aplique o estilo de uma imagem de referência a outra:
payload = {
"model": "grok-imagine-image-2.0",
"prompt": "Reproduce the content of <IMAGE_0> in the artistic style of <IMAGE_1>",
"images": [
{"url": "https://exemple.com/photo-originale.jpg"},
{"url": "https://exemple.com/reference-style.jpg"}
]
}
Composição de Produto
Integre um produto num cenário com iluminação de referência:
payload = {
"model": "grok-imagine-image-2.0",
"prompt": "Photograph the product from <IMAGE_0> placed on the furniture from <IMAGE_1> "
"in the room from <IMAGE_2>, consistent natural lighting",
"images": [
{"url": "https://exemple.com/produit-detouré.png"},
{"url": "https://exemple.com/meuble.jpg"},
{"url": "https://exemple.com/piece.jpg"}
]
}
Fusão de Rosto e Fundo
Combine um retrato com um fundo específico:
payload = {
"model": "grok-imagine-image",
"prompt": "Place the person from <IMAGE_0> in front of the building from <IMAGE_1>, "
"keeping natural lighting and perspective",
"images": [
{"url": "https://exemple.com/portrait.jpg"},
{"url": "https://exemple.com/batiment.jpg"}
]
}
Limites e Melhores Práticas
O limite técnico é de 5 imagens por pedido, e pode misturar livremente formatos — algumas fontes como URLs, outras como Base64 — no mesmo array. A verdadeira dificuldade não está aí: reside na precisão do prompt, que deve aumentar com o número de imagens. Com duas fontes, “combinar a personagem e o cenário” muitas vezes basta; com cinco, o modelo já não consegue adivinhar qual elemento retirar de qual imagem, e é exatamente aqui que entram as referências <IMAGE_1> a <IMAGE_5>: “coloque o logótipo de <IMAGE_2> na t-shirt da personagem de <IMAGE_1>, na atmosfera luminosa de <IMAGE_3>” não deixa qualquer ambiguidade. Para composições complexas com múltiplas fontes, o modelo profissional (grok-imagine-image-quality) justifica o seu custo adicional: é precisamente aqui que a diferença face ao modelo standard é mais visível, na consistência entre elementos heterogéneos.
Prática Guiada
Tente combinar duas imagens que tenha à mão:
payload = {
"model": "grok-imagine-image",
"prompt": "Create a scene where the object from <IMAGE_0> floats in the sky from <IMAGE_1>, "
"surrealist style",
"images": [
{"url": "URL_OF_YOUR_FIRST_IMAGE"},
{"url": "URL_OF_YOUR_SECOND_IMAGE"}
],
"n": 3
}
Gere 3 variações para comparar as interpretações do modelo.
Pontos-chave
- O parâmetro
imagesaceita até 5 imagens de origem num array image(singular) eimages(plural) são mutuamente exclusivos- A sintaxe
<IMAGE_0>,<IMAGE_1>permite referenciar cada imagem no prompt - Os casos de uso incluem transferência de estilo, composição e fusão
- Seja preciso no seu prompt quando utilizar múltiplas fontes