Genera imágenes de producto de comercio electrónico con seedream-4.5/text-to-image a través de la API de hiapi

No todas las imágenes de producto comienzan con una fotografía. Antes de que exista una muestra, antes de contratar a un fotógrafo, o cuando una promoción de temporada necesita un banner para mañana por la mañana, necesitas generar imágenes solo a partir de una descripción textual: una limpia maqueta de producto, una escena de estilo de vida, un gráfico promocional con texto de titular real y nítido.

seedream-4.5/text-to-image está diseñado precisamente para este escenario de cero muestras. Dale una descripción en lenguaje natural y devolverá una imagen fotorrealista, sin necesidad de ninguna fotografía de referencia, incluyendo además texto preciso dentro de la imagen, que es justo la parte en la que la mayoría de los modelos de texto a imagen todavía fallan. En hiapi, se ejecuta igual que todos los demás modelos a través del mismo endpoint asíncrono /v1/tasks, con un precio de $0.045 por imagen, en resolución 2K o 4K.

Los dos ejemplos siguientes son llamadas reales a la API, que muestran sus prompts exactos y las imágenes generadas, sin ninguna edición posterior.

Comparación entre la generación desde cero y la edición de fotos reales

seedream-4.5 se lanza en forma de dos modelos que asumen tareas distintas:

• seedream-4.5/text-to-image (tema de este artículo) genera imágenes a partir de una descripción, sin necesidad de una foto de entrada. Úsalo cuando el producto aún no tenga una foto de referencia limpia, cuando necesites una escena o concepto que no existe en el catálogo, o cuando el entregable sea arte de marketing y no la foto de un producto físico concreto.
• seedream-4.5/image-to-image edita las fotos reales de producto que ya tienes, conservando su forma exacta y su identidad de marca mientras cambia el fondo o el contexto. Para ese flujo de trabajo, consulta la guía de comercio electrónico de imagen a imagen.

Si necesitas una coincidencia a nivel de píxel con un SKU físico, usa el modelo de edición. Si vas a generar algo completamente nuevo —un render conceptual, un banner de temporada, una escena que aún no existe—, texto a imagen es la herramienta adecuada, y es lo que cubre este artículo.

Ejemplo 1: imagen de producto de estudio generada a partir de texto

Prompt enviado al 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 de la solicitud: aspect_ratio: "1:1", resolution: "2K".

Aquí no hay frasco, ni estudio, ni fotógrafo: la atenuación de la sombra, el reflejo sobre la piedra y la suave luz de ventana provienen todos de la descripción. Esta es precisamente la ventaja de texto a imagen frente a la edición: generar una maqueta de ficha de producto o un moodboard para un producto que aún está en desarrollo, en aproximadamente un minuto, en lugar de programar una sesión fotográfica.

Ejemplo 2: gráfico promocional con texto de titular real y nítido

La representación de texto es la mitad más difícil de la tarea de este modelo: la mayoría de los generadores de imágenes producen texto ilegible o mal escrito. Dos prompts, ambos sin reintentos:

Banner promocional plano:

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 de la solicitud: aspect_ratio: "4:3", resolution: "2K".

Gráfico vertical para stories:

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 de la solicitud: aspect_ratio: "9:16", resolution: "2K".

Ambos titulares y ambos subtítulos están escritos correctamente, con un espaciado uniforme entre letras y colocados exactamente donde el prompt los pedía, ya en la primera generación, sin necesidad de reintentos. Esa fiabilidad es lo que hace que texto a imagen sea útil para materiales promocionales con plazos ajustados: un banner promocional o un gráfico para stories que antes requería un diseñador ahora se puede bosquejar con una sola llamada a la API.

Llamar directamente a la API

seedream-4.5/text-to-image se ejecuta a través del endpoint de tareas asíncronas de hiapi: envía la tarea, sondea hasta que se complete y luego descarga el 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"
    }
  }'

La respuesta devuelve un task_id. Sondea GET /v1/tasks/{task_id} hasta que status sea succeeded, y luego lee la imagen desde output[0].url. La URL tiene un tiempo limitado: descárgala de inmediato.

Python (enviar tarea + sondear + descargar):

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)

Generar por lotes una línea de productos

La misma llamada se puede extender a una línea de productos completa: una lista de tuplas (name, prompt, aspect_ratio), un elemento por tarea, guardando en disco por nombre.

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")

Con un precio de $0.045 por imagen, un lanzamiento de temporada con 20 materiales —imágenes principales, banners y gráficos para stories en conjunto— cuesta aproximadamente $0.90. Como cada tarea es independiente, enviar varias llamadas a /v1/tasks de forma concurrente y sondearlas en paralelo (respetando el límite de peticiones de tu cuenta) es más rápido que ejecutar la lista de forma secuencial.

Comparación con seedream-5.0-pro

hiapi también ejecuta seedream-5.0-pro, como un nivel independiente y más reciente orientado al trabajo de texto a imagen para comercio electrónico. No son el mismo modelo: el precio, las opciones de resolución y las características de salida difieren, y el flujo de trabajo de seedream-5.0-pro se presenta en su guía específica. Cuando el entregable requiera texto fiable dentro de la imagen —banners promocionales, gráficos para stories, tarjetas de oferta— y quieras un precio fijo de $0.045 por imagen sin tener que planificar en torno a una escala de precios por resolución, seedream-4.5/text-to-image es el modelo que debes elegir.

Preguntas frecuentes

¿seedream-4.5/text-to-image acepta fotos de referencia? No: text-to-image solo acepta prompt, aspect_ratio y resolution. Para editar una foto de producto existente en lugar de generar una nueva, usa seedream-4.5/image-to-image.

¿Qué resoluciones y relaciones de aspecto admite? resolution solo acepta 2K o 4K: no hay nivel 1K. aspect_ratio acepta 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2 y 21:9.

¿Representa de forma fiable el texto de titular dentro de la imagen? Sí: los dos ejemplos promocionales anteriores representaron correctamente titulares y subtítulos de varias palabras en la primera generación, sin errores ortográficos ni glifos ilegibles.

¿Cuánto cuesta generar por lotes una línea de productos? $0.045 por imagen, independientemente del nivel de resolución. Un conjunto de temporada de 20 imágenes cuesta aproximadamente $0.90; un conjunto de 100 imágenes cuesta aproximadamente $4.50.

¿Puedo ejecutar generaciones en paralelo para acelerar las tareas por lotes? Sí: cada tarea es independiente, por lo que enviar varias llamadas a /v1/tasks de forma concurrente y sondearlas en paralelo es la forma más rápida de producir materiales en grandes volúmenes.

Pruébalo tú mismo

Consulta la referencia completa de parámetros y los precios en tiempo real en la página del modelo y la página de precios. Para obtener más patrones de prompts de este modelo, consulta las recetas de prompts de texto a imagen de seedream-4.5. Si tu flujo de trabajo parte de fotos reales de producto en lugar de una página en blanco, la guía de comercio electrónico de imagen a imagen de seedream-4.5 cubre cómo editarlas directamente.

Obtén una clave de API y genera tu primera imagen de producto o banner promocional: el código anterior se puede copiar y pegar hoy mismo y ejecutar directamente contra la API de hiapi.