Crea videos de producto con IA para e-commerce con Seedance 2.0 API

Cada producto de su catálogo merece un video. Una sola foto de producto ahora puede convertirse en un anuncio en video profesional en menos de tres minutos. Sin equipo de grabación, sin alquiler de estudio, sin plazos de posproducción. Seedance 2.0 — el último modelo de generación de video de ByteDance — convierte imágenes estáticas de productos en clips listos para transmitir mediante una simple llamada a la API. Esta guía le muestra cinco tipos distintos de video para e-commerce, un pipeline por lotes para catálogos completos y estrategias de exportación multiplataforma. Todos los ejemplos de código son Python listo para producción.

Por qué el video de producto importa (y por qué los estudios son obsoletos)

Los listados de productos con video superan consistentemente a los que no lo tienen. Según las mejores prácticas de medios de producto de Shopify, los comerciantes que agregan video a las páginas de producto obtienen un engagement y tasas de conversión mediblemente superiores. Las propias directrices para vendedores de Amazon ahora fomentan activamente el video en cada listado, y su programa A+ Content prioriza las páginas mejoradas con video en los resultados de búsqueda.

La brecha entre "saber que el video funciona" y "realmente producir video" ha sido históricamente enorme. Una sola sesión de grabación de video de producto — incluyendo tiempo de estudio, iluminación, equipo, un videógrafo y edición básica — típicamente cuesta entre $500 y $2,000 por SKU. Para un catálogo de 200 productos, eso son seis cifras antes de haber subido un solo archivo.

La economía no es comparable. La generación de video de producto con IA no reemplaza un film de marca de $50,000 — reemplaza el trabajo repetitivo de video por SKU que la mayoría de los equipos de e-commerce omiten por completo o subcontratan con márgenes dolorosos.

Considere las cifras para una tienda Shopify de tamaño medio con 300 SKUs. Video de estudio tradicional para el catálogo completo: $150K–$600K, más meses de programación y producción. Seedance 2.0 API para el mismo catálogo: menos de $50 en total, completado en una sola tarde. Incluso si se tiene en cuenta el tiempo del desarrollador para configurar el pipeline, el retorno de inversión es órdenes de magnitud superior.

El cambio refleja lo que sucedió con la fotografía de producto hace una década. Los estudios no desaparecieron, pero el trabajo rutinario se trasladó a soluciones automatizadas. El video sigue la misma trayectoria, solo que más rápido.

El argumento de conversión del video

Los informes de la industria muestran consistentemente que las páginas de producto con video superan a las que no lo tienen. La propia investigación de Shopify destaca que el video aumenta el tiempo en página y reduce las tasas de devolución al ayudar a los clientes a comprender lo que están comprando. Amazon reporta que los listados con video obtienen mayores tasas de clics en los resultados de búsqueda.

Los números específicos varían según categoría y mercado, pero la dirección es inequívoca: el video vende más producto. La pregunta nunca ha sido si el video funciona. La pregunta ha sido si el ROI justifica el costo de producción. Con los precios de la API, ese cálculo está resuelto.

Configuración: clave API y código base

Necesita una cuenta de EvoLink y una clave API. EvoLink proporciona acceso a Seedance 2.0 con una API REST sencilla. Si aún no ha configurado una cuenta, siga la guía de inicio para un tutorial paso a paso.

Instale la única dependencia:

pip install requests

No se requiere GPU. Sin descarga de modelos. Sin infraestructura que gestionar. La API maneja toda la computación del lado del servidor. Su máquina local solo envía solicitudes HTTP y recibe URLs de video.

Aquí está el código base completo. Cada ejemplo en esta guía se construye sobre esta base:

import requests
import time

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.evolink.ai/v1"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}


def generate_video(payload: dict) -> dict:
    """Submit a video generation request and return the task response."""
    response = requests.post(
        f"{BASE_URL}/videos/generations",
        headers=headers,
        json=payload
    )
    response.raise_for_status()
    return response.json()


def wait_for_video(task_id: str, poll_interval: int = 5, timeout: int = 300) -> dict:
    """Poll a task until it completes or fails. Returns the final task object."""
    elapsed = 0
    while elapsed < timeout:
        resp = requests.get(f"{BASE_URL}/tasks/{task_id}", headers=headers)
        resp.raise_for_status()
        task = resp.json()
        status = task.get("status")

        if status == "completed":
            print(f"✅ Video ready: {task['output']['video_url']}")
            return task
        elif status == "failed":
            raise RuntimeError(f"Task failed: {task.get('error', 'Unknown error')}")

        print(f"⏳ Status: {status} ({elapsed}s elapsed)")
        time.sleep(poll_interval)
        elapsed += poll_interval

    raise TimeoutError(f"Task {task_id} did not complete within {timeout}s")


def create_and_wait(payload: dict) -> dict:
    """Generate a video and wait for the result. Returns the completed task."""
    task = generate_video(payload)
    task_id = task["task_id"]
    print(f"🎬 Task created: {task_id}")
    return wait_for_video(task_id)

Todos los siguientes ejemplos de código utilizan esta misma configuración. Solo mostraremos el payload único para cada tipo de video.

La función create_and_wait maneja el ciclo de vida completo: enviar el trabajo, consultar hasta que se complete y devolver la URL del video. Las URLs de video expiran después de 24 horas, así que descárguelas rápidamente o canalícelas directamente a su sistema de gestión de activos.

El enfoque de polling funciona bien para scripts interactivos y lotes pequeños. Para pipelines de producción que procesan cientos de productos, el parámetro callback_url (cubierto en la sección de pipeline por lotes) elimina por completo la sobrecarga del polling.

Cada ejemplo de código a continuación llama a create_and_wait(payload) con un diccionario de payload diferente. El código de configuración anterior es el único código base que necesita.

Obtenga su clave API gratuita de EvoLink →

Tipo de video 1: Rotación de producto 360°

La rotación tipo turntable es el caballo de batalla del video de e-commerce. Una foto de producto con fondo blanco se convierte en una exhibición rotativa fluida — el tipo de clip que antes requería una plataforma giratoria motorizada e iluminación cuidadosa. Este formato funciona en todas partes: listados de Amazon, páginas de producto de Shopify y anuncios en redes sociales.

Este es el payload para la rotación de un reloj de lujo:

payload = {
    "model": "seedance-2.0",
    "image_urls": [
        "https://your-cdn.com/products/watch-front.jpg"
    ],
    "prompt": (
        "@Image1 is a luxury wristwatch. The watch rotates slowly under "
        "dramatic studio lighting on a dark reflective surface. Light catches "
        "the polished metal case and sapphire crystal. Slow cinematic rotation. "
        "Premium advertisement quality."
    ),
    "duration": 8,
    "quality": "1080p",
    "aspect_ratio": "16:9"
}

result = create_and_wait(payload)

La estructura del prompt importa. Divídala en capas para obtener resultados consistentes con cualquier producto:

Capa 1 — Identificación del sujeto. Comience con @Image1 is a [producto]. Esto ancla el modelo a su imagen fuente. Consulte la guía de @tags para más detalles sobre cómo Seedance 2.0 interpreta las referencias de imagen.

Capa 2 — Descripción del movimiento. "Rotates slowly" es mejor que "spins" — implica velocidad consistente. Agregue "smooth turntable rotation" o "360-degree rotation" para reforzar el patrón de movimiento.

Capa 3 — Iluminación y entorno. Términos de iluminación de estudio a los que el modelo responde bien: "dramatic studio lighting," "soft diffused light," "rim lighting," "three-point lighting setup." La elección del fondo — superficie reflectante oscura, ciclorama blanco, fondo degradado — establece el tono por completo.

Capa 4 — Modificador de calidad. Termine con una señal de calidad: "premium advertisement quality," "commercial-grade," o "4K product showcase." Estos términos empujan al modelo hacia una salida más limpia y pulida.

Consejos para rotación

Para productos con detalles intrincados — joyería, relojes, electrónicos — aumente la duración a 10 segundos. Los fotogramas adicionales permiten al modelo renderizar detalles de superficie durante la rotación sin artefactos de desenfoque de movimiento.

Estrategias de fondo para videos de rotación

El fondo de su imagen fuente afecta significativamente la salida. Así es como manejar los escenarios comunes:

Fondo blanco (ideal). Las fotos estándar de producto de e-commerce sobre blanco funcionan perfectamente. El modelo preserva el producto y genera un movimiento de rotación limpio. Puede mantener el fondo blanco o describir uno diferente en el prompt.

Fondo transparente (PNG). También excelente. El modelo rellena el fondo según la descripción de su prompt, dándole control total sobre el aspecto final.

Fondo desordenado o de estilo de vida. Funcional pero menos predecible. El modelo puede incorporar elementos no deseados del fondo en la rotación. Para mejores resultados, describa el fondo deseado explícitamente: "on a clean white surface" u "on a dark gradient background."

Foto de estudio con fondo controlado. Gran punto de partida. Si su foto existente ya tiene iluminación profesional, el modelo extiende esa calidad de iluminación al video.

Si su foto fuente tiene un fondo desordenado, describa el fondo deseado explícitamente en el prompt. Seedance 2.0 puede recontextualizar el producto sobre una superficie limpia. Para mejores resultados, comience con una foto de producto con fondo blanco o fondo transparente. Lea más sobre los fundamentos de imagen a video para mejores prácticas de imagen fuente.

Pruebe esto con su propia foto de producto — resultados en menos de 3 minutos.

Tipo de video 2: Toma heroica (Tráiler de lanzamiento de producto)

Los tráilers de lanzamiento crean anticipación. Son el momento de revelación cinematográfica — humo, haces de luz, ángulos dramáticos — comprimidos en unos pocos segundos. Este formato domina los anuncios en redes sociales y las secciones hero de landing pages donde las primeras impresiones impulsan las tasas de clics.

payload = {
    "model": "seedance-2.0",
    "image_urls": [
        "https://your-cdn.com/products/headphones-lineup.jpg"
    ],
    "prompt": (
        "@Image1 shows premium over-ear headphones in four colors. "
        "Rapid four-frame flash cuts, each color freeze-framed. "
        "Extreme close-up of hinge mechanism unfolding in slow motion. "
        "Quick-cut lifestyle montage. Final lineup on white pedestal. "
        "Brand text fades in. Commercial-grade lighting."
    ),
    "duration": 10,
    "quality": "1080p",
    "aspect_ratio": "16:9"
}

result = create_and_wait(payload)

El prompt de la toma heroica utiliza un vocabulario diferente al de la rotación. Aquí está dirigiendo una secuencia, no un movimiento continuo único. Piense en cada oración como una escena en un storyboard.

Patrones de prompt para toma heroica

La Emergencia: El producto surge del humo, niebla o partículas. Funciona para productos tecnológicos, fragancias, artículos premium.

@Image1 is [product]. It emerges from dense volumetric fog,
backlit by a single golden spotlight. Particles drift upward.
Slow reveal. Cinematic depth of field. Premium commercial aesthetic.

El Aterrizaje de Impacto: El producto cae al cuadro con energía — salpicadura, estallido, explosión.

@Image1 is [product]. It lands on a glossy black surface with a
subtle shockwave ripple. Dust particles scatter on impact.
Camera pushes in slowly. Dramatic rim lighting. High-end advertisement.

El Ensamblaje: Los componentes se unen para formar el producto completo. Ideal para tecnología y productos modulares.

@Image1 is [product]. Individual components float in space, then
smoothly assemble into the final product. Each piece locks into
place with a satisfying precision. Clean white environment.
Studio lighting. Commercial quality.

El formato de toma heroica se beneficia de mayor duración — de 8 a 12 segundos le da al modelo espacio para construir tensión y resolver la revelación. Los clips más cortos se sienten abruptos; los más largos corren el riesgo de perder la atención del espectador.

Cuándo usar tomas heroicas

Las tomas heroicas funcionan mejor para:

• Lanzamientos de producto. Anuncios de nuevos productos en redes sociales y landing pages. La revelación dramática construye anticipación y señala posicionamiento premium.
• Campañas estacionales. Ventas navideñas, Black Friday, lanzamientos de nuevas colecciones. La calidad cinematográfica eleva la campaña por encima del contenido promocional estándar.
• Creatividades publicitarias. Los anuncios de Facebook, Instagram y TikTok se benefician del poder de detención de una revelación dramática de producto. Estos clips captan la atención en un feed de desplazamiento intensivo.
• Secciones hero del sitio web. Una toma heroica con reproducción automática sobre el pliegue comunica la calidad de marca al instante. Mantenga la duración por debajo de 6 segundos para banners hero y evitar problemas de rendimiento.

Las tomas heroicas son menos apropiadas para páginas de detalle de producto donde los clientes buscan contenido informativo. Reserve el dramatismo para el marketing de la parte superior del embudo; use videos de rotación y macro para la página de producto en sí.

Para consejos de ingeniería de prompts más allá del e-commerce, incluyendo cómo Seedance 2.0 interpreta la terminología cinematográfica, consulte la guía dedicada de prompts.

Tipo de video 3: Contexto de estilo de vida

Las fotos estáticas de producto sobre fondos blancos convierten. Pero las imágenes de estilo de vida — el producto en contexto, siendo usado, en un entorno real — construyen conexión emocional. El video de estilo de vida es el formato que hace que un cliente piense "quiero esa vida", no solo "quiero esa cosa".

Seedance 2.0 soporta entrada de múltiples imágenes. Use @Image1 para el producto y @Image2 para el entorno o escena donde desea colocarlo. El modelo compone el producto en la escena con iluminación natural y perspectiva.

payload = {
    "model": "seedance-2.0",
    "image_urls": [
        "https://your-cdn.com/products/ceramic-mug.jpg",
        "https://your-cdn.com/scenes/cafe-table-morning.jpg"
    ],
    "prompt": (
        "@Image1 is a handmade ceramic coffee mug. @Image2 is a cozy "
        "café table by a window on a rainy morning. The mug sits on the "
        "table, steam rising gently from fresh coffee. Soft natural light "
        "from the window. Shallow depth of field. A hand reaches in and "
        "wraps around the mug. Warm, inviting atmosphere. Lifestyle "
        "advertisement quality."
    ),
    "duration": 8,
    "quality": "1080p",
    "aspect_ratio": "9:16"
}

result = create_and_wait(payload)

Así es como se ve en la práctica — un personaje pintado alcanzando un producto (una taza de café) colocado frente a su marco:

Esta demostración muestra cómo @Image1 (la referencia del personaje/producto) se mantiene visualmente consistente mientras el modelo genera interacción natural con accesorios y entorno. El mismo principio aplica a cualquier video de producto en contexto.

La referencia @Image2 le da al modelo un entorno concreto con el cual trabajar en lugar de alucinar uno solo a partir de una descripción textual. Esto produce resultados más realistas y consistentes. El sistema de @tags soporta hasta nueve imágenes, por lo que puede superponer múltiples imágenes de referencia para escenas complejas.

Sugerencias de escenas de estilo de vida por categoría

La clave del video de estilo de vida es la especificidad. "Una persona usando el producto" genera resultados genéricos. "A hand reaches in and wraps around the mug" crea un momento con intención. Describa la microacción, no el macroconcepto.

Estilo de vida con una imagen vs. dos imágenes

Puede generar videos de estilo de vida con solo una imagen del producto — describa la escena enteramente en el prompt. El modo de dos imágenes (@Image1 + @Image2) produce entornos más consistentes porque el modelo tiene una referencia visual de la escena, no solo una descripción textual.

Cuándo usar cada enfoque:

• Una imagen + prompt descriptivo: Rápido y fácil. Bueno cuando la escena es genérica (por ejemplo, "on a desk," "in a kitchen"). No es necesario buscar una segunda imagen de referencia.
• Dos imágenes (producto + referencia de escena): Composición de mayor calidad. Úselo cuando el entorno específico importa — una estética de café particular, un espacio comercial de marca, un escenario de estilo de vida curado que coincida con las directrices de su marca.

Para el modo de dos imágenes, su referencia de escena no necesita ser su propia foto. Las fotos de stock funcionan bien como referencias de entorno. El modelo extrae la iluminación, la paleta de colores y la disposición espacial de @Image2 y la usa para contextualizar @Image1.

Note el cambio de relación de aspecto: el contenido de estilo de vida para Instagram Reels y TikTok usa 9:16. Haga coincidir la relación de aspecto con la plataforma donde se reproducirá el video. Más sobre esto en la sección de exportación multiplataforma a continuación.

Tipo de video 4: Primer plano de material (Detalle macro)

La textura vende productos premium. La veta del cuero, el acabado cepillado del aluminio, el tejido de un suéter de cachemir — estos detalles comunican calidad de formas que los planos generales no pueden. Un video de primer plano macro que revela lentamente el detalle de la superficie es uno de los formatos de mayor conversión para artículos de lujo y hechos a mano.

payload = {
    "model": "seedance-2.0",
    "image_urls": [
        "https://your-cdn.com/products/leather-wallet.jpg"
    ],
    "prompt": (
        "@Image1 is a full-grain leather bifold wallet. Extreme macro "
        "close-up. The camera slowly glides across the leather surface, "
        "revealing grain texture and hand-stitched seams. Shallow depth "
        "of field with creamy bokeh. Warm directional lighting rakes "
        "across the surface, emphasizing every pore and fiber. The camera "
        "pulls back gradually to reveal the full wallet. Luxury product "
        "photography in motion."
    ),
    "duration": 8,
    "quality": "1080p",
    "aspect_ratio": "16:9"
}

result = create_and_wait(payload)

Vocabulario de prompts para macro

El modelo responde fuertemente a términos cinematográficos específicos. Use estos para controlar el efecto macro:

• "Extreme macro close-up" — activa el encuadre ajustado en detalles de superficie
• "Shallow depth of field" / "creamy bokeh" — desenfoca el fondo, aísla el detalle
• "Raking light" / "directional lighting" — enfatiza la textura de la superficie mediante sombras
• "Camera glides across" — movimiento lateral suave, revela la textura progresivamente
• "Surface texture reveal" — instrucción explícita para enfocarse en la calidad del material

Prompts específicos por material

Cuero: Enfóquese en la veta, las costuras, la pátina. Use iluminación cálida.

Extreme macro on full-grain leather surface. Raking warm light reveals
natural grain variation and hand-stitched seam detail. Camera drifts
slowly across the material. Shallow depth of field.

Metal (cepillado/pulido): Enfóquese en reflejos, marcas de mecanizado, precisión.

Extreme close-up of brushed stainless steel surface. Cool directional
light creates long specular highlights across machined grooves. Camera
tracks along the edge. Mirror-like reflections shift with the angle.

Tela/textil: Enfóquese en el patrón de tejido, detalle de fibra, caída.

Macro view of cashmere knit fabric. Soft diffused light reveals
individual fiber structure and weave pattern. Camera slowly pans
across the textile. Gentle motion shows natural drape and softness.

Veta de madera: Enfóquese en anillos, acabado, variación natural.

Extreme macro of walnut wood surface with oil finish. Warm side
lighting reveals growth rings and natural color variation. Camera
glides along the grain direction. Rich, organic texture detail.

Estos primeros planos de material son particularmente poderosos como el segundo o tercer video en un listado de producto. Después de que el cliente ve el producto completo (rotación o toma heroica), el video de detalle macro refuerza la percepción de calidad. Para técnicas de movimiento de cámara que mejoran estas revelaciones, consulte la guía de movimientos de cámara.

Tipo de video 5: Revelación de unboxing

Los videos de unboxing dominan YouTube y las plataformas sociales por una razón: simulan la experiencia de compra. La anticipación de abrir el empaque, el primer vistazo al producto, la satisfacción de un diseño de desempaquetado bien pensado — este formato conecta con el pico emocional de la compra.

payload = {
    "model": "seedance-2.0",
    "image_urls": [
        "https://your-cdn.com/products/smartwatch-boxed.jpg"
    ],
    "prompt": (
        "@Image1 is a premium smartwatch in its retail packaging. "
        "Hands gently lift the box lid, revealing tissue paper inside. "
        "The tissue parts to unveil the watch nestled in a molded insert. "
        "Soft overhead lighting. The watch face catches the light as "
        "it's lifted from the box. Close-up of the clasp clicking shut "
        "on a wrist. Smooth, deliberate pacing. Unboxing experience "
        "video. Premium commercial quality."
    ),
    "duration": 12,
    "quality": "1080p",
    "aspect_ratio": "9:16"
}

result = create_and_wait(payload)

El formato de unboxing funciona mejor con duraciones más largas — de 10 a 15 segundos — porque cuenta una historia con principio (caja sellada), desarrollo (revelación) y final (producto en uso o exhibición). Los clips más cortos truncan el arco narrativo y pierden la recompensa emocional.

Estructura de prompt para unboxing

Un prompt de unboxing efectivo sigue una estructura de tres actos:

Acto 1 — El empaque (2–3 segundos). Establezca el packaging. Describa manos interactuando con la caja sellada, el material del empaque, cualquier elemento de marca.

Acto 2 — La revelación (4–6 segundos). La tapa se abre. El papel de seda, las inserciones de espuma o las capas protectoras se separan. El producto se hace visible por primera vez. Este es el pico emocional — descríbalo con detalle sensorial.

Acto 3 — El producto (3–5 segundos). El producto se levanta, se exhibe o se pone en uso. Un reloj se coloca en la muñeca. Los auriculares se ponen en los oídos. La pantalla de un teléfono se ilumina. Esto completa la fantasía de compra.

Para productos con empaque distintivo o premium, use una foto que muestre la caja como imagen de entrada. Si solo tiene una foto de producto sobre fondo blanco, describa el empaque en el prompt y deje que el modelo lo genere. Los resultados son más consistentes cuando proporciona una imagen de referencia del empaque real.

El formato vertical 9:16 domina aquí porque el contenido de unboxing vive principalmente en Instagram Reels, TikTok y YouTube Shorts. Para páginas de producto, considere una edición 16:9 con encuadre más ajustado. La guía de movimientos de cámara cubre cómo describir revelaciones dramáticas y ángulos cenital que mejoran las secuencias de unboxing.

El empaque como activo de marketing

Las marcas premium invierten mucho en el diseño de empaque — y los videos de unboxing son donde esa inversión rinde frutos ante la cámara. Si su producto tiene un empaque distintivo (cajas personalizadas, cierres magnéticos, logos en relieve, papel de seda con marca), asegúrese de que su imagen de entrada capture el estado empacado, no solo el producto en sí.

Para productos sin empaque de lujo — cajas marrones estándar, sobres de polietileno, empaque minorista mínimo — aún puede crear una experiencia de unboxing aspiracional. Los productos con empaque poco destacado pueden igualmente producir videos de unboxing convincentes. Enfoque el prompt en el momento de la revelación — el contraste entre una caja cerrada y el producto dentro. El arco narrativo sostiene el video incluso cuando el empaque es estándar.

Combinando tipos de video para un listado completo

Los listados de producto más efectivos usan múltiples tipos de video juntos. Una combinación sólida para una página de producto:

1. Toma heroica (primer video) — Capta la atención, establece posicionamiento premium
2. Rotación 360° (segundo video) — Muestra el producto desde todos los ángulos
3. Primer plano macro (tercer video) — Demuestra calidad a través del detalle del material
4. Contexto de estilo de vida (cuarto video) — Ayuda al cliente a visualizar la propiedad

Para la promoción en redes sociales del mismo producto, lidere con la toma heroica o la revelación de unboxing (ambas optimizadas para detener pulgares en un feed), luego haga retargeting a los espectadores con contenido de estilo de vida y rotación.

Genere los cinco tipos a partir de una sola foto de producto en una ejecución del pipeline. El sistema por lotes en la siguiente sección lo maneja automáticamente.

Exportación multiplataforma: relaciones de aspecto para cada canal

Un video de producto es útil. El mismo video en cada formato que sus canales necesitan es un sistema. Cada plataforma tiene diferentes preferencias de relación de aspecto, comportamientos de reproducción automática y duraciones óptimas. Generar un solo video y recortarlo para que encaje destruye la composición. Generar nativamente en cada relación produce un video encuadrado correctamente para cada pantalla.

Genere todas las relaciones en un solo paso

Use un bucle simple para generar el mismo video de producto en cada relación que sus canales requieran:

platform_configs = [
    {"name": "amazon",    "aspect_ratio": "16:9", "duration": 8},
    {"name": "instagram", "aspect_ratio": "9:16", "duration": 10},
    {"name": "facebook",  "aspect_ratio": "1:1",  "duration": 8},
    {"name": "website",   "aspect_ratio": "16:9", "duration": 5},
]

base_prompt = (
    "@Image1 is a premium wireless speaker. The speaker rotates slowly "
    "on a matte black surface under soft studio lighting. Clean, minimal "
    "aesthetic. Commercial product video quality."
)

tasks = []
for config in platform_configs:
    payload = {
        "model": "seedance-2.0",
        "image_urls": ["https://your-cdn.com/products/speaker.jpg"],
        "prompt": base_prompt,
        "duration": config["duration"],
        "quality": "1080p",
        "aspect_ratio": config["aspect_ratio"]
    }
    task = generate_video(payload)
    tasks.append({"platform": config["name"], "task_id": task["task_id"]})
    print(f"📐 {config['name']} ({config['aspect_ratio']}): {task['task_id']}")
    time.sleep(1)  # Rate limiting

# Collect results
for t in tasks:
    result = wait_for_video(t["task_id"])
    print(f"✅ {t['platform']}: {result['output']['video_url']}")

Esto envía todas las variantes en paralelo (con una pausa de 1 segundo entre solicitudes para limitación de velocidad), luego recopila los resultados a medida que se completan. Para un catálogo de 100 productos en 4 plataformas, son 400 videos — generados en el tiempo que toma ver un episodio de televisión.

Este patrón envía las cuatro variantes y luego recopila los resultados a medida que terminan. El tiempo total de generación es aproximadamente igual al de un solo video — los cuatro se procesan en paralelo del lado del servidor.

Por qué las relaciones nativas superan al recorte

El prompt se mantiene idéntico entre relaciones de aspecto. Seedance 2.0 recompone la escena para ajustarse a cada relación nativamente, ajustando el encuadre y la disposición espacial en lugar de recortar. Una versión vertical 9:16 de un video de rotación coloca el producto centralmente con más espacio superior; una versión cuadrada 1:1 ajusta el encuadre para máxima visibilidad del producto en un feed.

La edición de video tradicional maneja la multiplataforma recortando un archivo maestro 16:9. Un recorte central a 9:16 pierde los lados del cuadro. Un recorte a 1:1 pierde contexto. Con Seedance 2.0, cada relación se genera desde cero — el modelo compone la escena apropiadamente para cada forma. Una versión vertical 9:16 de una rotación de producto coloca el producto con más espacio vertical de respiración. Una versión cuadrada 1:1 ajusta el encuadre para máxima visibilidad del producto en un feed social. El producto siempre ocupa la proporción correcta del cuadro.

Ajustes de prompt específicos por plataforma

Aunque el mismo prompt base funciona entre relaciones, puede optimizar para el estilo de contenido de cada plataforma:

• Amazon/Shopify (16:9): Manténgalo limpio e informativo. Evite transiciones llamativas. Enfóquese en mostrar el producto claramente.
• Instagram Reels (9:16): El ritmo más rápido funciona. Agregue "dynamic" o "energetic" al prompt para más movimiento visual.
• TikTok (9:16): Aún más dinámico. "Quick cuts," "trend-style transitions," y "bold camera movements" coinciden con el lenguaje visual de TikTok.
• Feed de Facebook (1:1): El formato cuadrado necesita composición central fuerte. Describa el producto centralmente: "product centered in frame."
• Hero del sitio web (16:9): La sutileza gana. "Slow, hypnotic motion" y "seamless loop" son términos clave. Estos videos se reproducen automáticamente sin sonido, por lo que la calidad visual importa más que la narrativa.

Para documentación completa de parámetros de la API incluyendo todas las relaciones soportadas, consulte la documentación de la API de generación de video.

Pipeline por lotes: del catálogo CSV a la biblioteca de videos

Las llamadas individuales a la API funcionan para pruebas. El e-commerce en producción necesita un pipeline: leer un catálogo de productos, generar videos para cada SKU, manejar fallos y organizar la salida. Esta sección construye ese pipeline.

Comience con un archivo CSV que contenga su catálogo de productos:

name,image_url,category,style
Leather Bifold Wallet,https://cdn.example.com/wallet.jpg,accessories,rotation
Wireless Earbuds Pro,https://cdn.example.com/earbuds.jpg,electronics,hero
Ceramic Pour-Over Set,https://cdn.example.com/pourover.jpg,kitchen,lifestyle
Merino Wool Scarf,https://cdn.example.com/scarf.jpg,apparel,macro
Smart Fitness Watch,https://cdn.example.com/watch.jpg,electronics,unboxing

La columna style mapea a los cinco tipos de video cubiertos en esta guía. Aquí está el pipeline completo:

import csv
import os
import time
import requests
from pathlib import Path

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.evolink.ai/v1"
OUTPUT_DIR = Path("./product_videos")
OUTPUT_DIR.mkdir(exist_ok=True)

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# Prompt templates keyed by style
STYLE_PROMPTS = {
    "rotation": (
        "@Image1 is a {name}. The product rotates slowly on a clean surface "
        "under professional studio lighting. Smooth 360-degree turntable "
        "rotation. Commercial product showcase quality."
    ),
    "hero": (
        "@Image1 is a {name}. The product emerges dramatically from soft "
        "volumetric fog with a golden backlight. Particles drift upward. "
        "Cinematic slow reveal. Premium advertisement quality."
    ),
    "lifestyle": (
        "@Image1 is a {name}. The product is shown in a natural lifestyle "
        "setting, being used in an everyday context. Warm natural lighting. "
        "Shallow depth of field. Authentic lifestyle commercial."
    ),
    "macro": (
        "@Image1 is a {name}. Extreme macro close-up. The camera glides "
        "across the surface, revealing material texture and craftsmanship "
        "details. Shallow depth of field. Raking directional light. "
        "Luxury product detail shot."
    ),
    "unboxing": (
        "@Image1 is a {name} in retail packaging. Hands lift the lid to "
        "reveal the product inside. Tissue paper parts. The product is "
        "lifted out and displayed. Soft overhead lighting. Premium "
        "unboxing experience video."
    ),
}

STYLE_DEFAULTS = {
    "rotation":  {"duration": 8,  "aspect_ratio": "16:9"},
    "hero":      {"duration": 10, "aspect_ratio": "16:9"},
    "lifestyle": {"duration": 8,  "aspect_ratio": "9:16"},
    "macro":     {"duration": 8,  "aspect_ratio": "16:9"},
    "unboxing":  {"duration": 12, "aspect_ratio": "9:16"},
}


def submit_video_task(name: str, image_url: str, style: str) -> str:
    """Submit a single video generation task. Returns task_id."""
    prompt_template = STYLE_PROMPTS.get(style, STYLE_PROMPTS["rotation"])
    defaults = STYLE_DEFAULTS.get(style, STYLE_DEFAULTS["rotation"])

    payload = {
        "model": "seedance-2.0",
        "image_urls": [image_url],
        "prompt": prompt_template.format(name=name),
        "duration": defaults["duration"],
        "quality": "1080p",
        "aspect_ratio": defaults["aspect_ratio"],
    }

    resp = requests.post(
        f"{BASE_URL}/videos/generations", headers=headers, json=payload
    )
    resp.raise_for_status()
    return resp.json()["task_id"]


def poll_task(task_id: str, timeout: int = 300) -> dict:
    """Poll until task completes or fails."""
    elapsed = 0
    while elapsed < timeout:
        resp = requests.get(f"{BASE_URL}/tasks/{task_id}", headers=headers)
        resp.raise_for_status()
        task = resp.json()

        if task["status"] == "completed":
            return task
        elif task["status"] == "failed":
            raise RuntimeError(f"Task {task_id} failed: {task.get('error')}")

        time.sleep(5)
        elapsed += 5

    raise TimeoutError(f"Task {task_id} timed out after {timeout}s")


def download_video(url: str, filepath: Path):
    """Download a video file from a URL."""
    resp = requests.get(url, stream=True)
    resp.raise_for_status()
    with open(filepath, "wb") as f:
        for chunk in resp.iter_content(chunk_size=8192):
            f.write(chunk)
    print(f"💾 Saved: {filepath}")


def process_catalog(csv_path: str, max_retries: int = 2):
    """Process an entire product catalog CSV into videos."""
    # Phase 1: Submit all tasks
    pending = []
    with open(csv_path, "r") as f:
        reader = csv.DictReader(f)
        for row in reader:
            name = row["name"]
            image_url = row["image_url"]
            style = row.get("style", "rotation")

            for attempt in range(max_retries + 1):
                try:
                    task_id = submit_video_task(name, image_url, style)
                    pending.append({
                        "name": name,
                        "task_id": task_id,
                        "style": style,
                    })
                    print(f"🎬 Submitted: {name} ({style}) → {task_id}")
                    time.sleep(1)  # Rate limiting: 1 request per second
                    break
                except requests.exceptions.RequestException as e:
                    if attempt < max_retries:
                        print(f"⚠️  Retry {attempt + 1} for {name}: {e}")
                        time.sleep(3)
                    else:
                        print(f"❌ Failed to submit {name}: {e}")

    # Phase 2: Collect results
    results = []
    for item in pending:
        try:
            task = poll_task(item["task_id"])
            video_url = task["output"]["video_url"]

            # Generate safe filename
            safe_name = item["name"].lower().replace(" ", "-")
            filename = f"{safe_name}_{item['style']}.mp4"
            filepath = OUTPUT_DIR / filename

            download_video(video_url, filepath)
            results.append({
                "name": item["name"],
                "style": item["style"],
                "file": str(filepath),
                "status": "success"
            })
        except Exception as e:
            print(f"❌ Failed: {item['name']}: {e}")
            results.append({
                "name": item["name"],
                "style": item["style"],
                "file": None,
                "status": f"error: {e}"
            })

    # Summary
    success = sum(1 for r in results if r["status"] == "success")
    print(f"\n📊 Complete: {success}/{len(results)} videos generated")
    return results


# Run it
results = process_catalog("products.csv")

El pipeline opera en dos fases. La Fase 1 envía todas las tareas rápidamente (con limitación de velocidad), almacenando los IDs de tarea. La Fase 2 consulta cada tarea y descarga el resultado. Esto maximiza el paralelismo — todos los videos se generan simultáneamente del lado del servidor.

Uso de callbacks en lugar de polling

Para catálogos más grandes (más de 100 productos), el polling se vuelve ineficiente. Use el parámetro callback_url para recibir un webhook cuando cada video se complete. Consulte la documentación de la API para parámetros de callback para la especificación completa del payload del webhook.

payload = {
    "model": "seedance-2.0",
    "image_urls": ["https://your-cdn.com/products/item.jpg"],
    "prompt": "@Image1 is a product. Smooth rotation. Studio lighting.",
    "duration": 8,
    "quality": "1080p",
    "aspect_ratio": "16:9",
    "callback_url": "https://your-server.com/webhooks/video-ready"
}

Su endpoint de webhook recibe un POST con el objeto de tarea completado, incluyendo la URL del video. Esto elimina el polling por completo y le permite procesar resultados de forma asíncrona — descargar el video, actualizar su base de datos de productos y enviarlo a su CDN en un solo manejador de webhook.

Consejos para el pipeline

• Limitación de velocidad: Mantenga las solicitudes a 1 por segundo. Las ráfagas de envíos pueden activar el throttling.
• Expiración de URL del video: Descargue dentro de 24 horas. El pipeline anterior descarga inmediatamente, pero si usa callbacks, asegúrese de que su manejador de webhook descargue rápidamente.
• Lógica de reintentos: Los errores de red ocurren. El pipeline reintenta envíos fallidos hasta dos veces con un backoff de 3 segundos.
• Organice la salida: La convención de nombres {nombre-producto}_{estilo}.mp4 mantiene su biblioteca de video navegable. Agregue la relación de aspecto al nombre del archivo si genera múltiples relaciones por producto.
• Idempotencia: Rastree qué productos ya tienen videos. Antes de enviar una tarea, verifique si el archivo de salida ya existe. Esto previene la generación duplicada al re-ejecutar el pipeline después de fallos parciales.
• Monitoreo de costos: Registre el número de videos generados por ejecución. A unos centavos por video, los costos se mantienen bajos, pero bucles descontrolados o CSVs mal configurados pueden enviar miles de solicitudes involuntariamente. Agregue un prompt de confirmación o un flag --dry-run.

Escalando más allá de lo básico

Para catálogos de más de 1,000 SKUs, considere estas mejoras:

Polling concurrente. El pipeline anterior consulta las tareas secuencialmente. Use concurrent.futures.ThreadPoolExecutor de Python para consultar múltiples tareas en paralelo, reduciendo el tiempo total transcurrido.

Seguimiento en base de datos. Reemplace la lista results en memoria con una base de datos SQLite o un archivo JSON simple que persista entre ejecuciones. Rastree IDs de tarea, estado de completación, rutas de archivos de salida y marcas de tiempo. Esto hace el pipeline reanudable después de interrupciones.

Carga a CDN. Después de descargar, cargue automáticamente a su CDN (S3, CloudFront, Cloudflare R2) y almacene la URL pública. Esto elimina el paso manual de transferir archivos a su infraestructura de hosting.

Generación de metadatos. Genere un manifiesto JSON junto con los videos, conteniendo nombre del producto, tipo de video, relación de aspecto, duración y URL del CDN. Este manifiesto alimenta directamente su CMS o sistema de gestión de información de producto (PIM) para actualizaciones automatizadas de listados.

Biblioteca de plantillas de prompts para e-commerce

Prompts listos para copiar y pegar para las categorías de producto de e-commerce más comunes. Cada plantilla está diseñada para el tipo de producto especificado y puede usarse directamente con cualquier foto de producto de esa categoría. Intercambie el nombre del producto en el placeholder {name}.

ECOMMERCE_PROMPTS = {
    "jewelry": {
        "prompt": (
            "@Image1 is {name}. Extreme close-up on a black velvet surface. "
            "The piece rotates slowly under pinpoint spotlights. Light refracts "
            "through gemstones, casting prismatic reflections. Shallow depth of "
            "field. The camera pulls back to reveal the full piece. Luxury "
            "jewelry advertisement quality."
        ),
        "duration": 10,
        "aspect_ratio": "1:1",
    },
    "electronics": {
        "prompt": (
            "@Image1 is {name}. The device sits on a minimal desk setup. "
            "Screen illuminates, casting a soft glow. Camera orbits slowly, "
            "showing ports, buttons, and build quality from every angle. "
            "Clean, modern aesthetic. Tech product showcase."
        ),
        "duration": 10,
        "aspect_ratio": "16:9",
    },
    "apparel": {
        "prompt": (
            "@Image1 is {name}. The garment is displayed on an invisible "
            "mannequin form, rotating slowly. Fabric moves naturally with "
            "gentle airflow, showing drape and texture. Soft diffused "
            "studio lighting. Clean white background. Fashion e-commerce "
            "product video."
        ),
        "duration": 8,
        "aspect_ratio": "9:16",
    },
    "food_beverage": {
        "prompt": (
            "@Image1 is {name}. Steam rises gently. Camera pushes in slowly "
            "from a wide tabletop shot to an appetizing close-up. Warm, "
            "golden-hour lighting. Shallow depth of field. Ingredients or "
            "garnishes are visible in beautiful detail. Food photography "
            "in motion."
        ),
        "duration": 8,
        "aspect_ratio": "1:1",
    },
    "furniture": {
        "prompt": (
            "@Image1 is {name}. Placed in a styled modern living room with "
            "natural light streaming through large windows. Camera dollies "
            "slowly around the piece, showing form and proportion in context. "
            "Warm afternoon light. Interior design showcase quality."
        ),
        "duration": 10,
        "aspect_ratio": "16:9",
    },
    "cosmetics": {
        "prompt": (
            "@Image1 is {name}. The product sits on a marble surface with "
            "soft pink and gold tones. A gentle pour or squeeze dispenses "
            "the product, showing color and texture. Macro close-up of the "
            "formula. Smooth, luxurious pacing. Beauty brand advertisement."
        ),
        "duration": 8,
        "aspect_ratio": "9:16",
    },
    "sports_gear": {
        "prompt": (
            "@Image1 is {name}. Dynamic presentation against a dark "
            "background with dramatic side lighting. The product rotates "
            "with energy — quick cuts between angles showing key features. "
            "Subtle motion graphics energy. Athletic brand commercial style."
        ),
        "duration": 8,
        "aspect_ratio": "16:9",
    },
    "home_decor": {
        "prompt": (
            "@Image1 is {name}. Displayed in a curated shelf vignette with "
            "complementary objects. Soft natural light. Camera slowly racks "
            "focus from background to the product. Cozy, aspirational "
            "interior styling. Lifestyle brand aesthetic."
        ),
        "duration": 8,
        "aspect_ratio": "1:1",
    },
}


def generate_from_template(category: str, name: str, image_url: str) -> dict:
    """Generate a video using a category-specific prompt template."""
    template = ECOMMERCE_PROMPTS[category]
    payload = {
        "model": "seedance-2.0",
        "image_urls": [image_url],
        "prompt": template["prompt"].format(name=name),
        "duration": template["duration"],
        "quality": "1080p",
        "aspect_ratio": template["aspect_ratio"],
    }
    return create_and_wait(payload)


# Example usage
result = generate_from_template(
    category="jewelry",
    name="18K gold pendant necklace with emerald",
    image_url="https://your-cdn.com/products/emerald-pendant.jpg"
)

Estas plantillas son puntos de partida. Ajuste las descripciones de iluminación y los movimientos de cámara para que coincidan con la identidad visual de su marca. La guía completa de prompts cubre técnicas avanzadas para ajustar la salida de Seedance 2.0.

Personalización de plantillas para su marca

Cada marca tiene un lenguaje visual. Apple usa entornos blancos limpios con movimientos de cámara precisos y lentos. Nike usa iluminación dinámica de alto contraste con cortes rápidos. Sus videos de producto deben reflejar la estética establecida de su marca.

Modifique las plantillas a lo largo de estos ejes:

• Tono de iluminación: Cálido (dorado, ámbar) para marcas artesanales/de lujo. Frío (azul, plateado) para tecnología. Neutro (blanco, suave) para marcas minimalistas.
• Velocidad de cámara: Movimientos lentos y deliberados para posicionamiento premium. Movimientos más rápidos y dinámicos para marcas juveniles o deportivas.
• Fondo: Los fondos oscuros señalan lujo. Los fondos blancos señalan limpio/moderno. Los fondos ambientales señalan estilo de vida.
• Vocabulario de ritmo: "Slow, measured" vs. "dynamic, energetic" vs. "calm, meditative" — estas palabras influyen directamente en el tempo de salida del modelo.

Construya el prefijo de prompt maestro de su marca — un conjunto de términos que se anteponen a cada prompt de video de producto — y aplíquelo consistentemente en todo su catálogo. Esto crea coherencia visual entre cientos de videos de producto, imitando la consistencia que obtendría de una única configuración de estudio.

Preguntas frecuentes

¿Cuánto cuesta generar un video de producto?

El precio depende de la duración y la configuración de calidad. Un video estándar de 8 segundos a calidad 1080p cuesta unos centavos. Generar 500 videos de producto para un catálogo completo queda muy por debajo de $100 en la mayoría de las configuraciones. Consulte los precios de EvoLink para las tarifas actuales. Comparado con los $500–$2,000 por video que cobran los estudios, el costo de la API es efectivamente insignificante a cualquier escala.

¿Puedo usar fotos de modelos humanos reales como entrada?

Seedance 2.0 tiene restricciones en la generación de rostros humanos realistas para prevenir el uso indebido de deepfakes. Las fotos solo de productos funcionan sin limitaciones. Si su producto necesita mostrarse con una persona — ropa en un modelo, un reloj en una muñeca — use referencias humanas ilustradas o estilizadas en lugar de retratos fotorrealistas. Alternativamente, describa el elemento humano en el prompt (por ejemplo, "a hand reaches into frame") y deje que el modelo lo genere en lugar de proporcionar una foto de rostro como entrada.

¿Cuánto tiempo toma la generación de video?

El tiempo típico de generación es de 60 a 180 segundos dependiendo de la duración y la configuración de calidad. Un video de 5 segundos a 720p se completa en aproximadamente un minuto. Un video de 15 segundos a 1080p puede tomar hasta tres minutos. El pipeline por lotes en esta guía maneja el tiempo automáticamente a través del polling. Para sistemas de producción, use el parámetro callback_url para recibir un webhook al completarse en lugar de hacer polling.

¿Puedo agregar logos de marca o superposiciones de texto?

Dos enfoques funcionan. Primero, incluya descripciones de texto en su prompt — "Brand name fades in at the end" o "Logo watermark in lower right corner." El modelo puede generar elementos similares a texto, aunque la tipografía precisa no está garantizada. Segundo, y más confiablemente, genere el video sin texto y componga su logo, títulos o tercios inferiores en posproducción usando FFmpeg, After Effects o su herramienta de edición de video preferida. El segundo enfoque le da control exacto sobre los activos de marca.

¿La calidad del video es suficiente para uso comercial?

A calidad 1080p, la salida es adecuada para listados de productos, anuncios en redes sociales y secciones hero de sitios web. La calidad visual iguala o supera lo que la mayoría de los equipos de e-commerce producen con configuraciones de estudio básicas. Para campañas de marca de alta gama o televisión, es posible que desee usar el video generado por IA como previsualizacion o punto de partida, luego refinar con posproducción tradicional. Para la gran mayoría de los casos de uso de e-commerce — Amazon, Shopify, anuncios sociales, campañas de email — la salida está lista para producción.

¿Qué formato de imagen y resolución funciona mejor para la entrada?

JPEG y PNG funcionan ambos. PNG con transparencia es ideal para productos que necesitan reemplazo limpio de fondo. Para resolución, proporcione la imagen fuente de la mayor calidad disponible — al menos 1024x1024 píxeles. El modelo extrae más detalle de entradas de mayor resolución, lo cual es especialmente notable en videos de primer plano macro y rotación. Evite JPEGs fuertemente comprimidos con artefactos visibles, ya que estos se trasladan al video generado.

¿Puedo generar videos con audio o música?

Seedance 2.0 soporta el parámetro generate_audio, que agrega efectos de sonido contextuales al video. Para videos de producto, sonidos ambientales de estudio o swooshes sutiles pueden mejorar la sensación premium. Sin embargo, la mayoría de las plataformas de e-commerce reproducen video sin sonido, por lo que la calidad visual importa mucho más. Si necesita música específica o voz en off, agréguelos en posproducción. La API también soporta audio_urls para generación guiada por audio — consulte la documentación de referencia multimodal para más detalles.

¿Cómo integro esto con Shopify o Amazon?

El flujo de trabajo es: generar video → descargar MP4 → subir a su plataforma. Para Shopify, suba videos directamente a los medios de producto a través del admin o la API de Shopify. Para Amazon, suba a través de la sección "Manage Videos" de Seller Central o mediante la SP-API. Para automatizar el ciclo completo, use el pipeline por lotes con callback_url — su manejador de webhook puede descargar el video y enviarlo a la API de su plataforma automáticamente. La documentación de referencia multimodal cubre el formato completo de respuesta de la API para construir integraciones.

Del estudio a la API: su nuevo pipeline de video

Cinco tipos de video cubren el espectro completo de video de producto para e-commerce: rotaciones 360° para páginas de producto, tomas heroicas para lanzamientos, contexto de estilo de vida para conexión emocional, primeros planos macro para percepción de calidad, y revelaciones de unboxing para contenido social. Cada tipo requiere una foto de producto y una llamada a la API.

El pipeline por lotes convierte un catálogo CSV en una biblioteca de video completa. La exportación multiplataforma genera cada relación de aspecto que sus canales necesitan en un solo paso. La biblioteca de plantillas de prompts le da puntos de partida listos para copiar y pegar para cualquier categoría de producto.

El flujo de trabajo completo — desde la foto de producto hasta el video publicado en cada canal de ventas — se comprime de semanas a horas. Un solo desarrollador puede operar un pipeline de video que anteriormente requería un equipo de producción, un estudio y un editor de posproducción.

Esta no es una mejora incremental sobre la producción de video tradicional. Es un cambio estructural. El cuello de botella en el video de e-commerce nunca fue la visión creativa — fue el costo y la logística. Cuando un solo video cuesta centavos y toma dos minutos, la pregunta cambia de "¿qué productos merecen video?" a "¿por qué no tiene video cada producto?"

Comience con un producto. Genere un video de rotación. Vea el resultado en tres minutos. Luego escale a su catálogo completo. La API es la misma ya sea que esté generando un video o diez mil.

Reemplace su pipeline de producción de video. Regístrese gratis en EvoLink →

Anteriormente en esta serie: Guía de prompts de Seedance 2.0 · Guía de @Tags multimodal · Guía de movimientos de cámara · Tutorial de imagen a video