Referencia de comandos de la CLI de Bailian para generación de videos, generación a partir de referencia y edición de videos.
Un solo comando invoca las capacidades de generación y edición de videos de Bailian desde la terminal.
ImportanteAgregue --help a cualquier comando para obtener detalles completos de los parámetros, por ejemplo: bl video generate --help. Cada parámetro que acepta una URL de archivo también acepta una ruta local: la CLI lo carga automáticamente en almacenamiento temporal (válido durante 48 horas), por lo que nunca necesita hospedar archivos como URLs usted mismo. Los detalles de los comandos de esta página están verificados con bl 2.2.1.
Referencia de comandos
bl video generate
Genere un video a partir de texto o imagen (wan3.0-video / wan2.6-t2v / happyhorse-1.1-i2v). Requiere autenticación con clave de API.
Uso
bl video generate --prompt <text> [--image <url>] [flags]
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
--model <model> | string | No | ID del modelo (predeterminado: wan3.0-video) |
--prompt <text> | string | Sí | Descripción del video |
--image <url> | string | No | URL de imagen de entrada para generación de imagen a video |
--last-frame <url> | string | No | URL de imagen del último fotograma (con --image, habilita el modo first+last frame kf2v) |
--negative-prompt <text> | string | No | Prompt negativo para excluir contenido no deseado |
--resolution <res> | string | No | Resolución: 720P o 1080P (predeterminado: 1080P) |
--ratio <ratio> | string | No | Relación de aspecto (por ejemplo, 16:9, 9:16, 1:1) |
--duration <seconds> | number | No | Duración del video en segundos (predeterminado: 5) |
--prompt-extend <bool> | boolean | No | Habilitar extensión de prompt (true/false). Omita la bandera para omitir el parámetro (predeterminado de DashScope). |
--watermark <bool> | boolean | No | Habilitar marca de agua (true/false). Omita la bandera para usar la configuración de perfil o el valor predeterminado de la CLI (true). |
--seed <n> | number | No | Semilla aleatoria para generación reproducible |
--download <path> | string | No | Guardar video en archivo al finalizar |
--file <url-or-path> | string | No | URL de archivo de referencia o ruta local para file-to-video (solo wan3.0-video; mutuamente excluyente con --image/--last-frame) |
--prime | switch | No | Usar modo Prime con un punto final específico del espacio de trabajo |
--workspace-id <id> | string | No | ID del espacio de trabajo para el punto final Prime predeterminado (o establecer BAILIAN_WORKSPACE_ID) |
--async | switch | No | Devolver el ID de tarea asíncrona sin esperar |
--concurrent <n> | number | No | Ejecutar N solicitudes en paralelo (predeterminado: 1) |
--poll-interval <seconds> | number | No | Intervalo de sondeo al esperar (predeterminado: 5) |
Ejemplo: Generar un video a partir de una descripción de texto
bl video generate --prompt "A person reading a book, static shot"
- El modo Prime requiere un modelo explícito.
- Punto final Prime: se prioriza --base-url, DASHSCOPE_BASE_URL o base_url de perfil; de lo contrario, el espacio de trabajo se resuelve a partir de --workspace-id, BAILIAN_WORKSPACE_ID, luego del espacio de trabajo de configuración.
bl video ref
Generación de video a partir de referencia (wan3.0-video / happyhorse-1.1-r2v / wan2.6-r2v): múltiples sujetos, múltiples tomas con voz. Requiere autenticación con clave de API.
Uso
bl video ref --prompt <text> --image <url>... [--ref-video <url>...] [flags]
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
--model <model> | string | No | ID del modelo (predeterminado: wan3.0-video) |
--prompt <text> | string | Sí | Descripción del video con marcadores de referencia (image1, video1, etc.) |
--image <url> | array | No | URL de imagen de referencia o archivo local (repetible para múltiples sujetos) |
--ref-video <url> | array | No | URL de video de referencia o archivo local (repetible) |
--image-voice <url> | array | No | URL de voz para la imagen correspondiente (emparejada por posición). En wan3.0-video se emite como reference_audio (consulte Audio 1, Audio 2 en el prompt) |
--video-voice <url> | array | No | URL de voz para el video de referencia correspondiente (emparejada por posición). En wan3.0-video se emite como reference_audio (consulte Audio 1, Audio 2 en el prompt) |
--resolution <res> | string | No | Resolución: 720P o 1080P (predeterminado: 1080P) |
--ratio <ratio> | string | No | Relación de aspecto (16:9, 9:16, 1:1) |
--duration <seconds> | number | No | Duración del video en segundos (predeterminado: 5) |
--prompt-extend <bool> | boolean | No | Habilitar extensión de prompt (true/false). Omita la bandera para omitir el parámetro (predeterminado de DashScope). |
--watermark <bool> | boolean | No | Habilitar marca de agua (true/false). Omita la bandera para usar la configuración de perfil o el valor predeterminado de la CLI (true). |
--seed <n> | number | No | Semilla aleatoria para generación reproducible |
--download <path> | string | No | Guardar video en archivo al finalizar |
--async | switch | No | Devolver el ID de tarea asíncrona sin esperar |
--concurrent <n> | number | No | Ejecutar N solicitudes en paralelo (predeterminado: 1) |
--poll-interval <seconds> | number | No | Intervalo de sondeo al esperar (predeterminado: 15) |
Ejemplo: Crear un video usando una imagen de referencia y una descripción
bl video ref --prompt "Image1 running on the grass" --image person.jpg
bl video edit
Edite un video con happyhorse-1.0-video-edit (transferencia de estilo, sustitución de objetos, etc.). Requiere autenticación con clave de API.
Uso
bl video edit --video <url> --prompt <text> [flags]
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
--model <model> | string | No | ID del modelo (predeterminado: happyhorse-1.0-video-edit) |
--video <url> | string | Sí | URL de video de entrada o archivo local (mp4/mov, 2-10 s) |
--prompt <text> | string | No | Instrucción de edición (por ejemplo, "Convierta la escena a estilo de arcilla") |
--ref-image <url> | string | No | URL de imagen de referencia (hasta 4, separadas por comas) |
--negative-prompt <text> | string | No | Prompt negativo para excluir contenido no deseado |
--resolution <res> | string | No | Resolución: 720P o 1080P (predeterminado: 1080P) |
--ratio <ratio> | string | No | Relación de aspecto (16:9, 9:16, 1:1, 4:3, 3:4) |
--duration <seconds> | number | No | Duración del video de salida en segundos (2-10) |
--audio-setting <mode> | string | No | Audio: auto (predeterminado) o origin (mantener original) |
--prompt-extend <bool> | boolean | No | Habilitar extensión de prompt (true/false). Omita la bandera para omitir el parámetro (predeterminado de DashScope). |
--watermark <bool> | boolean | No | Habilitar marca de agua (true/false). Omita la bandera para usar la configuración de perfil o el valor predeterminado de la CLI (true). |
--seed <n> | number | No | Semilla aleatoria para generación reproducible |
--download <path> | string | No | Guardar video en archivo al finalizar |
--async | switch | No | Devolver el ID de tarea asíncrona sin esperar |
--concurrent <n> | number | No | Ejecutar N solicitudes en paralelo (predeterminado: 1) |
--poll-interval <seconds> | number | No | Intervalo de sondeo al esperar (predeterminado: 15) |
Ejemplo: Editar un video con cambios de estilo o de objeto
bl video edit --video https://example.com/input.mp4 --prompt "Convert the entire scene to claymation style"
bl video download
Descargue un video completado por ID de tarea. Requiere autenticación con clave de API.
Uso
bl video download --task-id <id> --out <path>
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
--task-id <id> | string | Sí | ID de tarea para descargar |
--out <path> | string | Sí | Ruta del archivo de salida |
Ejemplo: Descargar un video por ID de tarea
bl video download --task-id 3b256896-xxxx --out video.mp4
bl video task get
Consulte el estado de una tarea asíncrona. Requiere autenticación con clave de API.
Uso
bl video task get --task-id <id>
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
--task-id <id> | string | Sí | ID de tarea asíncrona |
Ejemplo: Verificar el estado de una tarea de video asíncrona
bl video task get --task-id 3b256896-3e70-xxxx-xxxx-xxxxxxxxxxxx