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
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:
- As URLs de saída expiram.
output[0].urlcontém um carimbo de tempoexpireAt— é 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. - 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 como3:2e4:5— retorna400 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 com3:4funcionou. Se você precisa do 4:5 do Instagram, gere em3:4e 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 →-
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