Guia de uso
Receitas de prompts de imagem para imagem do Grok Imagine: 5 exemplos de edição prontos para copiar e colar com saídas reais
Cinco prompts de edição testados para o tier básico de $0.03 do grok-imagine/image-to-image — troca de cor de produto, substituição de cenário noturno, repintura em aquarela, composição com duas referências e conversão em adesivo recortado — cada um com a entrada exata, o prompt e a saída bruta da primeira execução.
TL;DR
- O que é isto: cinco prompts de edição prontos para copiar e colar para grok-imagine/image-to-image — o tier básico de $0.03 do editor de imagens da xAI no hiapi — cada um com a imagem de entrada exata, o prompt e a saída bruta da primeira execução vinda da API ao vivo. Sem retentativas ocultas, toda a mídia hospedada permanentemente aqui.
- Para que este modelo serve: edição barata, rápida e guiada por instruções. Você envia de 1 a 3 imagens de referência e uma instrução simples em inglês, e ele re-renderiza a cena — recolorindo um produto, movendo-o para um novo ambiente, repintando o estilo de uma foto ou compondo duas referências — preservando o que você pedir para preservar.
- Fatos do schema (verificados em 2026-07-13 contra a API de tarefas ao vivo):
prompteimage_urlssão obrigatórios;image_urlsaceita de 1 a 3 URLs publicamente acessíveis; o opcionalresolutioné1kou2kem minúsculas; o opcionalaspect_ratioaceitaautoe 13 proporções fixas de2:1a9:20. Semstrength, semseed, semn— campos desconhecidos são rejeitados com 400, então o prompt é o único controle. - Preço (da página de preços): $0.03 por imagem gerada, mais $0.003 por imagem de referência — bem menos da metade do preço do tier de qualidade. Pelas tarifas atuais, uma edição de referência única abaixo custa $0.033, e nas nossas execuções cada edição retornou em bem menos de um minuto.
- Fatura total de mídia deste artigo: quatro imagens de referência do grok-imagine/text-to-image por $0.03 no total, cinco edições no tier básico ($0.033 cada de referência única, $0.036 a composição com duas referências), uma capa do gpt-image-2 por $0.03 — total de $0.318 pelas tarifas atuais.
Tier básico ou tier de qualidade?
O hiapi oferece dois tiers de edição da mesma família, com o mesmo schema de requisição:
grok-imagine/image-to-image |
grok-imagine-quality/image-to-image |
|
|---|---|---|
| Preço | $0.03/imagem + $0.003 por referência | $0.08 para 1k, $0.10 para 2k, mais $0.015 por referência |
| Imagens de referência | 1–3 URLs | 1–3 URLs |
| Ideal para | Troca de cor, repintura de estilo, substituição de cena, volume em lote/produção | Máxima fidelidade de identidade em rostos e detalhes finos |
Este artigo aborda o tier básico. Ele completou todas as receitas abaixo na primeira execução por cerca de um terço do preço — se você está iterando prompts ou gerando variações em lote, comece aqui e só faça upgrade quando notar fidelidade insatisfatória. Fizemos experimentos semelhantes no tier de qualidade; veja o outro artigo de receitas se quiser comparar.
Como estas receitas foram feitas
Cada receita tem três partes: a imagem de entrada, o prompt de edição exato (copie como está) e a saída bruta. Gerei cada imagem de referência com grok-imagine/text-to-image ($0.03 cada), escrevi cada prompt de edição eu mesmo e o executei uma vez na API de tarefas ao vivo do hiapi via grok-imagine/image-to-image. Toda saída que você vê é um resultado de primeira execução — configuração e custo real impressos abaixo de cada imagem.
Como o schema não tem botão de intensidade de edição, dois hábitos de prompt sustentam todas as cinco receitas:
- Escreva primeiro a cláusula de mudança, depois a cláusula de preservação. Declare a edição, depois enumere tudo o que deve permanecer: "Mantenha exatamente a mesma forma do tênis, ângulo de câmera, iluminação, fundo e sombra no chão." A cláusula de preservação é seu único controle de consistência — trate-a como estrutura de sustentação, não como decoração.
aspect_ratio: "auto"herda o enquadramento da entrada — da primeira URL. Todas as cinco edições usaramauto. Na receita 4, a primeira referência era quadrada e a segunda 4:3; a saída voltou quadrada. Se você compõe duas referências, coloque em primeiro lugar emimage_urlsa que deve ditar a composição.
Receita 1 — Troca de cor de produto: nova paleta, todo o resto igual
Objetivo: a edição mais comum no e-commerce — mudar a cor de um produto sem refazer o ensaio.
Entrada, uma foto de produto do grok-imagine/text-to-image de $0.03:

Prompt:
Recolora o tênis em lona verde-sálvia suave, com sola de borracha creme e cadarços verde-sálvia combinando. Mantenha exatamente a mesma forma do tênis, ângulo de câmera, iluminação, fundo e sombra no chão. Não adicione nenhum outro objeto.
Saída bruta:

grok-imagine/image-to-image · resolution: "1k" · aspect_ratio: "auto" (entrada 1:1 → saída 1:1) · $0.033
Por que funciona: a cláusula de mudança especifica três materiais concretos (lona, sola, cadarços) e cores concretas, e a cláusula de preservação fixa forma, ângulo, iluminação, fundo e sombra. Costuras, quantidade de ilhoses e textura da biqueira foram preservadas. Nomear as peças — "sola", "cadarços" — importa: um prompt vago como "deixe verde" faz o modelo tingir qualquer coisa ao acaso.
Receita 2 — Migração de cena: de foto de estúdio para rua à noite
Objetivo: colocar o mesmo tênis de catálogo em uma cena de lifestyle com atmosfera, para peça publicitária.
Entrada igual à da receita 1. Prompt:
Coloque este exato tênis no asfalto molhado de uma rua urbana à noite, com letreiros de neon refletidos nas poças rasas ao redor, iluminação cinematográfica em ciano e magenta, ângulo de câmera baixo. Mantenha o design, a cor e as proporções do tênis inalterados.
Saída bruta:

grok-imagine/image-to-image · resolution: "1k" · aspect_ratio: "auto" · $0.033
Por que funciona — e um aviso honesto: a descrição da cena é densa (superfície, clima, letreiros, tonalidade, altura da câmera), então o modelo não teve lacunas para preencher com conteúdo genérico. O design e as proporções foram preservados. Mas observe que o tênis parece levemente rosado: o modelo reiluminou o produto com o neon magenta da cena, como a luz ambiente real faria. É uma renderização fisicamente plausível, não um defeito — mas se a precisão da cor da marca for inegociável, diga explicitamente: "A lona permanece branca pura, sem desvio de cor vindo do ambiente."
Receita 3 — Transferência de estilo: de foto para aquarela
Objetivo: transformar uma foto de retrato em ilustração mantendo a pessoa reconhecível.
Entrada, um retrato do grok-imagine/text-to-image de $0.03:

Prompt:
Transforme esta foto em uma ilustração em aquarela solta: lavagens de tinta suaves, textura de papel visível, bordas que sangram, mínimo de traços. Mantenha a pose, o cabelo curto preto, os brincos de argola e a gola alta amarela claramente reconhecíveis.
Saída bruta:

grok-imagine/image-to-image · resolution: "1k" · aspect_ratio: "auto" (entrada 3:4 → saída 3:4) · $0.033
Por que funciona: o estilo é descrito por mecanismos do meio — lavagens, textura de papel, bordas que sangram, traços — e não por nomes de artistas ou rótulos vagos como "artístico". A cláusula de preservação ancora a identidade em quatro atributos concretos (pose, cabelo, brincos, suéter), e todos os quatro sobreviveram à transformação de meio, até o único brinco de argola visível.
Receita 4 — Duas referências: coloque este produto naquela cena
Objetivo: compor o produto de uma imagem no ambiente de outra — uma edição que normalmente exige máscaras e um compositor.
Referência 1 (o produto, e o enquadramento que a saída seguirá):

Referência 2 (a cena):

Prompt:
Coloque o porta-filtro de café cerâmico preto e a jarra de vidro da primeira imagem sobre a mesa de madeira da segunda imagem, com a luz dourada da janela incidindo sobre o vidro, mantendo o design do produto idêntico ao da primeira imagem, com atmosfera calorosa de fotografia analógica.
Saída bruta:

grok-imagine/image-to-image · dois image_urls · resolution: "1k" · aspect_ratio: "auto" (segue a primeira referência: 1:1) · $0.036
Por que funciona: o prompt atribui um papel a cada referência pela posição — "da primeira imagem", "na segunda imagem" — então o modelo sabe qual é o sujeito e qual é o palco. O contorno do porta-filtro e o bico da jarra batem com a referência, e os feixes da hora dourada caem exatamente onde estavam na referência de cena. Note a saída quadrada: com várias referências, a primeira URL determina o enquadramento da saída, então ordene image_urls de propósito.
Receita 5 — Conversão de material: de foto para adesivo recortado
Objetivo: transformar uma foto em adesivo de estilo vetorial plano — um único prompt para obter rapidamente material para redes sociais e produtos.
Entrada igual ao retrato da receita 3. Prompt:
Converta este retrato em um adesivo recortado vetorial plano: contornos grossos e limpos, sombreamento simples estilo cel, borda branca espessa de adesivo ao redor da figura, fundo claro liso. Mantenha o cabelo curto preto, os brincos de argola e a gola alta amarela.
Saída bruta:

grok-imagine/image-to-image · resolution: "1k" · aspect_ratio: "auto" · $0.033
Por que funciona: "adesivo recortado vetorial plano" sozinho é ambíguo, então o prompt o define operacionalmente — contornos, sombreamento cel, borda, fundo. Os atributos de identidade na cláusula de preservação sobreviveram uma segunda vez a uma transformação total de meio, e esse é o ponto: um retrato de referência pode se expandir em um kit inteiro de materiais (aquarela, adesivo e qualquer estilo que você escrever em seguida), por $0.033 cada.
Executando exatamente a mesma chamada
Tudo acima usa a API de tarefas assíncronas: criar tarefa, consultar tarefa, baixar saída. Com curl:
curl -X POST https://api.hiapi.ai/v1/tasks \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine/image-to-image",
"input": {
"prompt": "Recolora o tênis em lona verde-sálvia suave, com sola de borracha creme e cadarços verde-sálvia combinando. Mantenha exatamente a mesma forma do tênis, ângulo de câmera, iluminação, fundo e sombra no chão. Não adicione nenhum outro objeto.",
"image_urls": ["https://your-cdn.example.com/sneaker.jpg"],
"resolution": "1k",
"aspect_ratio": "auto"
}
}'
A resposta retorna um taskId. Consulte-o até que status seja success e então baixe a imagem de output[0].url (as URLs expiram rápido — salve o arquivo, não faça hotlink):
curl https://api.hiapi.ai/v1/tasks/$TASK_ID \
-H "Authorization: Bearer $HIAPI_API_KEY"
Três regras de schema que ajudam a evitar 400:
image_urlsdeve ser publicamente acessível — sem cabeçalhos de autenticação, sem localhost. Envie primeiro as imagens de referência para um bucket ou CDN.resolutioné1kou2kem minúsculas;aspect_ratioéautoou uma das 13 proporções fixas (2:1,20:9,19.5:9,16:9,4:3,3:2,1:1,2:3,3:4,9:16,9:19.5,9:20,1:2).- Qualquer outro campo —
strength,seed,n,negative_prompt— é rejeitado:additional properties not allowed. O prompt é toda a superfície de controle, e é por isso que o padrão de cláusula de preservação importa.
Configuração, exemplos em Python e tratamento de erros estão no guia complementar: Como usar imagem para imagem do grok-imagine pela API do hiapi.
Perguntas frequentes
O grok-imagine/image-to-image suporta strength, seed ou prompt negativo?
Não. O schema de entrada é prompt, image_urls e os opcionais resolution / aspect_ratio — verificado em 2026-07-13 contra a API ao vivo; campos desconhecidos retornam 400. Use o padrão de cláusula de mudança/cláusula de preservação para guiar.
Quantas imagens de referência posso enviar, e a ordem importa?
De 1 a 3 URLs públicas, e importa — com aspect_ratio: "auto", o enquadramento da saída segue a primeira URL, e frases de papel como "da primeira imagem / na segunda imagem" vinculam cada referência à sua tarefa.
Quando devo mudar para o tier de qualidade?
O tier básico lidou com troca de cor, substituição de cena, repintura de estilo e composição com duas referências na primeira execução a $0.033–$0.036. Considere o grok-imagine-quality/image-to-image ($0.08 para 1k, mais $0.015 por referência) quando precisar de máxima fidelidade em rostos ou detalhes finos de produto, ou de saída em 2K. Para comparação entre modelos, veja as melhores APIs de imagem para imagem de 2026.
Por que meu produto branco voltou com desvio de cor? O modelo reilumina o sujeito com a luz ambiente da cena (veja o tom magenta na receita 2). Se a cor exata for importante, fixe-a na cláusula de preservação: "A lona permanece branca pura, sem desvio de cor vindo do ambiente."
De onde vêm as imagens de referência? Qualquer URL pública serve — incluindo suas próprias fotos de produto. As nossas foram geradas com grok-imagine/text-to-image a $0.03 cada, então o artigo inteiro — imagens de referência, cinco edições e capa — totaliza $0.318 pelas tarifas atuais.
Todo prompt deste artigo pode ser copiado e colado diretamente. Obtenha uma API key, aponte image_urls para uma das suas próprias fotos de produto e execute a receita 1 exatamente como está na página do modelo grok-imagine/image-to-image — sua primeira troca de cor custa $0.033.
Artigos relacionados
Ver todos os artigos →-
Guia de uso
Guia de introdução ao seedream-5.0-pro/image-to-image: capacidades, preços e pontos de integração
Limites de capacidade, modelo de cobrança e práticas de integração de engenharia do modelo de edição de imagem da ByteDance
-
Guia de uso
Guia prático do seedream-5.0-pro text-to-image: limites de capacidade, integração via API e controle de custos
Perspectiva prática para desenvolvedores: dos pontos-chave dos parâmetros à estimativa de custo de US$ 0,05 por imagem
-
Guia de uso
Guia de introdução ao Hailuo 2.3 Fast image-to-video: limites de capacidade, preços e práticas de integração
Pontos-chave de seleção e integração do modelo image-to-video MiniMax para desenvolvedores