HiAPI
Blogue

Guia de uso

Fluxo de trabalho de imagens de produtos de e-commerce com o Qwen Image 3.0 Pro

Sep 4, 2026
Fluxo de trabalho de imagens de produtos de e-commerce com o Qwen Image 3.0 Pro

TL;DR (resumo rápido)

  • O que é: um fluxo de trabalho real de e-commerce baseado no qwen-image-3.0-pro da API hiapi — gera fotos de produto principais com qualidade de estúdio, imagens de cenas de estilo de vida e redesenha o mesmo produto em novas cenas a partir de uma imagem de referência, tudo usando os prompts mostrados nesta página.
  • A verdadeira vantagem do nível Pro no trabalho com imagens de produto não é apenas a renderização mais refinada — é o endpoint de imagem para imagem, que recebe uma foto de referência e a redesenha em uma nova cena mantendo o produto reconhecível. O qwen-image-3.0 básico e o qwen-image-2.0-pro anterior não oferecem esse recurso.
  • Preços verificados (em 2026-09): US$ 0,0497 por imagem em resolução 1K, US$ 0,0993 por imagem em 2K, com o mesmo preço nos endpoints de texto para imagem e imagem para imagem; imagem para imagem custa US$ 0,004 adicionais por imagem de referência (1 a 3 imagens de referência suportadas). O qwen-image-3.0 básico custa US$ 0,0358 por imagem de forma uniforme, sem faixas por resolução.
  • Fluxo de trabalho: envie cada material como uma tarefa separada para /v1/tasks, faça polling até a conclusão e baixe imediatamente output[0].url — depois avalie material por material se é mais rápido fazer uma nova renderização de texto para imagem ou um redesenho de imagem para imagem a partir da foto existente.

Por que o fluxo de redesenho importa mais do que a imagem principal

A maioria dos artigos sobre «fotografia de produto com IA» para na foto principal do produto: uma renderização limpa do produto sobre fundo branco. Isso é só os 20% fáceis — qualquer modelo de texto para imagem competente consegue, inclusive o qwen-image-3.0 básico, mais barato.

A parte mais difícil e mais cara de um fluxo de trabalho real de imagens de produto é tudo o que vem depois da imagem principal: o mesmo produto precisa aparecer em cenas de estilo de vida, banners sazonais de marketing, uma dúzia de variações de «como fica na sua casa» — sempre permanecendo o mesmo produto reconhecível. Há dois caminhos para chegar lá:

  1. Reescrever o prompt do zero para cada cena, esperando que o modelo reproduza a mesma forma, cor e proporção do produto a cada vez. Isso gera desvio — detalhes sutis (a posição exata do logo, a curvatura exata da carcaça) mudam entre gerações.
  2. Gerar primeiro uma imagem de referência limpa e depois redesenhá-la em novas cenas com imagem para imagem, instruindo explicitamente o modelo a manter forma e proporção inalteradas. É exatamente para isso que serve o endpoint de imagem para imagem do qwen-image-3.0-pro, e é também a capacidade que nem o qwen-image-3.0 básico nem o schema exclusivo de texto para imagem do qwen-image-2.0-pro possuem nesta comparação.

O restante desta página percorre os dois caminhos com o mesmo produto (um estojo de carregamento de fones sem fio) — uma renderização nova da imagem principal, uma renderização nova de cena de estilo de vida e o redesenho da imagem principal em uma atmosfera completamente diferente a partir da referência — para você ver a diferença diretamente.

Montando os materiais

Cada imagem abaixo é enviada via POST https://api.hiapi.ai/v1/tasks, consultada via GET /v1/tasks/{taskId} até status: "success" e então baixada de output[0].url (o link expira, obtenha-o imediatamente).

1. Foto principal de produto em estúdio (texto para imagem)

Modelo: qwen-image-3.0-pro/text-to-image · entrada: {prompt, aspect_ratio: "1:1", resolution: "1K"} · custo: US$ 0,0497

Prompt: «Professional e-commerce product photography of a minimalist matte-black wireless earbuds charging case, closed lid, resting at a slight angle on a pure white seamless studio background, soft box lighting from upper left creating a gentle gradient shadow beneath the product, subtle reflection on the surface, sharp focus, high dynamic range, no text, no watermark, studio product shot style, centered composition with even margin on all sides»

Esta é a imagem principal da página de detalhes do produto e também a referência usada no redesenho abaixo — uma imagem de produto limpa e uniformemente iluminada sobre fundo sólido oferece ao passo de imagem para imagem a forma mais nítida a preservar.

2. Cena de estilo de vida (texto para imagem)

Modelo: qwen-image-3.0-pro/text-to-image · entrada: {prompt, aspect_ratio: "3:4", resolution: "1K"} · custo: US$ 0,0497

Prompt: «Lifestyle product photography: a minimalist matte-black wireless earbuds charging case placed on a light oak wooden desk next to a small potted succulent and a closed notebook, warm natural window light from the right, shallow depth of field with soft background blur, cozy modern home-office mood, no text overlays, photorealistic, editorial e-commerce lifestyle style»

Observe que esta é uma segunda renderização independente, não um redesenho — vale comparar com o redesenho abaixo, que mantém a identidade do mesmo produto entre cenas em vez de apenas reimaginá-la a partir do prompt.

3. Redesenho a partir da referência (imagem para imagem) — a capacidade diferenciada do nível Pro

Modelo: qwen-image-3.0-pro/image-to-image · entrada: {prompt, image_urls: [<URL da imagem principal>], resolution: "1K"} · custo: US$ 0,0497 + US$ 0,004 (1 imagem de referência) = US$ 0,0537

Prompt: «Redraw the exact same matte-black wireless earbuds charging case from the reference image, keep its shape, color and proportions identical, but place it standing upright on a wet dark charcoal-grey stone surface outdoors at dusk, with soft cyan and violet neon reflections bleeding across the wet stone, shallow depth of field, moody editorial product photography, no text, no watermark»

Este é o fluxo de trabalho que a imagem principal e a cena de estilo de vida por si só não conseguem reproduzir: o mesmo estojo de carregamento do passo 1 é levado para um moodboard completamente diferente, sem precisar descrever sua forma do zero e esperar que a renderização combine. Para campanhas sazonais em que o mesmo produto precisa atravessar cinco atmosferas, este é o caminho mais rápido e mais consistente — basta renderizar uma vez uma referência limpa e depois redesenhá-la repetidamente.

Para mais prompts iniciais prontos para copiar e usar, consulte as receitas de prompt de texto para imagem e as receitas de prompt de imagem para imagem deste modelo.

Código em lote: gerar um conjunto de imagens em paralelo

Diante de um catálogo real, você não envia imagem por imagem. A seguir, um despacho concorrente mínimo para /v1/tasks:

import requests, time

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

jobs = [
    {"model": "qwen-image-3.0-pro/text-to-image",
     "input": {"prompt": hero_prompt, "aspect_ratio": "1:1", "resolution": "1K"}},
    {"model": "qwen-image-3.0-pro/text-to-image",
     "input": {"prompt": lifestyle_prompt, "aspect_ratio": "3:4", "resolution": "1K"}},
    {"model": "qwen-image-3.0-pro/image-to-image",
     "input": {"prompt": redraw_prompt, "image_urls": [hero_url], "resolution": "1K"}},
]

task_ids = [requests.post(API, headers=HEADERS, json=j).json()["data"]["taskId"] for j in jobs]

results = {}
while len(results) < len(task_ids):
    for tid in task_ids:
        if tid in results:
            continue
        data = requests.get(f"{API}/{tid}", headers=HEADERS).json()["data"]
        if data["status"] == "success":
            results[tid] = data["output"][0]["url"]
        elif data["status"] == "fail":
            results[tid] = None
    time.sleep(3)

Envie todas as tarefas primeiro e depois faça polling do lote inteiro — assim os tempos de espera se sobrepõem em vez de serem pagos um a um, em sequência.

Pro, básico e 2.0-pro: para que serve cada um

  • qwen-image-3.0 básico (US$ 0,0358 por imagem, preço uniforme tanto para texto para imagem quanto para imagem para imagem, sem faixas por resolução): adequado para variações de rascunho, mockups internos ou qualquer uso que não será publicado. Se isso é tudo o que você precisa, consulte o guia da API básica.
  • qwen-image-3.0-pro (apresentado nesta página): as faixas de resolução (1K/2K) e o caminho de redesenho com imagem para imagem são os motivos para pagar o prêmio — use-o em qualquer material publicado, especialmente em fluxos de trabalho em que o mesmo produto precisa atravessar vários cenários.
  • qwen-image-2.0-pro (apresentado aqui): continua sendo uma opção confiável de texto para imagem para produtos principais e renderização de texto promocional, mas seu schema não tem nenhum campo de imagem para imagem — se o redesenho a partir de referência é importante para o seu catálogo, o 3.0-pro é o nível que oferece essa capacidade.

Os preços acima são os mais recentes em 2026-09 — antes de planejar orçamentos de grande volume, consulte sempre a página de preços em tempo real, pois os preços por imagem podem mudar.

Perguntas frequentes

O qwen-image-3.0-pro suporta imagem para imagem? Sim — o qwen-image-3.0-pro/image-to-image recebe um prompt mais 1 a 3 imagens de referência enviadas via image_urls, com custo de US$ 0,0497 a US$ 0,0993 por imagem (dependendo da resolução), mais US$ 0,004 por imagem de referência.

Quais resoluções o qwen-image-3.0-pro suporta? 1K e 2K, com preços separados nos endpoints de texto para imagem e imagem para imagem (US$ 0,0497 e US$ 0,0993, respectivamente).

Posso manter a forma exata do produto em várias cenas geradas? É exatamente para isso que serve o endpoint de imagem para imagem: gere primeiro uma imagem de referência limpa e depois redesenhá-la em novas cenas com um prompt que exija explicitamente que o modelo mantenha forma, cor e proporções — como no exemplo de redesenho acima.

Para fotografia de produto, o qwen-image-3.0-pro vale mais a pena que o básico? Se as imagens vão ser entregues a clientes, sim — as faixas de resolução e o endpoint de imagem para imagem (que o qwen-image-3.0 básico não tem) são justamente as duas capacidades pelas quais você paga o prêmio. Para rascunhos internos ou mockups rápidos, o qwen-image-3.0 básico é mais barato e suficiente.

Resumo dos pontos principais

  • O qwen-image-3.0-pro tem dois endpoints importantes para fotografia de produto: text-to-image para novas renderizações e image-to-image para redesenhar uma foto de produto existente em novas cenas mantendo sua identidade.
  • O redesenho com imagem para imagem — e não apenas saídas mais refinadas de texto para imagem — é o fluxo de trabalho que diferencia este nível do qwen-image-3.0 básico e do qwen-image-2.0-pro, que não oferecem edição de imagem baseada em referência.
  • Preços (2026-09): US$ 0,0497 por imagem em 1K, US$ 0,0993 por imagem em 2K, mesmo preço nos dois endpoints; imagem para imagem custa US$ 0,004 adicionais por imagem de referência (1 a 3 suportadas).
  • Para catálogos em que o mesmo produto precisa atravessar vários cenários ou atmosferas, gere uma vez uma referência limpa e redesenhe-a repetidamente — é mais rápido do que reescrever prompts do zero a cada vez e mantém a consistência do produto de forma mais estável.

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