Generación de videos de construcción y diorama en miniatura
De noche: un konbini japonés del tamaño de una caja de cerillas brilla en ámbar; la cámara se acerca lentamente desde la oscuridad hacia él—el bokeh engulle el mundo mientras la puerta de vidrio, los estantes y los diminutos fluorescentes permanecen nítidos. Esa inmersión de "pequeño pero real" es el gancho emocional al que apunta esta habilidad.
Konbini, puesto de fideos bajo la lluvia, taller cyberpunk—o una foto de una construcción terminada: una línea o una imagen → clip.
Dependencias: WERYAI_API_KEY + Node.js 18+. Cuando ejecutes la CLI, scripts/video_gen.js debe existir; WERYAI_VIDEO_API.md debe existir en resources/ (proporciona ambos mediante publicación o ensamblaje previo al uso). Consulta los comandos completos y los campos JSON en resources/WERYAI_VIDEO_API.md. No hay otras habilidades de Cursor. Los parámetros predeterminados y los niveles de modelo se encuentran en las tablas a continuación; los límites de la API en vivo siguen los modelos weryai. Antes de instalar o ejecutar, revisa el video_gen.js incluido para confirmar que cumple con tus requisitos. Presta especial atención a cómo maneja los archivos locales si eliges permitir su uso, asegurando que este comportamiento se alinee con el flujo de trabajo previsto de la habilidad para solicitudes de imagen a video.
Metadatos del registro: El único secreto de tiempo de ejecución requerido es WERYAI_API_KEY. Aparece en el frontmatter YAML como requires.env de nivel superior (mapeo de flujo, para herramientas que solo aplanan claves raíz), metadata.openclaw.primaryEnv y metadata.openclaw.requires.env. Los directorios de habilidades y registros deberían mostrar ese requisito de forma anticipada para que los instaladores lo vean antes de la descarga. Nunca incluyas la clave dentro del paquete.
Antes de instalar o configurar WERYAI_API_KEY
- Confianza: Confirma que confías en WeryAI y aceptas que las indicaciones y las entradas de imagen (URLs y, si se usan, bytes cargados) se envían a los servidores de WeryAI a través de la red.
- Contenido sensible: No pongas secretos en
prompt. No proporciones URLs de imágenes ni archivos locales que consideres sensibles a menos que aceptes el procesamiento del lado del proveedor. --dry-runprimero: Ejecutanode scripts/video_gen.js wait --json '…' --dry-run(y/osubmit-*con--dry-run) antes de configurar una clave para inspeccionar la forma JSON;WERYAI_API_KEYno es necesaria para--dry-runsolamente (consultaWERYAI_VIDEO_API.md).- Fuente: Si no puedes verificar el autor del paquete o necesitas un control estricto de los datos, no configures
WERYAI_API_KEY, o ejecuta solo en un entorno aislado / de prueba.
Variables de entorno (video_gen.js incluido)
- Requerido para llamadas API reales: solo
WERYAI_API_KEY(modelos, generación,status, carga de imagen local). No se requiere para--dry-runsolamente. - No lo lee este script: Las variables de entorno no anulan los nombres de host de la API;
https://api.weryai.comyhttps://api-growth-agent.weryai.comestán fijados en el código (consulta Seguridad). No esperes controles de anulación de URL—no los hay en esta compilación. - Sondeo:
waitutiliza constantes fijas de retroceso exponencial y tiempo de espera en el script (consultaWERYAI_VIDEO_API.md), no variables de entorno de sondeo separadas en este paquete.
Script vs valores predeterminados de la habilidad (deben coincidir con JSON)
model: La CLI no tiene un modelo predeterminado integrado. Simodelfalta o está vacío en JSON,video_gen.jsdevuelveMISSING_PARAM(sin modelo predeterminado). El valor recomendado de esta habilidad en las tablas esKLING_V3_0_PRO—siempre pasa"model":"<clave confirmada>"explícitamente en el JSON dewait/submit-*para que coincida con la tabla previa al envío.resolution: ParaKLING_V3_0_PRO(nivel predeterminado de esta habilidad), omiteresolutionpor completo del JSON—enviarlo puede causar1002/ errores de parámetros para modelos que no admiten ese campo. Solo agregaresolutioncuando el modelo elegido lo enumere ennode scripts/video_gen.js modelsy tu tabla de confirmación lo incluya explícitamente.
Requisitos previos
WERYAI_API_KEYdebe estar configurada en el entorno antes de ejecutarvideo_gen.js.- Se requiere Node.js 18+. Prefiere URLs de imágenes
httpspúblicas. Si elscripts/video_gen.jsensamblado admite rutas de archivos locales, revisa y verifica el script primero, luego obtén consentimiento explícito antes de que lea una imagen local y la cargue a WeryAI para obtener una URL pública. - Cada ejecución exitosa de
waitconsume créditos de WeryAI; volver a ejecutar crea nuevas tareas pagadas.
Seguridad, secretos y hosts de API
WERYAI_API_KEY: Trátala como un secreto. Configúrala solo si confías en la fuente de esta habilidad; está listada en los metadatos de OpenClaw comorequires.env/primaryEnvpara que los instaladores sepan que es obligatoria en tiempo de ejecución (nunca la confirmes dentro del paquete de la habilidad).- Hosts de API (fijados en
video_gen.js): Las tareas de video usanhttps://api.weryai.com; la lista de modelos usahttps://api-growth-agent.weryai.com. El script incluido fija estas bases en el código—soloWERYAI_API_KEYse lee del entorno para la autenticación. No confíes en ninguna variable de entorno para cambiar los nombres de host de la API; las solicitudes solo van a esos endpoints oficiales más la URL de carga documentada cuando se carga una imagen local (consultaWERYAI_VIDEO_API.md). - Divulgación del manejo de imágenes locales: Prefiere URLs de imágenes
httpspúblicas. Si elscripts/video_gen.jsensamblado admite rutas de archivos locales, puede leer una imagen local y cargarla a WeryAI para obtener una URL pública; requiere revisión/verificación y consentimiento explícito antes de usar esa ruta. - Procesamiento remoto: Las ejecuciones pagadas envían
prompty las entradas de imagen a WeryAI; consulta## Antes de instalar o configurar WERYAI_API_KEY. - Mayor seguridad: Sigue
## Antes de instalar o configurar WERYAI_API_KEY; usa un entorno de corta duración o aislado para las ejecuciones pagadas; revisascripts/video_gen.js(bucle de envío HTTPS + sondeo) antes del uso en producción. Verifica si el tiempo de ejecución puede leer archivos de imagen locales y cargarlos a WeryAI, y obtén consentimiento explícito antes de usar esa ruta.
Expansión de indicaciones (obligatorio)
video_gen.js no expande indicaciones. Antes de cada wait --json, convierte la breve o vaga instrucción del usuario en un prompt de producción completo en inglés.
Cuándo: El usuario solo da keywords, una línea o una intención vaga—o pide un lenguaje de video más rico. Excepción: Pegan un prompt largo ya terminado dentro del prompt_length_limit del modelo y te piden no reescribirlo; aún así muestra el texto completo en la tabla de confirmación.
Siempre agrega (lenguaje de video): escala de plano y ángulo; movimiento de cámara o bloqueo; calidad de luz y motivación; acción del sujeto ajustada a duration; un resultado claro para este nicho; indica 9:16 vertical cuando esta habilidad predetermina vertical.
Longitud: Respeta prompt_length_limit para el model_key elegido cuando este documento lo enumera; recorta adjetivos de relleno antes de eliminar cláusulas principales de acción, lente o luz.
Confirmación: La tabla previa al envío debe incluir el prompt expandido completo (nunca un resumen de una línea). Espera confirmación o ediciones.
Lista de verificación del nicho
- Mundo en miniatura: poca profundidad de campo, luces cálidas prácticas, revelado con dolly/push-in; diorama o habitación en una caja.
- Tiempos: construcción → pintura → luces encendidas o paso de vehículo; atmósfera acogedora, materiales táctiles.
- Señales de escala: referencias útiles de cerilla, moneda o punta de dedo.
### Ejemplos de indicaciones al principio de este archivo son solo disparadores cortos—siempre expande a partir de la solicitud real del usuario.
Flujo de trabajo
- Confirma que la solicitud del usuario coincida con el escenario de esta habilidad (texto a video y/o imagen a video según la documentación).
- Recoge la breve, la(s) URL(s) de imagen opcional(es), el nivel (mejor / bueno / rápido) o una clave
modelexplícita. - Expande la indicación (obligatorio): A menos que el usuario haya proporcionado un prompt largo terminado y haya pedido explícitamente no reescribirlo, expande la breve en un
promptde producción completo en inglés usando## Expansión de indicaciones (obligatorio)a continuación. No llames a la API solo con las palabras mínimas del usuario. - Verifica el
promptexpandido contra elprompt_length_limitdel modelo seleccionado en las tablas fijas de este documento (cuando estén presentes); acórtalo si es necesario. - Verifica
duration,aspect_ratio,generate_audio,negative_prompty otros campos contra las tablas fijas de este documento yWERYAI_VIDEO_API.md. Incluyeresolutionsolo cuando elmodelseleccionado lo admita (para el nivel KLING predeterminado de esta habilidad, no envíesresolution—consulta## Script vs valores predeterminados de la habilidad). - Muestra la tabla de parámetros previa al envío incluyendo el
promptexpandido completo; espera confirmación o ediciones. - Después de la confirmación, ejecuta
node scripts/video_gen.js wait --json '...'con el prompt expandido. - Analiza el JSON de stdout y devuelve las URLs de video; en caso de fallo, muestra
errorCode/errorMessagey sugiere correcciones de parámetros.
Referencia CLI
node scripts/video_gen.js wait --json '{"model":"…","prompt":"…","duration":5,"aspect_ratio":"9:16"}'
node scripts/video_gen.js wait --json '…' --dry-run
node scripts/video_gen.js status --task-id <id>
Referencia completa: WERYAI_VIDEO_API.md.
Definición de finalización
Finalizado cuando el usuario recibe al menos una URL de video reproducible de la respuesta de la API, o una explicación clara del fallo con los siguientes pasos. Todos los parámetros utilizados deben estar dentro de los conjuntos permitidos del modelo seleccionado en este documento. El prompt enviado debe ser el prompt expandido de producción a menos que el usuario haya proporcionado explícitamente un prompt largo terminado y haya pedido no reescribirlo.
Límites (fuera del alcance)
- No revisa el cumplimiento de la plataforma, los derechos de autor o los derechos de retrato; no garantiza la usabilidad comercial de los resultados.
- No proporciona renderizado sin conexión que no sea de WeryAI, líneas de tiempo de edición tradicionales o combinaciones de campos API no documentadas en esta SKILL o
WERYAI_VIDEO_API.md. - No enlaces a
weryai-model-capabilities.mdo rutas compartidas../references/; usaresources/WERYAI_VIDEO_API.mdpara detalles de CLI/API. - No codifiques rutas absolutas en el documento de la habilidad; ejecuta
node scripts/...desde la raíz del paquete de la habilidad (el directorio que contieneSKILL.md) para que las rutasscripts/yresources/se resuelvan.
Ejemplos de indicaciones
Hand-built miniature café: final beat lights on inside, warm fill, slow push verticalUse this street diorama still: tiny car passes, shop windows light upPainted model on base, rotate reveal, ultra-shallow depth of fieldMiniature build reveal 9:16, cozy warm lights turning on inside tiny house
Parámetros predeterminados
| Campo | Valor |
|---|---|
| Model | KLING_V3_0_PRO (debe aparecer como "model" en JSON—el script no lo predetermina) |
| Aspect ratio | 9:16 (vertical fijo) |
| Duration | Corta (duration: 5); usa 10 para un pase de construcción más largo |
| Resolution | Omitir para el predeterminado de KLING (no incluir la clave en JSON) |
| Style | Profundidad de campo muy reducida, materiales creíbles, luz de acento en los accesorios principales, push-in lento u órbita sutil (fijo) |
| Audio | Activado (sonido ambiente + detalle diminuto de accesorios para inmersión) |
Validez de API (
KLING_V3_0_PROpredeterminado):durationde texto a video solo 5 / 10 / 15;aspect_ratiosolo 9:16, 1:1, 16:9.aspect_ratiode imagen a video solo 9:16, 16:9, 1:1. Sin camporesolution—no lo envies. Para el nivel rápido con VEO: texto a videoVEO_3_1_FAST, imagen a videoCHATBOT_VEO_3_1_FAST, condurationfijo en 8,aspect_ratiosolo 9:16 o 16:9. Al cambiarmodel_key, sigue los conjuntos permitidos en las restricciones de modelo/API de esta sección y la nota de validez de API anterior; no envíesresolutiona modelos que no lo admitan.
Descripción de escena → mundo en miniatura
Propósito: Ideas concretas de escena, pruebas visuales rápidas o variaciones de ambiente por lotes—sin necesidad de modelo físico.
Entradas:
Tipo de escena (konbini / cocina / cabaña / puesto de esquina / taller / set cyber) y ambiente (cálido sanador / neón cyber / luz diurna / ámbar lluvioso). Si se omite el ambiente, elige la iluminación que suele funcionar mejor para esa escena. Opcionalmente, enfatiza el proceso de construcción vs recorrido terminado.
Extrae los accesorios clave y la luz, elige un ángulo que provoque "Quiero esto", construye el prompt, muestra los parámetros completos, espera confirmación, luego node scripts/video_gen.js wait --json '…'.
Los parámetros completos se muestran antes de la generación; espera la confirmación.
Configuración de parámetros:
| Campo | Valor |
|---|---|
| model | KLING_V3_0_PRO |
| aspect_ratio | 9:16 |
| duration | 5 |
| generate_audio | true |
| resolution | (omitir—no enviar para este modelo) |
Ejemplos de entrada:
"Japanese konbini at night, warm healing" → la habilidad construye:
Extreme close-up macro shot at eye level, a palm-sized miniature Japanese convenience store diorama on a dark surface, warm amber interior light glows through tiny sliding glass doors and frostwork windows illuminating a perfectly detailed interior — miniature shelves stocked with thumb-sized product packages, a tiny register counter, a softbox ceiling panel. The camera dollies in very slowly at 30fps toward the entrance as if walking toward it, the shallow depth of field keeps only the storefront razor-sharp while the surrounding darkness melts away. Cold blue night-time ambient fills the exterior, creating a warm-cold color split at the door threshold. ASMR soft ambient hum, distant city night sound, faint interior muzak.
"Cyberpunk workshop, neon" →
Medium close-up at 45-degree overhead angle, a miniature cyberpunk studio diorama the size of a shoebox — crammed with tiny glowing monitors, cable-draped desk, neon-lit bookshelves in pink and cyan, a miniature action figure at the keyboard. The camera orbits slowly around the scene at 60fps in a single smooth rotation, neon light refracts off every tiny reflective surface — monitor bezels, coffee mug, glossy floor tile. Volumetric light rays from the neon tubes create a soft haze above the scene.
…
[truncado para traducción]