HiAPI Seedance 2.0 UGC Ad Video

¿Qué hace HiAPI Seedance 2.0 UGC Ad Video?

Crea anuncios de productos verticales que parezcan genuinamente grabados por un creador, manteniendo cada afirmación del producto, imagen y resultado auditables.

Reutiliza la implementación instalada hiapi-seedance-2-0-video para la validación de payload, envío de tareas, polling y descarga. No reescribas el transporte de HiAPI. Este skill añade las capas de investigación UGC, guionización, activos de referencia, variantes de campaña y QC.

Puertas de control estrictas

• Usa la imagen de una persona real solo cuando el usuario la haya proporcionado o haya identificado un activo aprobado y haya confirmado el permiso para usar esa imagen. No imites a celebridades, figuras públicas, clientes o creadores como endorsers.
• Etiqueta a un actor generado como sintético en el brief. No presentes una actuación sintética como un testimonio no guionado de un cliente.
• Fundamenta beneficios, especificaciones, precios, descuentos, comparaciones y resultados en los materiales del usuario o en fuentes primarias actuales. No inventes reseñas, historial de uso, resultados antes/después, escasez o experiencia personal.
• Trata las categorías reguladas (salud, médicos, suplementos, pérdida de peso, finanzas, alcohol, juegos de azar, etc.) como sujetas a revisión. Verifica las reglas oficiales actuales de la plataforma y la jurisdicción antes de producir el texto final del anuncio.
• No coloques texto, etiquetas, precios o insignias no verificados dentro del video generado. Añade subtítulos y texto de oferta solo en postproducción después de verificar el audio hablado.
• No publiques, programes ni subas públicamente a menos que el usuario lo solicite explícitamente como una acción separada.
• No generes en 4k ni uses almacenamiento persistente de pago sin confirmación explícita de costos.

Valores por defecto

Úsalos cuando la solicitud no los especifique:

• Plataformas: TikTok e Instagram Reels
• Relación de aspecto: 9:16
• Duración: 10 segundos
• Resolución: 720p para un borrador; usa 1080p cuando el usuario solicite calidad de entrega
• Audio: diálogo nativo Seedance activado
• Estructura: un plano continuo handheld con cuatro micro-beats
• Idioma: coincidir con el usuario o el mercado objetivo que nombre
• Almacenamiento: salida temporal, descargada localmente
• Lote: tres variantes creativas independientes en lugar de una generación sobrecargada con múltiples cortes

Mantén cada tarea Seedance entre 4 y 15 segundos. Para un anuncio de 20–30 segundos, planifica dos o tres clips independientemente válidos y ensámblalos solo después de que cada clip pase el QC.

Flujo de trabajo

1. Construir un brief de producto fundamentado

Recopila o infiere solo opciones creativas seguras:

• nombre del producto, categoría, URL e imágenes claras del producto
• comprador objetivo, problema, diferenciador, oferta y CTA
• libro de reclamaciones respaldadas por fuentes y reclamaciones prohibidas
• plataforma, mercado objetivo, idioma, duración y tamaño del lote
• formato: unboxing-reveal, first-use-demo, direct-to-camera-demo, problem-solution, try-on o creator-comparison
• fuente de talento: user-provided, hired-creator o synthetic-generic
• imagen del actor aprobado, imagen del producto, placa de primer fotograma o medios de referencia

Investiga una URL de producto proporcionada cuando la página visible no contenga suficiente información. Prefiere la página oficial del producto, el manual del producto, el listado de un comerciante verificado y las políticas oficiales actuales. Separa los hechos obtenidos de la puesta en escena creativa.

Copia assets/ugc-brief.example.json en el espacio de trabajo de la tarea y reemplaza los valores de ejemplo. Mantén la línea hablada exacta tanto en creative.script como en creative.seedance_prompt.

Ejecuta:

node scripts/validate-ugc-brief.mjs /ruta/absoluta/hacia/ugc-brief.json

Corrige cada error antes de la generación. Trata las advertencias como elementos de revisión explícitos.

2. Elegir un ángulo creativo

Lee references/ugc-playbook.md al seleccionar formatos, tiempos de beat, señales de autenticidad, variantes de lote o adaptaciones de plataforma.

Elige una promesa por anuncio. Prefiere una acción visible del producto sobre adjetivos:

• desempaquetar un paquete
• aplicar o usar el producto una vez
• mostrar un control o característica
• comparar un estado antes/después solo cuando exista evidencia real
• nombrar un beneficio y una CTA

Usa un gancho hablado, no texto superpuesto generado. Guarda el gancho opcional de superposición corta y los subtítulos para la postproducción.

Para un lote de campaña, varía una dimensión a la vez:

• Gancho A: reconocimiento del problema
• Gancho B: descubrimiento inesperado
• Gancho C: revelación visual centrada en el producto

Mantén los datos del producto, la oferta, los derechos del talento y la CTA consistentes en todo el lote.

3. Escribir para lenguaje natural

Escribe contracciones, pausas, autocorrecciones y palabras simples que se ajusten al mercado objetivo. Evita la cadencia pulida de copy de marca.

Usa estos presupuestos de habla:

• Inglés: apunta a aproximadamente 2.0–2.8 palabras por segundo
• Chino: apunta a aproximadamente 3.5–5.0 caracteres hablados por segundo

Construye un anuncio de 10 segundos con este mapa de beats por defecto:

1. 0.0–1.5s — gancho hablado o visual; producto ya visible
2. 1.5–4.0s — desempaquetar, aplicar, usar o acercar el producto
3. 4.0–8.0s — demostrar una característica fundamentada o resultado visible
4. 8.0–10.0s — reacción natural y una CTA

No afirmes "he usado esto durante semanas", "esto curó", "a todos les encanta" o lenguaje equivalente de experiencia/resultado a menos que el libro de reclamaciones lo respalde y el talento esté autorizado a decirlo.

4. Elegir el modo de medios Seedance

Usa exactamente un modo:

1. Placa first-frame — mejor control. Usa una imagen verificada en 9:16 que ya muestre el talento aprobado con el producto exacto. Pásala como production.first_frame_url o production.first_frame_path.
2. Referencias multimodales — usa imágenes separadas del actor y del producto aprobados. Colócalas en production.reference_image_urls o production.reference_image_paths.
3. Solo texto — úsalo solo para borradores conceptuales genéricos. Advierte que la fidelidad del producto, empaque y talento será menor.

No mezcles entradas de primer/último fotograma con referencias multimodales. Mantén estable la identidad del actor, la geometría del producto, los colores del empaque, la orientación de la tapa, la ubicación de la etiqueta y el vestuario aprobado.

Si primero se debe crear una placa hero, usa un skill de edición de imágenes disponible con las referencias del actor y del producto, luego inspecciona visualmente la imagen en resolución nativa antes de llamar a Seedance. No aceptes una placa con empaque mutado, texto fabricado, dedos extra o una cara alterada.

5. Dirigir la actuación

Haz que el prompt Seedance incluya:

• duración exacta, 9:16 y topología de un solo plano o clip
• diálogo aprobado exacto entre comillas
• posición inicial del producto y una acción física dominante por beat
• línea de mirada relajada, gestos pequeños con las manos, parpadeos naturales, respiración y micropausas
• sensación de teléfono en mano, leve respiración de enfoque/exposición automática, textura de piel realista, luz de ambiente normal y fondo modesto
• sonido nativo útil: diálogo, tono de ambiente, rasgado/click de empaque o sonido de uso del producto
• restricciones negativas: sin cortes a menos que estén planificados, sin filtro de belleza, sin deriva del actor, sin mutación del producto, sin producto duplicado, sin texto de etiqueta inventado, sin dedos extra, sin logotipo no relacionado, sin subtítulos, sin marca de agua

Evita "comercial cinematográfico", simetría perfecta, iluminación de estudio de lujo, tomas agresivas con dolly o poses de modelo a menos que el brief solicite explícitamente un anuncio híbrido pulido.

6. Prueba en seco del payload real

Ubica el skill adyacente instalado en este orden:

• ~/.codex/skills/hiapi-seedance-2-0-video-skill
• ~/.codex/skills/hiapi-seedance-2-0-video
• HIAPI_SEEDANCE_SKILL_DIR cuando esté configurado explícitamente

Ejecuta el wrapper desde este directorio de skill:

node scripts/run-ugc-seedance.mjs /ruta/absoluta/hacia/ugc-brief.json --dry-run

El wrapper importa el constructor de payload probado del skill adyacente. Convierte las rutas de medios locales a data URIs dentro de Node, por lo que las referencias grandes no se pasan a través de argumentos de shell. Revisa el payload censurado y confirma:

• modelo es seedance-2.0
• duración es 4–15
• relación es 9:16
• resolución es la prevista
• generate_audio coincide con el brief
• exactamente un modo de medios está presente
• solo referencias aprobadas están presentes

7. Generar solo cuando se solicite

Para una solicitud de video real, requiere HIAPI_API_KEY en el entorno, luego ejecuta:

node scripts/run-ugc-seedance.mjs /ruta/absoluta/hacia/ugc-brief.json

Si el usuario solo pide conceptos, guiones, prompts o un plan de producción, detente antes de este comando y devuelve el brief completo.

Para un lote, usa un brief por variante y preserva un ID de campaña estable más una etiqueta de variante. Cambia el ángulo previsto; no cambies en silencio las afirmaciones del producto. El esquema de tarea actual de HiAPI Seedance 2.0 no acepta un seed proporcionado por el cliente.

El runner imprime el ID de tarea de HiAPI inmediatamente después de la creación de la tarea. Si el polling o la descarga se interrumpen por un error de red transitorio, reanuda esa tarea exacta en lugar de crear y facturar un duplicado:

node scripts/run-ugc-seedance.mjs /ruta/absoluta/hacia/ugc-brief.json \
  --resume-task-id "tk-hiapi-..."

8. Verificar el artefacto

Nunca infieras éxito a partir de una solicitud aceptada o un ID de tarea.

Después de la descarga:

1. Sonda el MP4 con ffprobe; registra duración, dimensiones, velocidad de cuadros, códecs y presencia de audio.
2. Extrae los fotogramas de apertura, demostración y finales.
3. Inspecciona la identidad facial, manos, boca, geometría del producto, empaque, etiqueta, cantidad de producto y continuidad del fondo.
4. Escucha el audio completo o transcríbelo. Verifica el idioma exacto, la inteligibilidad, la sincronía de labios, los sonidos del producto y la CTA completa.
5. Rechaza salidas con texto fabricado, discurso truncado, deriva facial, manos deformadas, mutación del producto, conflictos de divulgación o una demostración visible faltante.
6. Añade subtítulos de plataforma, texto de zona segura, música o superposiciones de CTA solo después de que la generación cruda pase la verificación.

Si aparece algún fallo central del producto o de la imagen, regenera desde una placa de referencia más limpia o simplifica la acción. No ocultes un fallo material con recorte.

Contrato de salida

Devuelve estas secciones en el idioma del usuario:

1. Suposiciones
2. Fuentes del producto y libro de reclamaciones
3. Formato UGC elegido y ángulo de audiencia
4. Variantes de gancho
5. Guion final con tiempos por beat
6. Plan de activos de referencia
7. Prompt Seedance listo para copiar
8. Payload validado o comando de ejecución exacto
9. Notas de cumplimiento y divulgación
10. Resultados de QC
11. Rutas de artefactos — solo después de que existan archivos reales

Para un resultado generado, distingue entre creado, aún procesando, fallido y descargado. Nunca digas "terminado" sin un archivo local real o una URL de resultado remoto verificada.

Recursos

• Lee references/ugc-playbook.md para selección de formato, tiempos, patrones de prompt, diseño de lotes y QC.
• Lee references/github-foundations.md al auditar o actualizar la base de código abierto del skill.
• Copia assets/ugc-brief.example.json como el brief verificable por máquina.
• Ejecuta scripts/validate-ugc-brief.mjs antes de cada generación paga.
• Ejecuta scripts/run-ugc-seedance.mjs para pruebas en seco del payload y ejecución real de HiAPI.