HiAPI
Blog

Guía de uso

Wan 2.7 texto a imagen para fotografía de producto en e-commerce: imágenes de nivel estudio en 4K con una sola llamada a la API

Un flujo de trabajo probado con wan2.7-image/text-to-image en hiapi para generar imágenes principales, imágenes de ambiente, imágenes de empaque y macros en 4K — con prompts exactos, tiempos reales y un precio uniforme de $0.08

Jul 4, 2026
Wan 2.7 texto a imagen para fotografía de producto en e-commerce: imágenes de nivel estudio en 4K con una sola llamada a la API

Cada imagen de esta guía fue generada con wan2.7-image/text-to-image a través de la API de tareas de hiapi durante la redacción: los prompts mostrados son los que se usaron realmente y los tiempos son el tiempo de reloj de pared de esas ejecuciones. Si vendes en línea y necesitas imágenes para fichas de producto, imágenes de ambiente, renders de empaque o detalles ampliables, sin reservar un estudio, este es el flujo de trabajo que necesitas.

Por qué usar Wan 2.7 Image para fotografía de producto

Wan 2.7 Image Pro (ID de modelo wan2.7-image/text-to-image) es el modelo insignia de texto a imagen de Tongyi Wanxiang. Tres características lo hacen especialmente adecuado para el trabajo de e-commerce:

  • Salida de hasta 4K. Los visores con zoom de las plataformas de e-commerce y la impresión bajo demanda quieren más píxeles que el valor predeterminado habitual de 1K. Wan 2.7 admite de forma nativa 4096×4096, sin necesidad de escalado.
  • Fuerte capacidad de seguir prompts. Las imágenes de producto son compositivas: esta botella, sobre aquella superficie, iluminada desde este lado. En nuestras ejecuciones, las descripciones de materiales ("vidrio esmerilado", "aluminio cepillado"), la dirección de la luz y la colocación de los accesorios salieron bien a la primera.
  • Precio uniforme. En hiapi, $0.08 por imagen en cualquier resolución: 1K, 2K y 4K cuestan lo mismo (verificado con la página de precios en vivo). La mayoría de los modelos de gama alta cobran un recargo por 4K, así que si tu flujo se centra en 4K, la tarifa plana es la opción más económica. Más comparativas a continuación.

También acepta prompts en inglés y en chino, lo cual es importante si tu equipo de copy de producto trabaja en chino pero tu tienda se dirige a usuarios en inglés.

Inicio rápido: un POST, un sondeo

Wan 2.7 Image funciona sobre la API de tareas asíncrona de hiapi. Envías una tarea, sondeas hasta que termina y luego descargas la salida. Primero obtén una clave de API en la guía de inicio rápido.

Envío:

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image/text-to-image",
    "input": {
      "prompt": "Studio product photograph of a frosted glass serum bottle with a brushed aluminum dropper cap, standing on a seamless pure white background, soft even lighting from two softboxes, gentle contact shadow under the bottle, crisp edges, high detail, commercial e-commerce listing photography",
      "aspect_ratio": "1:1",
      "resolution": "2K"
    }
  }'

En la respuesta, data.taskId contiene el ID de la tarea. Sondea el endpoint de detalles hasta que status sea success:

import requests, time

API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

def generate(prompt, aspect_ratio="1:1", resolution="2K", timeout=600):
    r = requests.post(API, headers=HEADERS, json={
        "model": "wan2.7-image/text-to-image",
        "input": {"prompt": prompt, "aspect_ratio": aspect_ratio,
                  "resolution": resolution},
    })
    task_id = r.json()["data"]["taskId"]

    deadline = time.time() + timeout
    while time.time() < deadline:
        task = requests.get(f"{API}/{task_id}", headers=HEADERS).json()["data"]
        if task["status"] == "success":
            return requests.get(task["output"][0]["url"]).content
        if task["status"] == "fail":
            raise RuntimeError(task.get("error"))
        time.sleep(5)
    raise TimeoutError(task_id)

png_bytes = generate("...")  # save immediately — see the expiry note below

En nuestras ejecuciones, la creación de la tarea devolvió en unos 2 segundos, la generación en 2K terminó en 60–75 segundos y las imágenes en 4K tardaron 86 segundos. Sumando la sobrecarga del sondeo, calcula alrededor de un minuto y medio por imagen.

Antes de integrarlo en producción, hay dos advertencias operativas:

  1. Las URL de salida caducan. output[0].url incluye una marca de tiempo expireAt: es un enlace temporal, no un recurso de CDN. En el momento en que la tarea tiene éxito, descarga los bytes y guárdalos en tu propio almacenamiento. Si alguna vez te has topado con este problema, escribimos sobre el modo de fallo en por qué tu URL de salida de hiapi devuelve 404 y cómo solucionarlo.
  2. La lista de relaciones de aspecto es estricta. Wan 2.7 Image solo acepta 1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8. Cualquier otra proporción —incluidas proporciones fotográficas habituales como 3:2 y 4:5— devuelve 400 INVALID_REQUEST, con un mensaje que enumera la lista permitida. Nos ocurrió en la práctica: una solicitud de 1536×1920 (que se simplifica a 4:5) fue rechazada; reenviarla como 3:4 funcionó. Si necesitas el 4:5 de Instagram, genera en 3:4 y recorta.

Los cuatro tipos de imagen que necesita cada ficha de producto

A continuación, los cuatro tipos típicos de imagen de e-commerce, cada uno con el prompt real utilizado y la salida sin editar.

1. Imagen principal sobre fondo blanco

Amazon, eBay y la mayoría de las plataformas de e-commerce exigen un fondo blanco puro para la imagen principal de la ficha. Puntos clave del prompt: especifica explícitamente el fondo ("fondo blanco puro sin costuras"), pide una "sombra de contacto suave" para que el producto no flote, y describe la configuración de iluminación como lo haría un fotógrafo.

Studio product photograph of a frosted glass serum bottle with a brushed aluminum dropper cap, standing on a seamless pure white background, soft even lighting from two softboxes, gentle contact shadow under the bottle, crisp edges, high detail, commercial e-commerce listing photography

Generada en 1:1 / 2K, tardó 61 segundos. El renderizado de materiales —el vidrio esmerilado a través del cual se ve el gotero, la textura de metal cepillado del tapón— es el efecto de la "fuerte capacidad de seguir prompts".

2. Imagen de ambiente

Las imágenes secundarias de la ficha sirven para transmitir el contexto de uso. Coloca el producto donde el cliente imagina usándolo y deja que el prompt cargue con los requisitos de estilismo: superficie, accesorios, dirección de la luz, profundidad de campo.

A frosted glass serum bottle with a brushed aluminum dropper cap standing on a white marble bathroom counter beside a folded beige linen towel and a sprig of eucalyptus, soft morning window light from the left, shallow depth of field, warm lifestyle product photography for an online store listing

Cada elemento solicitado apareció: la encimera de mármol, la toalla doblada, el eucalipto, la luz de la ventana desde la izquierda, la atenuación del fondo. Este es el tipo de imagen en el que más importa la capacidad de seguir prompts, porque un accesorio de más o de menos significa volver a generar.

3. Imagen de empaque con texto de marca legible

El renderizado de texto es donde la mayoría de los modelos de imagen fallan en el trabajo de producto. Los textos breves y explícitos se renderizan de forma fiable en Wan 2.7: pon la cadena exacta entre comillas y describe la tipografía:

Product packaging shot: a matte sage-green cardboard box with the brand name "VELA" printed in clean white sans-serif capital letters on the front panel, standing next to a matching frosted glass serum bottle, studio lighting on a light gray seamless background, sharp focus, e-commerce product photography

"VELA" se renderizó exactamente. Una advertencia honesta de nuestras pruebas: esto funciona para cadenas cortas que especifiques explícitamente. Cuando un borrador temprano de nuestra imagen de banner dejaba las etiquetas a la libre interpretación del modelo, este inventó galimatías verosímiles en las botellas ("SERUM SERUE"), así que o bien cita el texto exacto que quieres, o bien indica "sin etiquetas, sin texto, sin logotipos" y añade las etiquetas en posproducción. Corrige siempre cualquier texto de las imágenes generadas antes de publicarlas.

4. Imagen de detalle macro en 4K

Las imágenes de detalle ampliables justifican un precio superior. Aquí es donde entran en juego la salida en 4K y la tarifa plana: los mismos $0.08 compran un archivo de 4096×4096:

Extreme close-up macro photograph of fine water droplets on the frosted glass surface of a cosmetic serum bottle, the brushed aluminum cap edge visible at the top of the frame, crisp micro-detail, controlled studio reflections, luxury skincare advertising detail shot

El archivo a resolución completa es de 4096×4096 (unos 1.2 MB en JPEG optimizado) y se mantiene nítido en los visores con zoom de las plataformas de e-commerce sin ningún escalado.

Comparativa para cargas de trabajo de e-commerce

Todos los precios siguientes son las tarifas por imagen en vivo de hiapi en el momento de la redacción; consulta la página de precios para las cifras actuales.

Modelo 1K 2K 4K Ideal para
wan2.7-image/text-to-image $0.08 $0.08 $0.08 Flujos centrados en 4K, composiciones con muchos prompts
gpt-image-2/text-to-image $0.03 $0.04 $0.06 Catálogos de gran volumen donde basta 1K–2K
nano-banana $0.05 — — Velocidad (1–2 segundos por imagen), iteración rápida
nano-banana-pro $0.17 $0.17 $0.2992 Materiales de marca premium, mucho renderizado de texto

Nuestra regla de decisión recomendada: si tus fichas necesitan 4K, Wan 2.7 es la opción 4K más barata de la línea de productos, y la tarifa plana hace que la previsión de costes sea muy sencilla. Si 1K–2K es suficiente y el volumen es la restricción, gpt-image-2 es el caballo de batalla económico. Si vas a iterar decenas de veces sobre la composición antes de decidirte, la generación de 1–2 segundos de nano-banana mantiene el ciclo rápido; luego vuelve a renderizar la propuesta ganadora en 4K con Wan 2.7.

Una ficha de producto completa —imagen principal, de ambiente, de empaque y macro— cuesta $0.32 en Wan 2.7 y, si ejecutas las tareas en paralelo, menos de cinco minutos de tiempo de reloj de pared.

Conclusión

wan2.7-image/text-to-image ofrece a los equipos de e-commerce fotografía de producto de nivel estudio con una sola llamada a la API asíncrona: $0.08 uniformes por hasta 4K en cualquier resolución, fuerte seguimiento de los requisitos de composición y renderizado fiable de textos cortos de empaque. Ten en cuenta la estricta lista de relaciones de aspecto, descarga la salida antes de que caduque la URL y corrige cualquier texto generado.

¿Listo para probarlo con tu propio catálogo? Obtén una clave de API, empieza en la página del modelo Wan 2.7 Image Pro y el inicio rápido de la API asíncrona renderizará tu primera imagen de producto en 4K en unos noventa segundos.

Artículos relacionados

Ver todos los artículos →

Empieza a crear con artefactos de IA persistentes

Consigue tu API key y llama a modelos de imagen, vídeo y audio a través de una única API basada en tasks.

Leer la documentación de la API