HiAPI
Blogue

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.

Jul 13, 2026
Receitas de prompts de imagem para imagem do Grok Imagine: 5 exemplos de edição prontos para copiar e colar com saídas reais

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): prompt e image_urls são obrigatórios; image_urls aceita de 1 a 3 URLs publicamente acessíveis; o opcional resolution é 1k ou 2k em minúsculas; o opcional aspect_ratio aceita auto e 13 proporções fixas de 2:1 a 9:20. Sem strength, sem seed, sem n — 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 usaram auto. 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 em image_urls a 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:

  1. image_urls deve ser publicamente acessível — sem cabeçalhos de autenticação, sem localhost. Envie primeiro as imagens de referência para um bucket ou CDN.
  2. resolution é 1k ou 2k em minúsculas; aspect_ratio é auto ou 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).
  3. 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 →

Comece a criar com artefactos de IA persistentes

Obtenha a sua chave de API e chame modelos de imagem, vídeo e áudio através de uma única API baseada em tasks.

Ler a documentação da API