crear-video-seedance-2-fal
⚠️ VERIFICACIÓN PREVIA OBLIGATORIA (2026-06-04): cada prompt de Seedance que mencione un producto de marca DEBE ir acompañado de una imagen de referencia real de ese producto exacto como una de las entradas
--image-ref. La descripción del producto solo con texto sin una referencia invita a Seedance a inventar una geometría que no coincide con el SKU real. Si no existe una referencia localmente, búscala a través de brand-assets → existing-ads → PDP harvest → promuévela aclients/<brand>/brand-assets/reference-photos/. Opcionalmente, limpia una referencia ocluida con un pase rápido de GPT-image-2. Siempre obtén la revisión del usuario de la referencia y el prompt final antes de realizar la llamada paga. Consultafeedback_product_reference_required.md.
Propósito
Envuelve el endpoint de FAL bytedance/seedance-2.0/reference-to-video. Pasa de 1 a N imágenes de referencia (típicamente: retrato + producto + escenario opcional) + un prompt estructurado → obtén un clip de 4 a 15 segundos con voz en off sincronizada con los labios de forma nativa y audio ambiental.
Seedance 2.0 renderiza múltiples cortes internos dentro de una sola llamada de 15 segundos cuando el prompt especifica una estructura de sub-escenas (por ejemplo, WIDE HOOK / PRODUCT HERO / SIDESTEP / REACTION). Esta es la ventaja arquitectónica sobre el enfoque anterior de NB2 + i2v con múltiples fotogramas clave: menos llamadas, sincronización labial nativa, sin necesidad de Soul ID.
Usa este átomo cuando:
- El clip necesita un avatar parlante que revise o demuestre un producto.
- Se requiere diálogo sincronizado con los labios de forma nativa (configura
--generate-audio). - La identidad debe mantenerse mediante referencia de imagen, no de video (consulta la Regla de Decisión 1).
- La duración es de 4 a 15 segundos, en formato vertical 9:16 (u otras relaciones de aspecto).
- Se necesita condicionamiento con múltiples imágenes (rostro + producto, o rostro + múltiples productos para una escena de gancho).
NO lo uses para:
- Clips de más de 15 segundos → divídelos en varias llamadas y únelos (
assembly/stitch-videos-ffmpeg). - Movimientos de cámara puramente cinematográficos sin una persona en pantalla →
create-video-veo3suele ser mejor. - B-roll de solo producto sin persona →
create-product-videos-higgsfield-mso texto a video Seedance. - Clips que necesitan referencia de video para continuidad desde una escena generada por IA previa → no compatible (content_policy_violation).
Entradas
Obligatorias:
--prompt— bloque estructurado de prompt (ver "Plantilla de prompt" más abajo). Largo, de múltiples bloques. Ejemplo de ejecución de referencia:beauty-by-earth/video-01-three-product-grwm/working/fire_seedance_facewash.py.--output— destino local del MP4.--image-url(alias--image-ref) — al menos una URL de imagen de referencia PÚBLICA (repetible), pasada comoimage_urls. El orden importa: la primera =@Image1en la dirección del prompt. El proxy NO sube archivos locales: aloja las referencias locales a través de MCPget_upload_url→get_download_urly pasa la URL (idéntico acreate-video-fal).
Opcionales:
--resolution—480p|720p|1080p(por defecto). 1080p mejora significativamente la fidelidad de las etiquetas del producto.--duration—4–15segundos (por defecto15). Se pasa como un int (enum deseedance-2.0/reference-to-video{auto,4..15}); una cadena "400s" resulta eninvalid_request(validado el 2026-07-18).--aspect-ratio—9:16(por defecto),16:9,1:1, etc.--generate-audio— booleano, verdadero por defecto. Establécelo como falso para B-roll silencioso donde la VO se añade después.--seed— entero para re-ejecuciones deterministas (FAL devuelve una semilla; pásala de nuevo para reproducir).
Credenciales:
- No se necesita clave de FAL. Se enruta a través del proxy FAL de GooseWorks (
media_proxy.py, incluido) y factura al agente de Ads, usando~/.gooseworks/credentials.json(escrito por la CLIgooseworks). Tu tokencal_/de agente no es una clave de FAL — la antigua ruta de clave directa devolvía 401; por eso esta capacidad se redirigió a través del proxy.
Reglas de Decisión
0. Prefiere llamadas MÁS LARGAS y MENOS FRECUENTES con varias escenas internas en lugar de muchas llamadas cortas. Cada nueva llamada de Seedance desvía ligeramente el personaje, el vestuario, la iluminación y el fondo, incluso con la misma referencia de retrato. 5 llamadas cortas = 5 puntos de desviación que el espectador registra como rupturas de continuidad. Usa la plantilla probada de múltiples escenas DENTRO de una sola llamada de 10 a 15 segundos para obtener cortes internos con sensación natural a partir de un solo render:
ESCENA 1 (0-3s) — GANCHO AMPLIO [encuadre + acción + diálogo]
ESCENA 2 (3-7s) — PRODUCTO HERO [encuadre + movimiento de cámara + diálogo]
ESCENA 3 (7-11s) — PASO LATERAL / PRUEBA [encuadre + acción + diálogo]
ESCENA 4 (11-15s) — REACCIÓN + CTA [encuadre + acción + diálogo]
El ESCENARIO PUEDE variar entre sub-escenas internas dentro de una sola llamada de Seedance. La identidad del personaje está fijada por la imagen de referencia del retrato, no por el escenario. Una referencia validada (ref-01 Bristle UGC, 26s) muestra al mismo creador en más de 5 entornos/habitaciones diferentes dentro de un único render con múltiples escenas. No dividas artificialmente en varias llamadas solo para cambiar de habitación: incorpora los cambios de escenario DENTRO de la estructura de sub-escena ESCENA N (X-Ys) de una sola llamada. Distribuye las llamadas según el ARCO DE LA HISTORIA y el límite máximo de 15 segundos, no según la cantidad de escenarios. Consulta prompt-example.md para la plantilla validada. Memoria: feedback_seedance_long_calls_not_short.md.
0a. El VESTUARIO debe especificarse COMPLETAMENTE: parte superior + inferior + cabello + accesorios. Validado el 2026-05-23 (Bristle): si solo se especifica la parte superior ("sudadera crema"), Seedance alucina la parte inferior (aparecieron pantalones cortos de mezclilla de la nada). Cada prompt debe fijar todo:
- Parte superior (con negaciones)
- Parte inferior (con negaciones) — "pantalones cortos con dobladillo de mezclilla claro, hasta el muslo, NO vaqueros, NO pantalones cortos de pijama"
- Cabello (peinado específico — "cola de caballo baja y suelta en la nuca con mechones que enmarcan el rostro" funciona mejor que un vago "moño")
- Accesorios (por ejemplo, "aros delgados de oro, nada más")
Para UGC de confesionario / sesión única, el vestuario debe ser IDÉNTICO en todas las llamadas del mismo anuncio (preferencia de usuario validada + patrones ref-01 + ad-03). Varía el vestuario entre llamadas SOLO para formatos GRWM / transformación / de varios días. Memoria: feedback_seedance_long_calls_not_short.md.
0b. PASA UNA IMAGEN DE REFERENCIA DE FONDO como image_urls[2] para escenarios fijos. Validado el 2026-05-23 (Bristle). La descripción del escenario solo con texto produce una estética genérica de alquiler: Seedance la llena con su propio modelo de habitación. Una imagen hero de fondo (generada a través de NB2 Pro en fal-ai/nano-banana-pro, $0.15/1K, texto a imagen con directivas "sin bokeh, enfoque infinito, sin personas, sin rostros") FIJA la habitación en todas las sub-escenas. Usa la MISMA imagen de fondo en todas las llamadas del mismo anuncio: una imagen de fondo diferente por llamada se percibe como "ella se mudó". Memoria: feedback_seedance_long_calls_not_short.md.
0c. LIMPIA PREVIAMENTE LAS IMÁGENES DE REFERENCIA DEL PRODUCTO a través de la edición NB2 si contienen accesorios. Validado el 2026-05-23 (Bristle hi_res-12 tenía viales + embudo junto a la caja; Seedance los fusionó en la cara de la caja). Inspecciona las imágenes de origen del producto en la entrada. Si hay accesorios / productos secundarios / insignias de puntuación / elementos de estilo de vida visibles, enrútalos a través de fal-ai/nano-banana-2/edit ($0.08) para aislar el producto hero antes de pasarlo a Seedance. Es más barato que repetir un render de Seedance de $4.50-$10.20. Memoria: feedback_nb2_clean_product_refs.md.
0d. CONTINUIDAD DE LLAMADAS SECUENCIALES: reutiliza la semilla, NO video_urls. Validado el 2026-05-23 (prueba A/B de variante Bristle). Para la llamada N>1 en un anuncio de varias llamadas, pasa la seed de la llamada anterior (a través de --seed) con las mismas image_urls. NUNCA pases el mp4 de la llamada anterior como video_urls para continuidad secuencial: PERJUDICA la continuidad (el modelo intenta "continuar" el video anterior; el vestuario/producto se desvían más de lo que lo harían de otra manera). video_urls es SOLO para transferencia de estilo desde un video de referencia HUMANO REAL (por ejemplo, tomar un anuncio UGC de un creador real y recrearlo con un creador IA). Memoria: feedback_seedance_video_urls_vs_seed.md.
0e. CUANDO USES video_urls (transferencia de estilo desde una referencia real): establece el tiempo de espera del cliente en 30+ minutos Y recorta la referencia a ≤15 segundos. Validado el 2026-05-23:
- Tiempo de render: ~18-20 min (frente a ~10 min solo con imagen). El tiempo de espera predeterminado de
fal_client.subscribe()de 10 minutos fallará. Usafal_client.submit()+ sondeo manual. - Límite de duración combinada de
video_urls: 15 segundos. FAL rechaza coninput_value_error: Combined video duration must not exceed 15.0s. Recorta los videos de referencia con ffmpeg-t 15antes de subirlos. - Límite de archivos combinados: 50 MB en total. El límite de
fal_helpers.upload_file()se aumentó de 10 MB a 50 MB el 2026-05-23. - Detecta errores de validación (
input_value_error/ "must not exceed") en las excepciones de sondeo y abandona después de 1-2 reintentos: los errores terminales no aparecen a través destatus=Failed. - La referencia de video transfiere MÁS que estilo/ritmo: transfiere estilo de vestuario, accesorios y cabello en un grado no trivial (validado el 2026-05-23 Recreación Probiotic: el cabello cambió para coincidir con la referencia; aparecieron tabletas a pesar de una imagen de producto limpia). Las anulaciones del lado del texto son PARCIALMENTE efectivas; elige una referencia cuyos elementos visuales ya estén alineados con tu objetivo.
- FAL SÍ acepta video generado por IA como entrada (la antigua suposición "content_policy_violation instantánea" de BBE de principios de 2026 está desactualizada). Memoria:
feedback_seedance_video_urls_vs_seed.md.
1. NUNCA pases video generado por IA como video_urls. El validador de política de contenido de FAL rechaza esto con partner_validation_failed. El descuento del 60% en entrada de video es real, pero solo se aplica a video de referencia HUMANO REAL. Para la continuidad del avatar IA en múltiples escenas, usa el mismo retrato de identidad como image_urls en cada escena. Validado en BBE.
2. Rechazo NSFW → DETENTE y notifica, no reintentes automáticamente. Aplicación corporal + mujer + agua/espuma activa el clasificador de manera confiable. Si FAL devuelve content_policy_violation o status: failed con motivo nsfw, NO reintentes el mismo prompt. Notifícalo a la persona que llama con 3 opciones: reescribe el ritmo de aplicación como prueba de olfato/puntas de dedos, reencuadra como POV (sin rostro), o salta la escena. Sigue la política de moderación de todo el proyecto (consulta la memoria feedback_hf_moderation_surface.md).
3. duration como un INT. Pasa 15, no "15". seedance-2.0/reference-to-video rechaza una duración de cadena con invalid_request (validado el 2026-07-18; la antigua nota de "solo cadena" era para el endpoint i2v v1 obsoleto).
4. Un solo producto por llamada (excepto para el gancho). Las escenas hero con múltiples productos dentro de una sola llamada de Seedance degradan la fidelidad de la etiqueta. La excepción es la escena de gancho/introducción donde todos los productos aparecen juntos pero ninguna etiqueta individual es hero.
5. 1080p para calidad hero. La textura de la piel y la nitidez de la etiqueta del producto escalan notablemente con la resolución. Usa 720p solo para llamadas de presupuesto/sonda.
Flujo de trabajo
python3 scripts/generate.py \
--prompt "$(cat prompt-scene-1.txt)" \
--output /path/to/scene-1.mp4 \
--image-url "https://<hosted>/portrait.png" \
--image-url "https://<hosted>/product.png" \
--resolution 1080p \
--duration 15 \
--aspect-ratio 9:16 \
--generate-audio
El script:
- Se enruta a través de
media_proxy.pyincluido (proxy FAL de GooseWorks) — no necesita clave de FAL; factura al agente de Ads a través de~/.gooseworks/credentials.json. - Pasa los valores de
--image-urldirectamente comoimage_urls(ya deben ser URL PÚBLICAS; el orquestador aloja referencias locales a través de MCP). - Envía
bytedance/seedance-2.0/reference-to-videoa través del proxy y sondea hasta completarse con:{ "prompt": <prompt>, "image_urls": [<refs>], "resolution": <res>, "duration": <dur>, # int "aspect_ratio": <ar>, "generate_audio": <bool>, "seed": <optional int>, } - Descarga el MP4 resultante en
--output. - Escribe
<output>.meta.jsoncon prompt, referencias, URL del video, semilla, duración, estimación de costo. - En caso de
content_policy_violationo fallo NSFW: notifica el error y termina con código de salida distinto de cero (sin reintento silencioso).
Salida
<output>— clip MP4 con la duración, resolución y relación de aspecto solicitadas.<output>.meta.json— metadatos de la solicitud + resultado + semilla para reproducibilidad + estimación de costo.
Precios (2026-05)
| Resolución | Duración | Costo por llamada |
|---|---|---|
| 720p estándar | 15s | ~$4.54 |
| 1080p estándar | 15s | ~$10.20 |
| 1080p estándar | 8s | ~$5.44 |
| 1080p estándar | 4s | ~$2.72 |
La capa rápida es ~20% más barata, pero tiene un límite de 720p.
Plantilla de prompt
El prompt es la palanca de calidad más importante. Usa la estructura de plantilla probada de BBE:
📱 REEL DE RESEÑA DE [PRODUCTO] DE INFLUENCER UGC (ESTILO SELFIE, NO UN COMERCIAL)
[BLOQUE 0 — apertura anti-patrón]
Esto NO es un comercial cinematográfico, NO es un anuncio de [categoría], NO es una campaña editorial.
Este es un Reel real de Instagram filmado por un creador de [demografía] de unos 20 años con
su cámara frontal, hablando directamente a sus seguidores en un tono relajado y confidencial...
[ASIGNACIONES DE REFERENCIA DE IMAGEN]
Usa @Image1 como la cara/identidad del influencer. Usa @Image2 como el [producto] exacto
que está reseñando: es una [DESCRIPCIÓN VISUAL]. NO es [confusión común].
El producto y la etiqueta DEBEN ser claramente identificables.
[BLOQUE DE FORMATO]
- Estética selfie vertical 9:16 tomada con teléfono, ligero micro-movimiento de mano
- VESTUARIO (ESTRICTO): [vestuario]. ABSOLUTAMENTE NO [lista de negaciones].
- Escenario: [escenario]
- Iluminación: [iluminación]
- Piel real, ligeramente imperfecta (maquillaje natural casi inexistente), bronceado dorado claro
[BLOQUE DE IDENTIDAD]
La misma joven que en @Image1 — [rango de edad, cabello, ojos, tono de piel]
[BLOQUE DE ENCUADRE DINÁMICO]
El video debe variar su encuadre a través de las escenas como un Reel real — NO te quedes
en una sola distancia focal todo el tiempo. Combina tomas amplias / medias / primeros planos.
[ESCENA 1 (0-3s)] GANCHO AMPLIO — [línea de guion] + [emoción + acción]
[ESCENA 2 (3-7s)] PRODUCTO HERO con rotación — [línea de guion] + [emoción + acción]
[ESCENA 3 (7-11s)] PASO LATERAL aplicación o prueba de olfato — [línea de guion] + [emoción + acción]
[ESCENA 4 (11-15s)] REACCIÓN + recomendación — [línea de guion] + [emoción + acción]
[DIRECCIÓN DE AUDIO]
[Carácter de voz: tono, acento, ritmo según DELIVERY_STYLES.md]
SIN música en el audio (agregamos música en postproducción).
[REGLAS GLOBALES]
- Vestuario idéntico en toda la escena
- El producto permanece idéntico y claramente visible en su mano
- Los labios permanecen CERRADOS entre ritmos de diálogo
- [Negaciones de evasión NSFW si corresponde]
[REGLAS DE REALISMO ESTRICTO — Bloque F]
- Pequeñas imperfecciones naturales, vello sutil, líneas finas tenues
- NO plástico, NO retocado, NO parecido a muñeca, NO porcelana
- Reflejos en la piel SOLO en la punta de la nariz, pómulos, arco de cupido
- Cabello: pelusas individuales
…