Genera imágenes de producto para comercio electrónico con seedream-5.0-lite/image-to-image a través de hiapi

La fotografía de producto para tiendas online rara vez consiste solo en generar una imagen bonita. Requiere generar repetidamente el mismo producto: una imagen de listado sobre fondo blanco, escenas de estilo de vida, imágenes de corrección de herrajes o etiquetas tras un cambio de proveedor, y una serie de cinco variantes de color para la página de producto. Los modelos de texto a imagen rinden mal aquí, porque cada nuevo prompt inventa un producto ligeramente distinto.

Aquí es donde entra seedream-5.0-lite/image-to-image. Es el editor de imágenes basado en instrucciones de ByteDance: proporcionas una foto real del producto (o hasta 14 imágenes de referencia), describes la edición en lenguaje natural y el modelo sigue la instrucción manteniendo coherentes las zonas no editadas. En hiapi, la resolución 2K cuesta solo $0.035 por imagen: una serie completa de seis imágenes de listado cuesta unos $0.21.

Todo lo que sigue se generó mediante llamadas reales a la API en hiapi. Cada sección muestra la salida real y el prompt exacto.

Flujo de trabajo: un ancla, muchas ediciones

El patrón que hace que las imágenes de producto con IA sean aptas para producción es anclar y editar:

1. Anclar: consigue una imagen de producto limpia y estándar. Fotografía el producto real, o genera una imagen conceptual una sola vez con seedream-5.0-lite/text-to-image (también $0.035).
2. Editar: introduce esa imagen ancla en image-to-image para generar cada versión derivada: sustitución de fondo, correcciones de detalles, colores. La identidad del producto proviene de los píxeles de referencia, no del prompt, así que en cada imagen aparece la misma bolsa.

Esta es nuestra imagen ancla: una bolsa de viaje de fin de semana de lona, generada una sola vez con el modelo hermano de t2i y usada como referencia para todas las ediciones posteriores:

Estructura de la solicitud

seedream-5.0-lite/image-to-image funciona sobre el endpoint de tareas asíncronas de hiapi: se envía a POST /v1/tasks, se consulta el ID de tarea hasta que termina y luego se descarga la URL de salida. Cuatro campos de entrada, todos obligatorios:

Campo	Tipo	Descripción
prompt	string	Instrucción de edición
image_urls	array	1–14 URL de imágenes de referencia de acceso público
aspect_ratio	enum	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
resolution	enum	Solo 2K o 4K: este modelo no tiene nivel 1K

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-lite/image-to-image",
    "input": {
      "prompt": "Replace the white studio background: place the bag on a weathered wooden bench in a sunlit modern loft. Keep the bag itself completely unchanged.",
      "image_urls": ["https://your-cdn.com/products/weekender-anchor.jpg"],
      "aspect_ratio": "3:2",
      "resolution": "2K"
    }
  }'

La respuesta incluye data.taskId. Consulta GET /v1/tasks/{taskId} hasta que status sea success y luego descarga output[0].url de inmediato: los enlaces de salida caducan, así que copia el archivo en tu propio almacenamiento. En nuestra ejecución, cada edición tardó entre 60 y 120 segundos aproximadamente.

Patrón de edición 1: reescenificación del fondo (listado → estilo de vida)

La edición más frecuente en comercio electrónico: el mismo producto, una escena nueva. El truco clave del prompt es dedicar la mayor parte del texto a fijar lo que no debe cambiar y después describir el nuevo entorno:

Mantén esta bolsa de viaje de fin de semana de lona naranja quemado completamente sin cambios: la misma forma, el mismo color, las mismas asas, las mismas costuras, con ribetes de cuero marrón oscuro y cremalleras de latón. Sustituye el fondo blanco de estudio: coloca la bolsa sobre un banco de madera desgastada en un ático moderno bañado por el sol, con luz suave de mañana entrando por grandes ventanales, plantas verdes desenfocadas al fondo, una sombra de contacto natural sobre el banco de madera y un estilo cálido de fotografía de estilo de vida de revista.

Comparada con la imagen ancla: los ribetes, el parche de cuero con costura cruzada, los tiradores de las cremalleras y las proporciones se mantienen. La sombra de contacto se proyecta sobre las lamas de madera: ese detalle de anclaje es justo lo que hace que la reescenificación parezca una foto real y no un montaje.

Patrón de edición 2: corrección precisa de detalles (cambio de herrajes)

La etiqueta de «edición precisa» de Seedream Lite implica modificaciones quirúrgicas. Supón que el proveedor cambia los herrajes de latón por herrajes negros mate y no quieres volver a fotografiar. Pide un único cambio y congela todo lo demás:

Mantén esta bolsa de viaje de fin de semana de lona naranja quemado exactamente como está: el mismo fondo blanco, la misma composición, la misma iluminación, la misma textura de lona y los mismos ribetes de cuero marrón. Cambia solo los herrajes metálicos: sustituye todas las cremalleras, anillas y hebillas de latón por herrajes metálicos negros mate. No modifiques nada más.

Las cremalleras, las anillas en D y las hebillas de la correa se vuelven negras; la textura de la lona y la composición no se ven afectadas. Este tipo de edición, si se regenerara con texto a imagen, rediseñaría toda la bolsa sin que te dieras cuenta.

Patrón de edición 3: series de colores

La página de producto necesita que cada variante de color se fotografíe de la misma manera. Recolorea la imagen ancla fijando el diseño, los ribetes y la composición:

Mantén el diseño de esta bolsa de viaje de fin de semana completamente sin cambios: la misma forma, los mismos ribetes y asas de cuero marrón, los mismos herrajes de latón, el mismo fondo blanco de estudio, la misma iluminación y composición. Cambia únicamente el color del cuerpo de lona de naranja quemado a verde bosque profundo, conservando la textura del tejido y las costuras.

Repite la operación con «azul marino», «gris carbón» y «beige arena» y obtendrás en una sola sesión una serie de cinco SKU por $0.175: la composición de cada variante es idéntica, que es justo lo que hace que el selector de color de la página de producto se vea coherente.

Genera por lotes toda la serie de imágenes de listado con Python

En producción no envías una edición cada vez. La API de tareas se paraleliza sin problemas: envía todas las ediciones a la vez y luego consulta. Este es el patrón que usamos (tres ediciones completadas en paralelo en menos de tres minutos):

import json, time, requests, concurrent.futures

API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": "Bearer YOUR_HIAPI_KEY", "Content-Type": "application/json"}
ANCHOR = "https://your-cdn.com/products/weekender-anchor.jpg"

EDITS = [
    ("lifestyle", "3:2", "Keep this exact bag unchanged... place it on a weathered wooden bench in a sunlit loft..."),
    ("hardware-black", "1:1", "Change only the metal hardware to matte black. Do not alter anything else."),
    ("colorway-green", "1:1", "Change only the canvas body color to deep forest green, preserving texture and trim."),
]

def run_edit(name, aspect_ratio, prompt):
    task = requests.post(API, headers=HEADERS, json={
        "model": "seedream-5.0-lite/image-to-image",
        "input": {"prompt": prompt, "image_urls": [ANCHOR],
                  "aspect_ratio": aspect_ratio, "resolution": "2K"},
    }).json()
    task_id = task["data"]["taskId"]
    while True:
        d = requests.get(f"{API}/{task_id}", headers=HEADERS).json()["data"]
        if d["status"] == "success":
            img = requests.get(d["output"][0]["url"]).content   # expires — save it now
            open(f"{name}.jpg", "wb").write(img)
            return name, len(img)
        if d["status"] == "fail":
            raise RuntimeError(f"{name}: {d.get('error')}")
        time.sleep(5)

with concurrent.futures.ThreadPoolExecutor(max_workers=3) as ex:
    for name, size in ex.map(lambda e: run_edit(*e), EDITS):
        print(f"{name}: {size} bytes")

Tres consejos prácticos tras ejecutar este código:

• image_urls debe ser de acceso público. Sube primero la imagen ancla a tu CDN o almacenamiento de objetos; la API valida hasta 14 URL por solicitud.
• Guarda la salida de inmediato. output[0].url es un enlace con caducidad. Antes de hacer cualquier otra cosa, copia los bytes en tu propio bucket de almacenamiento.
• Usa varias imágenes de referencia cuando lo necesites. Pasar varias imágenes de referencia (vistas frontal, trasera y de detalle del mismo producto, o el producto junto con una referencia de estilo) aporta más señales de identidad en artículos complicados, como tejidos estampados.

Coste y cuándo elegir este modelo

A $0.035 por imagen 2K, un conjunto realista de imágenes por SKU —una imagen ancla, una reescenificación de estilo de vida, una corrección de detalle y tres imágenes de color— suma seis imágenes y cuesta $0.21. Consulta los precios más recientes de cada nivel en la página de precios de hiapi.

Si estás eligiendo entre editores: nuestra comparativa de tres modelos image-to-image ejecuta las mismas ediciones con los principales competidores, y la guía de comercio electrónico de Nano-Banana presenta otro stack de anclaje y reescenificación. La ventaja de Seedream 5.0 Lite en este flujo de trabajo reside en la precisión para seguir instrucciones, la entrada de hasta 14 imágenes de referencia y un precio uniforme bajo que convierte el procesamiento por lotes de cada SKU en un coste mínimo.

Cómo empezar

Consigue una clave de API, sube una imagen de producto limpia y ejecuta el prompt de reescenificación de estilo de vida anterior contra seedream-5.0-lite/image-to-image: en pocos minutos tendrás tu primer conjunto de imágenes derivadas. Consulta la referencia completa del endpoint de tareas en la documentación de hiapi.