¿Qué hace revisión-render-ugc?
Puerta de control de calidad que TODA receta de video UGC DEBE superar antes de publicar. No es una revisión visual
/watch— es una comparación determinista de transcripción versus guion que sale con código distinto de cero ante un defecto, permitiendo que la receta detengaset_final_render.
Por qué existe
Seedance genera el audio de forma nativa. A veces pronuncia mal una palabra — la línea aprobada verificado-por-humanos se escucha como verificado por humanos; ejemplos documentados: Hume→Hune, Alitu→al-too. El defecto reside en el audio del render, por lo que una revisión visual /watch ("el diálogo coincide con el guion") lo pasa por alto, y un paso posterior de subtítulos incorpora la palabra incorrecta. Nadie comparaba el audio realmente hablado contra el guion que el usuario aprobó.
Esta puerta hace exactamente eso, de forma determinista, y rechaza publicar si hay discrepancia.
Cuándo ejecutar
- OBLIGATORIO en todas las recetas
remix-ugc-*-from-sampleycreate-ugc-*-video-from-refs, en la fase de QC, después de que exista el render maestro y antes deset_final_render. - Vuelva a ejecutar tras cada corrección / reintento hasta que PASE.
Contrato
Antes de renderizar, guarde las líneas exactas aprobadas (la expresión textual, sin anotaciones de entonación) en working/approved-script.txt. Luego, tras el render:
python3 <paquete>/revisión-render-ugc/scripts/review_render.py \
--video working/final.mp4 \
--script-file working/approved-script.txt \
--json working/review-verdict.json
- exit 0 → ÉXITO — proceda a publicar (
set_final_render). - exit 2 → FALLO — NO publique. Lea el informe, corrija, vuelva a ejecutar.
- exit 3 → ERROR — la comprobación no pudo ejecutarse (ver más abajo); corrija el entorno, no publique a ciegas.
Backend de transcripción (por orden de prioridad): OPENAI_API_KEY (respeta OPENAI_BASE_URL, por lo que se enruta a través del proxy Whisper de gooseworks cuando está configurado) → CLI local whisper. ffmpeg debe estar en PATH.
Qué significa FALLO y cómo corregirlo
| Línea del informe | Causa raíz | Corrección |
|---|---|---|
[alto] dijo [ingenioso] donde el guion tiene [verificado] | Seedance pronunció mal la palabra en el audio generado | Re-intente con una nueva semilla. Si es una marca o token acuñado, deletréelo fonéticamente en la LÍNEA HABLADA (ej. Ali-too, nunca un paréntesis (pronunciado …) — Seedance lee los paréntesis en voz alta). Consulte Modos de Fallo de create-video-seedance-2-fal. |
[medio] omitió [...] / baja similitud | Seedance omitió una frase aprobada | Re-intente; si solo es una palabra al final, una corrección quirúrgica con stitch_replacement.py puede recuperarla. |
⚠ el audio está efectivamente en silencio | Render incorrecto / pista de audio perdida en postproducción | Vuelva a renderizar / verifique el multiplexado; nunca publique una toma en silencio. |
ERROR: no hay backend de transcripción | Sin OPENAI_API_KEY ni whisper local | Configure la clave (proxy OPENAI_BASE_URL) o instale whisper, luego vuelva a ejecutar. |
--expect-music es solo informativo (advierte si falta un fondo musical); por sí mismo no hace fallar la puerta.
Entradas
--video RUTA(obligatorio) — el mp4 maestro renderizado.--script-file RUTAo--script "texto"— el guion hablado aprobado. Omita ambos solo para un clip genuinamente sin guion (la verificación de deriva se omite y la puerta es informativa).--min-ratio FLOTANTE(por defecto0.90) — similitud de tokens transcripción↔guion para aprobar.--json RUTA— escribe el veredicto de máquina para el panel de revisión de la aplicación.
Pruebas
python3 tests/test_review_render.py # lógica pura de veredicto; sin audio/red
Cubre el error canónico verificado→ingenioso, errores de marcas, omisiones al final, relleno benigno y la ruta informativa sin guion.
Relación con el motor de revisión content-goose
Esta es la parte empaquetada, de un solo archivo y puerta de control de la rúbrica más completa coworkers/video/molecules/review/review-loop (18 ejes). Aquí imponemos el único eje que detecta defectos de audio versus guion en el momento de la publicación (review-transcript-integrity / brand_text_accuracy). La revisión multi-eje más profunda permanece en el laboratorio de content-goose.