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

Edição de Múltiplas Imagens e Referências

Aula 7 de 14 Atualizada a 2 de novembro de 2026 Iniciante
Nesta página
  1. Trabalhar com Múltiplas Imagens de Origem
  2. O Parâmetro images (Plural)
  3. Referenciar Imagens no Prompt
  4. Casos de Uso com Múltiplas Imagens
  5. Limites e Melhores Práticas
  6. Prática Guiada
  7. 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 pedidos são agora processados pelo Imagine 2.0 na qualidade low): os exemplos utilizam agora 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 através de extra_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 images aceita até 5 imagens de origem num array
  • image (singular) e images (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