Creator Video
Paso 1 — Planificar el clip
- Qué se mueve — un sujeto, una acción, un movimiento de cámara por clip
(
references/video-prompting.md). - Proporción — Shorts/Reels/TikTok
9:16, todo lo demás16:9. - Duración — 8 s por defecto; historias más largas se convierten en varios clips que se unen después.
- Fotograma de inicio? — si la apariencia importa (marca, personaje, producto), crea primero el primer fotograma como imagen (creator-image o
creator.py image), aprueba esa imagen y luego anímala con--start. Esta es la forma más confiable de controlar el resultado en cualquier proveedor. - Fotograma final / referencias —
--endpara transiciones y revelaciones,--refpara identidad. - Resolución —
720ppor defecto;1080pcuando se pida.
Paso 2 — Generar
python3 scripts/creator.py video --prompt "<prompt de movimiento>" --out ./out/<slug>.mp4 --ratio 16:9 --duration 8 [--start first.png] [--end last.png] [--ref ref.png] [--resolution 1080p]
La generación de video toma de 1 a 10 minutos. Ejecútalo en segundo plano cuando sea posible y no inicies una segunda generación mientras tanto.
Paso 3 — Manejar el resultado
status | Hacer |
|---|---|
ok | python3 scripts/media.py probe <path>; extrae un fotograma y míralo; reporta ruta, duración, proveedor |
needs_browser | Sigue references/browser-flow-browser.md (o gemini) con los campos request; luego creator.py adopt --src <download> --out <path> |
blocked | Contenido rechazado; revísalo con el usuario, no lo evites |
failed y no hay ningún proveedor de video | Usa la alternativa de imágenes estáticas (abajo) e informa al usuario qué proveedor desbloquearía el movimiento real |
Alternativa de imágenes estáticas (siempre disponible)
- Genera 1–3 imágenes estáticas con
creator.py imageen la proporción deseada. python3 scripts/media.py still --image s1.png --out clip.mp4 --duration 6 --ratio 16:9 --motion in(varía--motionpor cada imagen; une varias conmedia.py assemble).
Paso 4 — Finalizar (opcional)
- Reencuadre:
media.py reframe --video clip.mp4 --out clip-9x16.mp4 --ratio 9:16 --mode blur(cropcuando el sujeto esté centrado). - Subtítulos: escribe un archivo
.srt, luegomedia.py captions --video clip.mp4 --srt subs.srt --out final.mp4. - Sonido:
creator.py sfx/musicy mézclalo conmedia.py assemble(una sola escena).
Reglas
- Verifica en disco (duración > 0, proporción esperada) antes de reportar éxito.
- Menciona cuando una ruta gaste créditos por clip (Flow, Higgsfield) si el usuario pide muchos.
- Mantén una "frase de apariencia" consistente en todos los clips del mismo proyecto.
Referencias
references/video-prompting.md— fórmula de toma, fotogramas, referenciasreferences/providers.md— orden de proveedores de video y alternativareferences/media-ops.md— imagen estática, reencuadre, subtítulos, ensamblajereferences/browser-flow-browser.md,references/browser-gemini-browser.md