HiAPI
Blogue

Guia de uso

Guia prático de imagens de produtos de e-commerce com Seedream 5.0 Flash

Oct 8, 2026
Guia prático de imagens de produtos de e-commerce com Seedream 5.0 Flash

Por que a fotografia de produtos é o ponto de entrada mais fácil de obter resultados

A maioria das equipes que tentam usar modelos de imagem para e-commerce começa fazendo uma imagem principal e para por aí. O fluxo de trabalho mais útil tem duas etapas: primeiro gerar uma imagem de produto limpa de estúdio e depois alimentar essa mesma imagem de volta ao modelo para gerar uma variante de cena de estilo de vida — o mesmo produto, com a mesma forma e cor, em um cenário diferente. O seedream-5.0-flash no hiapi suporta ambos em uma única API: geração puramente a partir de texto para a imagem de estúdio e edição imagem-para-imagem (image + prompt) para a recriação da cena de estilo de vida, ambas concluídas por meio da mesma chamada POST /v1/tasks.

Este artigo percorre duas chamadas para um produto real (um porta-filtro de café de cerâmica pour-over), fornecendo os prompts exatos e as duas imagens que eles geram.

Etapa 1: imagem de produto de estúdio (texto para imagem)

Briefing: fundo branco, iluminação uniforme, espaço negativo suficiente para posteriormente inserir texto na página de listagem do produto. Não é necessária imagem de referência — trata-se de uma chamada comum de prompt + size.

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer sk-<your-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-flash",
    "input": {
      "prompt": "Fotografia profissional de produto de e-commerce de um porta-filtro de café de cerâmica pour-over cinza-carvão fosco com um colar de madeira clara, colocado sobre um fundo de estúdio branco suave sem emendas, iluminação de softbox de três pontos com reflexos suaves, leve ângulo de 3/4, foco nítido na textura da superfície, sem texto, sem logotipos, sem marca d'água, composição ampla de 16:9 com generoso espaço negativo no lado direito.",
      "size": "2K"
    }
  }'

Este é o prompt exato usado para gerar a imagem acima — copie-o como modelo inicial e substitua pela descrição do seu próprio produto. Após consultar repetidamente GET /v1/tasks/{id} até que status atinja success, o resultado é retornado como um único output[0].url; baixe-o imediatamente, pois as URLs de saída da tarefa expiram.

Etapa 2: reutilizar a mesma imagem para gerar uma cena de estilo de vida (imagem para imagem)

Em vez de gerar um segundo produto do zero, passe a URL da imagem de estúdio de volta como o campo image, junto com um novo prompt. O modelo mantém a forma, a cor e o material do produto consistentes, enquanto altera tudo ao redor:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer sk-<your-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-flash",
    "input": {
      "prompt": "Usando exatamente este porta-filtro de café de cerâmica pour-over como sujeito, mantenha a forma, a cor e o material do produto idênticos, mas coloque-o sobre uma bancada de cozinha rústica de madeira de carvalho claro, ao lado de um guardanapo de linho dobrado e um pequeno copo de café fumegante, luz suave da janela da manhã vinda da esquerda, profundidade de campo rasa, estilo de fotografia de e-commerce lifestyle, sem texto, sem logotipos, sem marca d'água.",
      "image": "https://static.hiapi.ai/blog/seedream-5-0-flash-ecommerce/cover.jpg",
      "size": "1600x900"
    }
  }'

Uma observação que vale a pena mencionar ao testar de ponta a ponta: o campo image precisa ser uma URL real e acessível publicamente. Colocar um data URI base64 no mesmo campo neste modelo produz um erro TASK_FAILED de significado ambíguo — primeiro envie a imagem de origem para um local acessível e depois passe a URL dela. É apenas essa substituição que determina se a tarefa falha ou se produz a imagem de cena de estilo de vida acima.

Antes de planejar em torno disso, há um segundo caso limite a observar: background: "transparent" (o parâmetro usado para recortar o produto em um PNG limpo sem fundo) falha consistentemente em várias tentativas com TASK_FAILED task result could not be confirmed; contact support to verify billing status — seja com imagem base64, string de URL ou URL dentro de um array. Se você precisa agora de um recorte isolado do produto, considere esse modo específico não confiável neste modelo e verifique por conta própria antes de depender dele no pipeline; o restante deste guia (geração comum de texto para imagem e edição padrão de imagem para imagem) funciona conforme documentado.

Custo em escala

O seedream-5.0-flash tem preço de US$ 0,025 por imagem, preço fixo, independentemente de a chamada ser texto para imagem ou imagem para imagem — antes de orçar um lote maior de catálogo de produtos, consulte a página de preços do hiapi para conhecer as tarifas atuais. Para um catálogo de produtos, isso significa uma imagem de estúdio mais três a quatro variantes de cena de estilo de vida por SKU, com custo de geração abaixo de US$ 0,15, sem contar qualquer etapa de revisão humana.

Perguntas frequentes

Posso gerar recortes de produto com fundo transparente usando o seedream-5.0-flash? Nos testes, a opção background: "transparent" falha continuamente, independentemente de como a imagem de entrada é passada. A geração padrão com fundo opaco e a edição imagem para imagem funcionam normalmente — apenas o caminho de fundo transparente exige que você verifique por conta própria antes de depender dele.

A imagem de cena de estilo de vida usa o mesmo produto ou o modelo o redesenha? Ela reutiliza o produto da primeira imagem como referência visual por meio da entrada image, portanto a forma, a cor e o material permanecem consistentes — apenas o cenário ao redor (bancada, adereços, iluminação) muda de acordo com o novo prompt.

Por que minha chamada imagem para imagem falha com uma imagem codificada em base64? A entrada image do seedream-5.0-flash é mais confiável com uma URL pura e acessível publicamente do que com um data URI base64. Primeiro envie a imagem de origem e depois faça referência a ela por URL.

Qual é a diferença em relação a gerar a cena de estilo de vida diretamente com um prompt de texto para imagem mais longo? Descrever o produto do zero no segundo prompt aumenta o risco de pequenos desvios de forma, cor ou proporção entre as duas imagens. Alimentar a imagem realmente gerada como image mantém o próprio produto fixo, e apenas o cenário ao redor muda.

Experimente você mesmo

Confira o preço atual do seedream-5.0-flash e teste diretamente na página do modelo, ou veja como ele se compara a outras opções na nossa comparação de ferramentas de IA para imagens de produtos de e-commerce.

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