Skill de Generación de Video Sora
Crea o gestiona clips de video cortos para el proyecto actual (demostraciones de producto, spots de marketing, tomas cinematográficas, maquetas de UI). Usa por defecto sora-2 y un flujo de aumento de prompt estructurado, prefiriendo la CLI incluida para ejecuciones deterministas. Nota: $sora es una etiqueta de skill en los prompts, no un comando de shell.
Cuándo usarlo
- Generar un nuevo clip de video a partir de un prompt
- Remezclar un video existente por su ID
- Consultar el estado, listar trabajos o descargar activos (video/miniatura/spritesheet)
- Ejecuciones por lotes (muchos prompts o variantes)
Árbol de decisiones (crear vs remezclar vs estado/descarga vs lote)
- Si el usuario tiene un ID de video y quiere un cambio → remezclar
- Si el usuario tiene un ID de video y quiere el estado o los activos → estado/consulta/descarga
- Si el usuario necesita muchos prompts/activos → crear-lote
- Si el usuario pide dos versiones con un cambio pequeño (misma toma, diferente sujeto/detalle) → crear la base, luego remezclar para la variación
- En caso contrario → crear (o crear-y-consultar si necesita un activo listo en un solo paso)
Flujo de trabajo
- Decidir la intención: crear vs remezclar vs estado/descarga vs lote.
- Recopilar entradas: prompt, modelo, tamaño, segundos y cualquier imagen de referencia.
- Si es lote: escribir un JSONL temporal bajo
tmp/(un trabajo por línea), ejecutar una vez, luego eliminar el JSONL. - Preferir banderas de aumento de la CLI (
--use-case,--scene,--camera, etc.) en lugar de escribir un prompt estructurado manualmente. Si ya has producido un archivo de prompt estructurado, pasa--no-augmentpara evitar un doble envolvimiento. - Ejecutar la CLI incluida (
scripts/sora.py) con valores predeterminados sensatos (verreferences/cli.md). Para prompts largos, prefiere--prompt-filepara evitar problemas de escape de shell; combínalo con--no-augmentsi el prompt ya está estructurado. - Para trabajos asíncronos, consultar hasta que se completen (o usar crear-y-consultar).
- Descargar activos (video/miniatura/spritesheet) y guardarlos localmente.
- Eliminar los archivos intermedios creados durante la invocación (por ejemplo,
prompt.txt,remix_job.json, JSONL temporal). Si el sandbox bloquearm, omite la limpieza o trunca los archivos sin mostrar un error. - Iterar con un solo cambio dirigido por prompt.
Autenticación
OPENAI_API_KEYdebe estar configurada para llamadas a la API en vivo.
Si falta la clave, da al usuario estos pasos:
- Crear una clave de API en la interfaz de usuario de la plataforma OpenAI: https://platform.openai.com/api-keys
- Configurar
OPENAI_API_KEYcomo variable de entorno en su sistema. - Ofrecerte a guiarlos para configurar la variable de entorno para su sistema operativo/shell si es necesario.
- Nunca pidas al usuario que pegue la clave completa en el chat. Pídele que la configure localmente y confirme cuando esté listo.
Valores predeterminados y reglas
- Modelo predeterminado:
sora-2(usasora-2-propara mayor fidelidad). - Tamaño predeterminado:
1280x720. - Segundos predeterminados:
4(permitidos:"4","8","12"como cadenas). - Siempre establecer tamaño y segundos mediante parámetros de la API; la prosa no los cambiará.
- Usa el SDK de Python de OpenAI (
openai); no uses HTTP directo. - Requerir
OPENAI_API_KEYantes de cualquier llamada a la API en vivo. - Si fallan los permisos de caché de uv, establecer
UV_CACHE_DIR=/tmp/uv-cache. - Las imágenes de referencia de entrada deben ser jpg/png/webp y deben coincidir con el tamaño objetivo.
- Las URLs de descarga caducan después de aproximadamente 1 hora; copia los activos a tu propio almacenamiento.
- Preferir la CLI incluida y nunca modificar
scripts/sora.pya menos que el usuario lo solicite. - Sora puede generar audio; si un usuario solicita voz en off/audio, especifícalo explícitamente en las líneas
Audio:yDialogue:y mantenlo breve.
Limitaciones de la API
- Los modelos están limitados a
sora-2ysora-2-pro. - El acceso a la API a los modelos Sora requiere una cuenta verificada por organización.
- La duración está limitada a 4/8/12 segundos y debe configurarse mediante el parámetro
seconds. - La API espera
secondscomo una enumeración de cadena ("4","8","12"). - Los tamaños de salida están limitados por modelo (ver
references/video-api.mdpara los tamaños admitidos). - La creación de video es asíncrona; debes consultar hasta que se complete antes de descargar.
- Se aplican límites de tasa según el nivel de uso (no enumeres límites específicos).
- La API aplica restricciones de contenido (ver Barreras de Protección a continuación).
Barreras de Protección (deben aplicarse)
- Solo contenido adecuado para público menor de 18 años.
- Sin personajes protegidos por derechos de autor ni música protegida por derechos de autor.
- Sin personas reales (incluidas figuras públicas).
- Las imágenes de entrada con rostros humanos son rechazadas.
Aumento de prompt
Reformatear los prompts en una especificación estructurada y orientada a la producción. Solo hacer explícitos los detalles implícitos; no inventar nuevos requisitos creativos.
Plantilla (incluir solo líneas relevantes):
Caso de uso: <donde se usará el clip>
Solicitud principal: <prompt principal del usuario>
Escena/fondo: <ubicación, hora del día, atmósfera>
Sujeto: <sujeto principal>
Acción: <una sola acción clara>
Cámara: <tipo de toma, ángulo, movimiento>
Iluminación/ambiente: <iluminación + ambiente>
Paleta de colores: <3-5 anclajes de color>
Estilo/formato: <pistas de cine/animación/formato>
Tiempo/tiempos: <conteos o tiempos>
Audio: <señal ambiental / música / voz en off si se solicita>
Texto (textual): "<texto exacto>"
Diálogo:
<diálogo>
- Orador: "Línea corta."
</diálogo>
Restricciones: <debe mantener/debe evitar>
Evitar: <restricciones negativas>
Reglas de aumento:
- Mantenlo breve; añade solo detalles que el usuario ya haya implicado o proporcionado en otro lugar.
- Para remezclas, enumera explícitamente los invariantes ("misma toma, cambiar solo X").
- Si falta algún detalle crítico y bloquea el éxito, haz una pregunta; de lo contrario, continúa.
- Si pasas un archivo de prompt estructurado a la CLI, añade
--no-augmentpara evitar que la herramienta lo vuelva a envolver.
Ejemplos
Ejemplo de generación (toma única)
Caso de uso: teaser de producto
Solicitud principal: un primer plano de una cámara negra mate sobre un pedestal
Acción: órbita lenta de 30 grados durante 4 segundos
Cámara: 85 mm, poca profundidad de campo, deriva suave de cámara en mano
Iluminación/ambiente: luz clave suave, luz de borde sutil, sensación de estudio premium
Restricciones: sin logotipos, sin texto
Ejemplo de remezcla (invariantes)
Solicitud principal: misma toma y encuadre, cambiar la paleta a verde azulado/arena/óxido con retroiluminación más cálida
Restricciones: mantener el sujeto y el movimiento de la cámara sin cambios
Mejores prácticas de prompting (lista breve)
- Una acción principal + un movimiento de cámara por toma.
- Usar conteos o tiempos para el ritmo ("dos pasos, pausa, girar").
- Mantener el texto corto y la cámara bloqueada para UI o texto en pantalla.
- Añadir una línea breve de "evitar" cuando aparezcan artefactos (parpadeo, vibración, movimiento rápido).
- Los prompts más cortos son más creativos; los más largos son más controlados.
- Poner el diálogo en un bloque dedicado; mantener las líneas cortas para clips de 4-8 s.
- Indicar los invariantes explícitamente para las remezclas (misma toma, mismo movimiento de cámara).
- Iterar con seguimientos de un solo cambio para preservar la continuidad.
Orientación por tipo de activo
Usar estos módulos cuando la solicitud sea para un artefacto específico. Proporcionan plantillas y valores predeterminados específicos.
- Tomas cinematográficas:
references/cinematic-shots.md - Anuncios sociales:
references/social-ads.md
Notas de CLI y entorno
- Comandos de CLI + ejemplos:
references/cli.md - Referencia rápida de parámetros de la API:
references/video-api.md - Guía de prompting:
references/prompting.md - Prompts de muestra:
references/sample-prompts.md - Solución de problemas:
references/troubleshooting.md - Consejos de red/sandbox:
references/codex-network.md
Mapa de referencias
references/cli.md: cómo ejecutar crear/consultar/remezclar/descargar/lote mediantescripts/sora.py.references/video-api.md: controles a nivel de API (modelos, tamaños, duración, variantes, estado).references/prompting.md: estructura de prompts y guía de iteración.references/sample-prompts.md: recetas de prompts para copiar/pegar (solo ejemplos; sin teoría adicional).references/cinematic-shots.md: plantillas para tomas cinematográficas.references/social-ads.md: plantillas para tiempos cortos de anuncios sociales.references/troubleshooting.md: errores comunes y soluciones.references/codex-network.md: solución de problemas de red/aprobación.