HiAPI
Blogue

Guia de uso

Wan 2.7 Texto-para-Imagem para Fotografia de Produtos E-commerce: Gere Imagens de Estúdio em 4K com uma Única Chamada de API

Um fluxo de trabalho testado na prática usando wan2.7-image/text-to-image na hiapi para gerar imagens principais, imagens de cena, imagens de embalagem e macro em 4K — com prompts precisos, tempos reais e preço unificado de $0.08

Jul 4, 2026
Wan 2.7 Texto-para-Imagem para Fotografia de Produtos E-commerce: Gere Imagens de Estúdio em 4K com uma Única Chamada de API

Todas as imagens deste guia foram geradas durante a redação por meio da API de tarefas da hiapi com wan2.7-image/text-to-image — os prompts mostrados são exatamente os prompts usados, e os tempos são o tempo real de relógio dessas execuções. Se você vende online e precisa de imagens para listagens de produtos, imagens de cena, mockups de embalagem ou imagens de detalhe ampliáveis, sem reservar um estúdio, este é o fluxo de trabalho que você procura.

Por que usar Wan 2.7 Image para fotografia de produtos

Wan 2.7 Image Pro (ID do modelo wan2.7-image/text-to-image) é o modelo principal de texto para imagem do Tongyi Wanxiang. Três características o tornam especialmente adequado para o trabalho de e-commerce:

  • Saída de até 4K. Os visualizadores com zoom das plataformas de e-commerce e a impressão sob demanda querem mais pixels do que o padrão comum de 1K. O Wan 2.7 suporta nativamente 4096×4096 — sem necessidade de upscaling.
  • Forte aderência aos prompts. Fotografia de produto é composicional: esta garrafa, sobre aquela superfície, iluminada deste lado. Em nossas execuções, as descrições de materiais ("vidro fosco", "alumínio escovado"), a direção da luz e a disposição dos adereços acertaram de primeira.
  • Preço unificado. Na hiapi, $0.08 por imagem em qualquer resolução — 1K, 2K e 4K custam o mesmo (verificado na página de preços ao vivo). A maioria dos modelos premium cobra acréscimo por 4K, então se seu fluxo é predominantemente 4K, a tarifa única é a opção mais econômica. Veja mais comparações abaixo.

Ele também aceita prompts em inglês e chinês, o que importa se sua equipe de copy de produto usa chinês mas a loja atende usuários de inglês.

Início rápido: um POST, uma consulta de status

O Wan 2.7 Image roda na API de tarefas assíncronas da hiapi. Você envia uma tarefa, consulta até que ela termine e baixa a saída. Comece obtendo uma chave de API no guia de início rápido.

Envio:

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image/text-to-image",
    "input": {
      "prompt": "Studio product photograph of a frosted glass serum bottle with a brushed aluminum dropper cap, standing on a seamless pure white background, soft even lighting from two softboxes, gentle contact shadow under the bottle, crisp edges, high detail, commercial e-commerce listing photography",
      "aspect_ratio": "1:1",
      "resolution": "2K"
    }
  }'

Na resposta, data.taskId contém o ID da tarefa. Consulte o endpoint de detalhes até que status seja success:

import requests, time

API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

def generate(prompt, aspect_ratio="1:1", resolution="2K", timeout=600):
    r = requests.post(API, headers=HEADERS, json={
        "model": "wan2.7-image/text-to-image",
        "input": {"prompt": prompt, "aspect_ratio": aspect_ratio,
                  "resolution": resolution},
    })
    task_id = r.json()["data"]["taskId"]

    deadline = time.time() + timeout
    while time.time() < deadline:
        task = requests.get(f"{API}/{task_id}", headers=HEADERS).json()["data"]
        if task["status"] == "success":
            return requests.get(task["output"][0]["url"]).content
        if task["status"] == "fail":
            raise RuntimeError(task.get("error"))
        time.sleep(5)
    raise TimeoutError(task_id)

png_bytes = generate("...")  # save immediately — see the expiry note below

Em nossas execuções, a criação da tarefa retornou em cerca de 2 segundos, a geração em 2K terminou em 60–75 segundos, e as imagens em 4K levaram 86 segundos. Somando a sobrecarga de consultas, orce cerca de um minuto e meio por imagem.

Antes de colocar isso em produção, duas observações operacionais:

  1. As URLs de saída expiram. output[0].url contém um carimbo de tempo expireAt — é um link temporário, não um recurso de CDN. Baixe os bytes e armazene no seu próprio storage no instante em que a tarefa tiver sucesso. Se você já foi afetado por isso, escrevemos sobre o modo de falha em por que sua URL de saída da hiapi retorna 404 e como lidar com isso.
  2. A lista de proporções é rígida. O Wan 2.7 Image aceita apenas 1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8. Qualquer outra proporção — incluindo proporções fotográficas comuns como 3:2 e 4:5 — retorna 400 INVALID_REQUEST, com a mensagem listando as permitidas. Encontramos isso na prática: uma solicitação de 1536×1920 (que simplifica para 4:5) foi rejeitada; reenviar com 3:4 funcionou. Se você precisa do 4:5 do Instagram, gere em 3:4 e corte.

As quatro imagens que toda listagem de produto precisa

A seguir estão quatro tipos típicos de imagem de e-commerce, cada um com o prompt realmente usado e a saída sem edição.

1. Imagem principal em fundo branco

Amazon, eBay e a maioria das plataformas de e-commerce exigem fundo branco puro para a imagem principal da listagem. Pontos-chave no prompt: especifique explicitamente o fundo ("fundo branco puro sem emendas"), exija "sombra de contato suave" para que o produto não pareça flutuar e descreva a configuração de luz como um fotógrafo faria.

Studio product photograph of a frosted glass serum bottle with a brushed aluminum dropper cap, standing on a seamless pure white background, soft even lighting from two softboxes, gentle contact shadow under the bottle, crisp edges, high detail, commercial e-commerce listing photography

Gerada em 1:1 / 2K, levou 61 segundos. A renderização de materiais — o vidro fosco através do qual o conta-gotas é visível por difusão, a textura de metal escovado na tampa — é o resultado da "forte aderência aos prompts".

2. Imagem de cena

Imagens secundárias de listagem servem para comunicar o contexto de uso. Coloque o produto onde o cliente imagina usá-lo e deixe o prompt carregar as exigências de styling: superfície, adereços, direção da luz, profundidade de campo.

A frosted glass serum bottle with a brushed aluminum dropper cap standing on a white marble bathroom counter beside a folded beige linen towel and a sprig of eucalyptus, soft morning window light from the left, shallow depth of field, warm lifestyle product photography for an online store listing

Cada elemento solicitado apareceu: bancada de mármore, toalha dobrada, eucalipto, luz da janela à esquerda, esmaecimento do fundo. Este é o tipo de imagem em que a aderência ao prompt mais importa, porque um adereço a mais ou a menos significa regerar.

3. Imagem de embalagem com texto de marca legível

A renderização de texto é onde a maioria dos modelos de imagem falha em trabalhos de produto. Textos curtos e explícitos renderizam de forma confiável no Wan 2.7 — coloque a string exata entre aspas e descreva a tipografia:

Product packaging shot: a matte sage-green cardboard box with the brand name "VELA" printed in clean white sans-serif capital letters on the front panel, standing next to a matching frosted glass serum bottle, studio lighting on a light gray seamless background, sharp focus, e-commerce product photography

"VELA" renderizou exatamente. Um alerta honesto do nosso teste: isso vale para strings curtas que você especifica explicitamente. Quando um rascunho inicial da nossa imagem de banner deixou o rótulo a critério do modelo, ele inventou um texto sem sentido plausível na garrafa ("SERUM SERUE") — então ou coloque entre aspas o texto exato que deseja, ou peça "sem rótulo, sem texto, sem logotipo" e adicione o rótulo depois. Sempre revise qualquer texto nas imagens geradas antes de publicar.

4. Imagem de detalhe macro em 4K

Imagens de detalhe ampliáveis sustentam preços premium. É aqui que a saída em 4K e a tarifa única entram em jogo — os mesmos $0.08 compram um arquivo de 4096×4096:

Extreme close-up macro photograph of fine water droplets on the frosted glass surface of a cosmetic serum bottle, the brushed aluminum cap edge visible at the top of the frame, crisp micro-detail, controlled studio reflections, luxury skincare advertising detail shot

O arquivo em resolução total é 4096×4096 (cerca de 1,2 MB em JPEG otimizado) e permanece nítido sob os visualizadores com zoom das plataformas de e-commerce, sem nenhum upscaling.

Comparação para cargas de trabalho de e-commerce

Todos os preços abaixo são as tarifas por imagem ao vivo da hiapi no momento da redação — consulte a página de preços para os números atuais.

Modelo 1K 2K 4K Ideal para
wan2.7-image/text-to-image $0.08 $0.08 $0.08 Fluxos predominantemente 4K, composições com muitos prompts
gpt-image-2/text-to-image $0.03 $0.04 $0.06 Catálogos de alto volume em que 1K–2K basta
nano-banana $0.05 — — Velocidade (1–2 segundos por imagem), iteração rápida
nano-banana-pro $0.17 $0.17 $0.2992 Materiais de marcas premium, muita renderização de texto

Nossa regra de decisão sugerida: se suas listagens precisam de 4K, o Wan 2.7 é a opção 4K mais barata da linha de produtos, e a tarifa única torna a previsão de custos muito simples. Se 1K–2K basta e o volume é limitado, o gpt-image-2 é o cavalo de batalha do orçamento. Se você precisa iterar dezenas de vezes na composição antes de definir a abordagem, a geração em 1–2 segundos do nano-banana mantém o ciclo rápido — depois re-renderize a opção vencedora em 4K no Wan 2.7.

Uma listagem completa de produto — imagem principal, imagem de cena, imagem de embalagem, macro — custa $0.32 no Wan 2.7 e menos de cinco minutos de tempo de relógio se as tarefas rodarem em paralelo.

Conclusão

wan2.7-image/text-to-image oferece às equipes de e-commerce fotografia de produto com qualidade de estúdio em uma única chamada de API assíncrona: $0.08 unificados para qualquer resolução até 4K, forte aderência a exigências composicionais e renderização confiável de textos curtos em embalagens. Atenção à lista rígida de proporções, baixe as saídas antes que as URLs expirem e revise qualquer texto gerado.

Pronto para testar no seu próprio catálogo? Obtenha uma chave de API e comece pela página do modelo Wan 2.7 Image Pro; o início rápido da API assíncrona renderizará sua primeira imagem de produto em 4K em cerca de noventa segundos.

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