Gerar imagens de produtos de e-commerce com seedream-4.5/text-to-image via API hiapi

Nem toda imagem de produto começa com uma foto. Antes de existir uma amostra, antes de contratar um fotógrafo, ou quando uma promoção sazonal precisa de um banner para amanhã de manhã, você precisa gerar imagens apenas a partir de uma descrição textual — um mockup de produto limpo, uma cena lifestyle, um criativo promocional com texto de título real e nítido.

seedream-4.5/text-to-image foi criado exatamente para esse cenário zero-shot. Basta fornecer uma descrição em linguagem natural e ele retorna uma imagem fotorrealista, sem precisar de nenhuma foto de referência — incluindo texto preciso dentro da imagem, que é justamente a parte em que a maioria dos modelos texto-para-imagem ainda falha. No hiapi, ele roda pelo mesmo endpoint assíncrono /v1/tasks de todos os outros modelos, com preço de $0.045 por imagem, em resolução 2K ou 4K.

Os dois exemplos abaixo são chamadas reais da API, mostrando os prompts exatos e as imagens geradas — sem nenhuma edição posterior.

Geração zero-shot versus edição de fotos reais

O seedream-4.5 é lançado como dois modelos com tarefas distintas:

• seedream-4.5/text-to-image (tema deste artigo) gera imagens a partir de descrições, sem precisar de foto de entrada. Use-o quando o produto ainda não tem uma foto de referência limpa, quando você precisa de uma cena ou conceito que não existe no catálogo, ou quando a entrega é arte de marketing e não a foto de um produto físico específico.
• seedream-4.5/image-to-image edita fotos reais de produtos que você já tem, preservando a forma exata e a identidade da marca enquanto altera o fundo ou o contexto — para esse fluxo de trabalho, consulte o guia de e-commerce com imagem-para-imagem.

Se você precisa de consistência pixel a pixel com um SKU físico, use o modelo de edição. Se você vai criar algo totalmente novo — um render conceitual, um banner sazonal, uma cena que ainda não existe — o texto-para-imagem é a ferramenta certa, e é o que este artigo aborda.

Exemplo 1: foto de produto de estúdio gerada a partir de texto

Prompt enviado ao modelo:

a minimalist amber glass skincare serum bottle with a brushed silver cap
standing on a polished travertine surface, soft diffused window light
casting a gentle gradient shadow, sage green linen backdrop, one small
dried eucalyptus sprig beside the bottle, e-commerce product photography,
sharp focus, clean composition, no text, no logo, subtle reflection on
the stone surface

Parâmetros da requisição: aspect_ratio: "1:1", resolution: "2K".

Aqui não há frasco, nem estúdio, nem fotógrafo — a suavidade da sombra, o reflexo na pedra e a luz suave da janela vêm todos da descrição. É exatamente aí que está a vantagem do texto-para-imagem sobre a edição: gerar mockups de listagem de produto ou moodboards para um produto ainda em desenvolvimento em cerca de um minuto, sem agendar uma sessão fotográfica.

Exemplo 2: criativos promocionais com texto de título real e nítido

A renderização de texto é a metade mais difícil da tarefa deste modelo — a maioria dos geradores de imagem produz texto embaralhado ou com erros de ortografia. Dois prompts, sem nenhuma nova tentativa:

Banner promocional flat-lay:

a flat-lay e-commerce marketing banner for a summer skincare sale, an
arrangement of amber glass bottles and dried botanicals on a warm
terracotta background, bold sans-serif headline text 'SUMMER GLOW SALE'
near the top in cream white lettering, smaller text 'Up to 30% Off'
beneath it in matching cream, clean modern layout with generous negative
space on the right third, professional marketing design, crisp legible
typography, warm cinematic lighting

Parâmetros da requisição: aspect_ratio: "4:3", resolution: "2K".

Story vertical:

a vertical social media story graphic for a candle brand product launch,
a single black matte ceramic candle jar centered on a deep charcoal
gradient background, bold white headline text 'NEW ARRIVAL' near the
top, smaller subtext 'Shop the Collection' below the product, minimalist
premium aesthetic, soft rim lighting on the candle jar, generous margin
for mobile screen safe zones

Parâmetros da requisição: aspect_ratio: "9:16", resolution: "2K".

Os dois títulos e os dois subtítulos saíram com ortografia correta, espaçamento uniforme e exatamente na posição pedida no prompt — já na primeira geração, sem nenhuma nova tentativa. É essa confiabilidade que torna o texto-para-imagem viável para materiais promocionais com prazos apertados: um banner promocional ou story que antes exigia um designer agora pode ser esboçado com uma única chamada de API.

Chamando a API diretamente

O seedream-4.5/text-to-image roda pelo endpoint de tarefas assíncronas do hiapi: envie a tarefa, faça polling até concluir e baixe o resultado.

curl:

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-4.5/text-to-image",
    "input": {
      "prompt": "a minimalist amber glass skincare serum bottle on a travertine surface, soft window light, sage linen backdrop, e-commerce product photography, no text",
      "aspect_ratio": "1:1",
      "resolution": "2K"
    }
  }'

A resposta retorna um task_id. Faça polling em GET /v1/tasks/{task_id} até que status seja succeeded e então leia a imagem em output[0].url. A URL tem prazo de validade — baixe-a imediatamente.

Python (enviar tarefa + polling + download):

import os
import time
import requests

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


def generate_product_image(prompt: str, aspect_ratio: str = "1:1",
                            resolution: str = "2K") -> bytes:
    resp = requests.post(
        f"{API_BASE}/tasks",
        headers=HEADERS,
        json={
            "model": "seedream-4.5/text-to-image",
            "input": {
                "prompt": prompt,
                "aspect_ratio": aspect_ratio,
                "resolution": resolution,
            },
        },
        timeout=30,
    )
    resp.raise_for_status()
    task_id = resp.json()["task_id"]

    while True:
        poll = requests.get(f"{API_BASE}/tasks/{task_id}", headers=HEADERS, timeout=30)
        poll.raise_for_status()
        data = poll.json()
        if data["status"] == "succeeded":
            image_url = data["output"][0]["url"]
            return requests.get(image_url, timeout=30).content
        if data["status"] == "failed":
            raise RuntimeError(f"task {task_id} failed: {data.get('error')}")
        time.sleep(3)

Gerar uma linha de produtos em lote

A mesma chamada pode ser generalizada para uma linha de produtos completa: uma lista de tuplas (name, prompt, aspect_ratio), uma tarefa para cada item, salvando em disco pelo nome.

JOBS = [
    {
        "name": "serum-hero",
        "prompt": "a minimalist amber glass skincare serum bottle on a travertine "
                   "surface, soft window light, sage linen backdrop, e-commerce "
                   "product photography, no text",
        "aspect_ratio": "1:1",
    },
    {
        "name": "sale-banner",
        "prompt": "a flat-lay e-commerce marketing banner for a summer skincare "
                   "sale, amber glass bottles on a terracotta background, bold "
                   "headline text 'SUMMER GLOW SALE', smaller text 'Up to 30% Off'",
        "aspect_ratio": "4:3",
    },
    {
        "name": "story-launch",
        "prompt": "a vertical social story graphic, a black matte ceramic candle "
                   "jar on a charcoal gradient background, bold white headline "
                   "'NEW ARRIVAL', subtext 'Shop the Collection'",
        "aspect_ratio": "9:16",
    },
]

for job in JOBS:
    image_bytes = generate_product_image(
        prompt=job["prompt"],
        aspect_ratio=job["aspect_ratio"],
        resolution="2K",
    )
    with open(f"{job['name']}.jpg", "wb") as f:
        f.write(image_bytes)
    print(f"{job['name']}: done")

A $0.045 por imagem, um lançamento sazonal com 20 peças — hero, banners e stories juntos — custa cerca de $0.90. Como cada tarefa é independente, enviar várias chamadas /v1/tasks em paralelo e fazer polling concorrente (respeitando o limite de taxa da sua conta) é mais rápido do que rodar a lista em sequência.

Comparação com o seedream-5.0-pro

O hiapi também opera o seedream-5.0-pro como um nível separado e mais recente voltado ao trabalho de texto-para-imagem para e-commerce. Não são o mesmo modelo: preço, opções de resolução e características de saída diferem, e o fluxo de trabalho do seedream-5.0-pro é apresentado no guia dedicado a ele. Quando a entrega exige texto confiável dentro da imagem — banners promocionais, stories, cartões de promoção — e você quer preço fixo de $0.045 por imagem, sem planejar em torno de preços por faixa de resolução, o seedream-4.5/text-to-image é o modelo a escolher.

Perguntas frequentes

O seedream-4.5/text-to-image aceita fotos de referência? Não — o text-to-image aceita apenas prompt, aspect_ratio e resolution. Para editar fotos de produtos existentes em vez de gerar novas imagens, use o seedream-4.5/image-to-image.

Quais resoluções e proporções ele suporta? resolution aceita apenas 2K ou 4K — não há nível 1K. aspect_ratio aceita 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2 e 21:9.

Ele renderiza texto de título dentro da imagem de forma confiável? Sim — os dois exemplos promocionais acima renderizaram títulos e subtítulos de várias palavras corretamente já na primeira geração, sem erros de ortografia nem glifos embaralhados.

Qual é o custo de gerar uma linha de produtos em lote? $0.045 por imagem, independentemente do nível de resolução. Um conjunto sazonal de 20 imagens custa cerca de $0.90; um conjunto de 100 imagens custa cerca de $4.50.

Posso rodar gerações em paralelo para acelerar tarefas em lote? Sim — cada tarefa é independente, então enviar várias chamadas /v1/tasks em paralelo e fazer polling concorrente é a forma mais rápida de produzir grandes volumes de material.

Experimente você mesmo

A referência completa de parâmetros e o preço em tempo real estão na página do modelo e na página de preços. Para mais padrões de prompt desse modelo, consulte as receitas de prompt de texto-para-imagem do seedream-4.5. Se o seu fluxo de trabalho parte de fotos reais de produtos em vez de uma página em branco, o guia de e-commerce com imagem-para-imagem do seedream-4.5 cobre como editá-las diretamente.

Obtenha uma chave de API e gere sua primeira imagem de produto ou banner promocional — o código acima pode ser copiado e colado hoje mesmo para rodar diretamente contra a API hiapi.