Fotografia de produto e-commerce com Qwen Image 2.0 Pro: workflow da API hiapi

TL;DR

• O que é isto: um workflow real de produção para e-commerce usando qwen-image-2.0-pro na API hiapi — uma imagem principal do produto, um banner promocional com texto promocional renderizado e uma grade de variantes, todos gerados com os prompts e requisições exatos mostrados nesta página.
• Por que usar o nível Pro para trabalho com produtos: detalhes realistas mais refinados, renderização de texto na imagem mais confiável (texto promocional real, em vez de letras embaralhadas) e melhor aderência semântica a prompts detalhados — custa $0.107/imagem, até 2048×2048, contra o nível base qwen-image-2.0, que custa $0.025/imagem (preços).
• Fatos verificados da API: o schema de entrada aceita prompt e uma string size ("2048*2048", "2688*1536", "2368*1728", "1728*2368" ou "1536*2688") — não há campo aspect_ratio, e o suporte é apenas para texto-para-imagem (sem image_input / i2i).
• Workflow: envie um tarefa por material em paralelo via /v1/tasks, consulte cada uma até concluir, baixe imediatamente output[0].url (expira) e revise o texto renderizado antes de entregar qualquer conteúdo.

Por que escolher qwen-image-2.0-pro para fotografia de produto

Um anúncio de produto normalmente precisa de três materiais distintos, e eles precisam parecer da mesma sessão de fotos: uma imagem principal limpa para a página do anúncio, um banner promocional com texto promocional real para campanhas de marketing e uma grade de variantes para páginas de catálogo com múltiplos SKUs. É uma superfície de trabalho mais ampla do que uma única imagem principal, e é exatamente aí que o nível Pro justifica o prêmio de preço sobre o qwen-image-2.0 base:

• Detalhes realistas mais refinados. Vidro, metal escovado, pedra — esse tipo de detalhe especular é lido como “foto real” e não como “render” em tamanho de miniatura de catálogo.
• Renderização de texto mais confiável. Banners promocionais e embalagens precisam que o texto exato caia na imagem, com ortografia correta e espaçamento limpo. O nível Pro é ajustado para isso; o banner mais abaixo nesta página é um exemplo não editado.
• Melhor aderência semântica. Os três prompts desta página são longos e específicos em superfície, iluminação e layout — o nível Pro seguiu todos esses requisitos por completo, incluindo a instrução de “sem texto” em duas das imagens.

O custo é o preço: $0.107/imagem, contra $0.025 no nível base (preços verificados em tempo real, 2026-08). Para uma única imagem principal, é um erro de arredondamento. Para um catálogo de centenas de SKUs, é dinheiro real — para como distribuir o trabalho entre os dois, veja Pro vs. nível base abaixo.

Configuração

Você só precisa de uma chave de API da hiapi, nada mais — sem SDK:

export HIAPI_API_KEY="sk-..."

qwen-image-2.0-pro roda pelo endpoint unificado de tarefas assíncronas: POST https://api.hiapi.ai/v1/tasks retorna imediatamente um taskId, e então você consulta GET /v1/tasks/{taskId} até concluir.

Os três materiais que todo anúncio de produto precisa

1. Imagem principal do produto

Imagem para a página do anúncio: produto único, centralizado, fundo limpo, nada disputando a atenção. Prompt completo, exatamente como enviado:

Fotografia de produto em estúdio de um único frasco conta-gotas de vidro âmbar para skincare com rótulo branco fosco em branco, apoiado centralizado sobre um pedestal redondo de pedra travertino, fundo de estúdio contínuo em branco quente levemente esmaecido, luz principal suave e difusa vinda do canto superior esquerdo, uma sombra suave sutil caindo para a direita, textura macro hiperdetalhada no vidro e na tampa conta-gotas de metal escovado, fotorrealista, imagem principal de e-commerce pronta para catálogo, sem texto, sem logotipos, sem adereços

2. Banner promocional com texto renderizado

É aqui que a renderização de texto do nível Pro entra em ação. O prompt pede duas linhas de texto promocional específicas em cantos específicos — sem texto de preenchimento, sem “insira seu texto aqui”:

Fotografia de banner promocional de e-commerce em flat-lay: três frascos conta-gotas de vidro âmbar para skincare dispostos na diagonal sobre um fundo quente em tom terracota com ramos secos de eucalipto, iluminação de estúdio suave vinda de cima com sombras gentis, no canto superior direito texto branco em negrito, limpo e sem serifa escrito SUMMER GLOW SALE, logo abaixo texto branco menor escrito SAVE 20% TODAY, nenhum outro texto em lugar algum, fotografia comercial fotorrealista, foco nítido

Segundo o manual de operações de conteúdo da hiapi, texto renderizado nunca deve ser entregue sem uma leitura humana — a renderização de texto por IA é confiável, mas não infalível, e falhas ocasionais de letras ou espaçamento só aparecem na revisão. Este banner foi conferido caractere por caractere contra o prompt antes de ser publicado nesta página.

3. Grade de variantes

Para páginas de catálogo que listam cada especificação ou fragrância, uma grade em mosaico mantém todas as variantes visualmente consistentes:

Fotografia de grade de produtos em flat-lay vista de cima de seis frascos conta-gotas de vidro âmbar para skincare com rótulos brancos foscos em branco, dispostos em duas fileiras organizadas de três sobre um fundo de estúdio contínuo em cinza claro, iluminação suave e uniforme e difusa com sombras mínimas, espaçamento consistente entre os frascos, layout de grade de variantes de catálogo fotorrealista, sem texto, sem logotipos

Observe os rótulos em branco nas três imagens — rótulos por SKU (nome da marca, fragrância, tamanho) são texto pequeno em superfícies pequenas, um alvo de renderização mais difícil do que o título de um banner. O padrão prático é: gerar os frascos com rótulos em branco e depois compor o texto do rótulo em pós-produção. E isso também torna a atualização mais rápida quando o preço promocional muda.

Schema de entrada, verificado contra a API em tempo real

O schema do /v1/tasks do qwen-image-2.0-pro é mais rígido do que parece — sem aspect_ratio, sem n e nenhum campo de entrada de imagem:

Campo	Tipo	Obrigatório	Valores
prompt	string	✅	A descrição da sua cena
size	string	✅	2048*2048, 2688*1536, 2368*1728, 1728*2368, 1536*2688
negative_prompt	string	Opcional	O que excluir
seed	integer	Opcional	Para reprodutibilidade
watermark	boolean	Opcional
prompt_extend	boolean	Opcional	Permite que o modelo expanda prompts curtos

Para quem porta requisições de outros modelos de imagem da hiapi, dois pontos merecem atenção: não há parâmetro aspect_ratio aqui (use size diretamente), e este modelo é apenas texto-para-imagem — não há campo de imagem de referência, então você não pode enviar uma foto do seu produto real e pedir variantes. O controle por prompt é o único recurso. A estrutura completa de requisição/resposta e exemplos de erro estão no tutorial da API; esta página foca no caso de uso de e-commerce.

Script em lote: três materiais, um loop de envio

Como /v1/tasks é assíncrono, gerar a imagem principal, o banner e a grade são apenas três envios e três consultas — sem espera serial:

import time
import requests

API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"}

def submit(prompt: str, size: str) -> str:
    r = requests.post(API, headers=HEADERS, json={
        "model": "qwen-image-2.0-pro",
        "input": {"prompt": prompt, "size": size},
    }, timeout=60)
    task_id = (r.json().get("data") or {}).get("taskId")
    if not task_id:
        raise RuntimeError(f"submit failed: {r.text}")
    return task_id

def wait(task_id: str, timeout_s: int = 600) -> dict:
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        task = requests.get(f"{API}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
        if task["status"] == "success":
            return task
        if task["status"] == "fail":
            raise RuntimeError(f"task failed: {task.get('error')}")
        time.sleep(5)
    raise TimeoutError(task_id)

jobs = [
    ("hero-packshot", "Studio product photograph of ...", "2048*2048"),
    ("promo-banner",  "Flat-lay e-commerce promo banner ...", "2688*1536"),
    ("variant-grid",  "Overhead flat-lay product grid ...", "2368*1728"),
]

task_ids = {name: submit(prompt, size) for name, prompt, size in jobs}   # fan out
for name, task_id in task_ids.items():                                    # collect
    result = wait(task_id)
    url = result["output"][0]["url"]           # expires — download immediately
    open(f"{name}.png", "wb").write(requests.get(url, timeout=120).content)

Nos testes, cada renderização na faixa de ~2000px levou cerca de um minuto; sob carga de pico, reserve alguns minutos por imagem antes de considerar que houve timeout.

Pro vs. nível base: qual usar

Os dois níveis compartilham o mesmo schema prompt + size, então alternar entre eles é só mudar uma linha no campo model:

	qwen-image-2.0 (base)	qwen-image-2.0-pro
Preço	$0.025/imagem	$0.107/imagem
Tamanho máximo	2048×2048	2048×2048
Renderização de texto	Boa	Mais forte — escolha padrão para texto promocional
Detalhes realistas	Bons	Mais refinados — escolha padrão para imagens principais
Melhor para	Exploração de prompts, rascunhos em lote, mockups internos	Materiais finais principais/banners, qualquer coisa com texto renderizado

Alocação prática para um catálogo real: rascunhe composições no nível base, quando uma rodada de iteração custa pouco, e depois re-renderize os vencedores selecionados no nível Pro para os materiais efetivamente entregues. O workflow do nível base — mesmo task API, mesmo estilo de prompt — está em Gerar imagens de produto de e-commerce com qwen-image-2.0.

Dicas de prompt para fotos de produto

O que funcionou de forma consistente nas três renderizações:

• Especifique superfície e iluminação, não apenas o sujeito. “Pedestal de pedra travertino” e “luz principal suave e difusa vinda do canto superior esquerdo” contribuem mais para o realismo do que adjetivos como “profissional” ou “alta qualidade”.
• Declare “sem texto, sem logotipos” em imagens que não devem ter texto. Se não for dito, prompts de foto de produto às vezes trazem vestígios de rótulos dispersos; a restrição negativa explícita mantém a imagem do produto limpa.
• Para banners, escreva o texto exato entre aspas. “Texto branco em negrito, limpo e sem serifa, escrito SUMMER GLOW SALE” renderiza com precisão; um “algum texto promocional” mais vago deixa a redação ao acaso.
• Peça rótulos em branco na embalagem, não texto de marca minúsculo. Texto em superfícies pequenas é o alvo de renderização mais difícil em qualquer modelo de imagem — componha em pós-produção.

FAQ

Posso alimentar o qwen-image-2.0-pro com uma foto do meu produto real para gerar variantes? Não — este modelo é apenas texto-para-imagem, e seu schema não tem campo de entrada de imagem. Para workflows de imagem-para-imagem, você precisa de outro modelo na hiapi que suporte i2i explicitamente.

O texto renderizado é confiável o suficiente para entregar sem revisão? Não — é confiável, mas não perfeito. Leia caractere por caractere contra o prompt antes de publicar e regenere em caso de falhas raras. Veja a observação sob o banner promocional acima.

Que tamanho usar para a imagem principal do anúncio e para o banner? O quadrado 2048*2048 atende aos requisitos de anúncio da maioria dos marketplaces. Para banners promocionais largos ou carrosséis principais, 2688*1536 ou 2368*1728 (horizontal/vertical) fica mais próximo das proporções comuns de banner web, sem necessidade de recorte posterior.

O nível Pro oferece desconto por volume? Não — o preço é fixo em $0.107 por imagem, independentemente do volume; a alavanca de custo é quantas imagens você gera, não uma tarifa por volume.

Resumo

Para catálogos de e-commerce, a vantagem do qwen-image-2.0-pro sobre o nível base cai exatamente onde a fotografia de produto precisa: detalhes realistas mais limpos nas imagens principais, renderização de texto confiável nos banners promocionais e um preço ainda moderado de $0.107/imagem. Envie as requisições de imagem principal, banner e grade de variantes em paralelo via /v1/tasks, revise qualquer conteúdo com texto renderizado antes de entregar e, quando estiver iterando em composições em vez de entregar materiais finais, use o nível base. A página do modelo qwen-image-2.0-pro tem preços em tempo real e referência de parâmetros para continuar a partir daqui.