Référence de commande CLI Bailian pour la génération vidéo, la génération à partir de référence et l'édition vidéo.
Une seule commande invoque les fonctionnalités de génération et d’édition vidéo de Bailian depuis le terminal.
ImportantAjoutez --help à toute commande pour obtenir les détails complets des paramètres, par exemple bl video generate --help. Tous les paramètres qui acceptent une URL de fichier acceptent également un chemin local — le CLI télécharge automatiquement le fichier vers un stockage temporaire (valide pendant 48 heures), vous n'avez donc jamais besoin d'héberger vos fichiers en tant qu'URL. Les détails des commandes de cette page sont vérifiés avec bl 2.2.1.
Référence de commande
bl video generate
Génère une vidéo à partir d’un texte ou d’une image (wan3.0-video / wan2.6-t2v / happyhorse-1.1-i2v). Nécessite une authentification par clé API.
Utilisation
bl video generate --prompt <text> [--image <url>] [flags]
| Paramètre | Type | Requis | Description |
|---|---|---|---|
--model <model> | string | Non | ID du modèle (par défaut : wan3.0-video) |
--prompt <text> | string | Oui | Description de la vidéo |
--image <url> | string | Non | URL de l’image d’entrée pour la génération image-to-video |
--last-frame <url> | string | Non | URL de l’image du dernier cadre (avec --image, active le mode premier+dernier cadre kf2v) |
--negative-prompt <text> | string | Non | Prompt négatif pour exclure des contenus indésirables |
--resolution <res> | string | Non | Résolution : 720P ou 1080P (par défaut : 1080P) |
--ratio <ratio> | string | Non | Ratio d’aspect (ex. 16:9, 9:16, 1:1) |
--duration <seconds> | number | Non | Durée de la vidéo en secondes (par défaut : 5) |
--prompt-extend <bool> | boolean | Non | Activer l’extension du prompt (true/false). Omettre le flag pour omettre le paramètre (comportement par défaut DashScope). |
--watermark <bool> | boolean | Non | Activer le filigrane (true/false). Omettre le flag pour utiliser le paramètre du profil ou la valeur par défaut CLI (true). |
--seed <n> | number | Non | Graine aléatoire pour une génération reproductible |
--download <path> | string | Non | Enregistrer la vidéo dans un fichier à la fin |
--file <url-or-path> | string | Non | URL de fichier ou chemin local pour la génération file-to-video (uniquement wan3.0-video ; mutuellement exclusif avec --image/--last-frame) |
--prime | switch | Non | Utiliser le mode Prime avec un point d’accès lié à un espace de travail |
--workspace-id <id> | string | Non | ID de l’espace de travail pour le point d’accès Prime par défaut (ou définir BAILIAN_WORKSPACE_ID) |
--async | switch | Non | Retourner l’ID de tâche asynchrone sans attendre |
--concurrent <n> | number | Non | Exécuter N requêtes parallèles (par défaut : 1) |
--poll-interval <seconds> | number | Non | Intervalle de sondage lors de l’attente (par défaut : 5) |
Exemple : Générer une vidéo à partir d'une description textuelle
bl video generate --prompt "A person reading a book, static shot"
- Le mode Prime nécessite un modèle explicite.
- Point d'accès Prime : --base-url, DASHSCOPE_BASE_URL ou base_url du profil a la priorité ; sinon, l'espace de travail est déterminé à partir de --workspace-id, BAILIAN_WORKSPACE_ID, puis de l'espace de travail configuré.
bl video ref
Génération vidéo à partir de référence (wan3.0-video / happyhorse-1.1-r2v / wan2.6-r2v) : multi-sujet, multi-cadre avec voix. Nécessite une authentification par clé API.
Utilisation
bl video ref --prompt <text> --image <url>... [--ref-video <url>...] [flags]
| Paramètre | Type | Requis | Description |
|---|---|---|---|
--model <model> | string | Non | ID du modèle (par défaut : wan3.0-video) |
--prompt <text> | string | Oui | Description vidéo avec marqueurs de référence (image1, video1, etc.) |
--image <url> | array | Non | URL d'image de référence ou fichier local (répétable pour plusieurs sujets) |
--ref-video <url> | array | Non | URL de vidéo de référence ou fichier local (répétable) |
--image-voice <url> | array | Non | URL de voix correspondant à l'image (appariements par position). Sur wan3.0-video émis comme reference_audio (se référer à Audio 1, Audio 2 dans le prompt) |
--video-voice <url> | array | Non | URL de voix correspondant à la ref-video (appariements par position). Sur wan3.0-video émis comme reference_audio (se référer à Audio 1, Audio 2 dans le prompt) |
--resolution <res> | string | Non | Résolution : 720P ou 1080P (par défaut : 1080P) |
--ratio <ratio> | string | Non | Ratio d’aspect (16:9, 9:16, 1:1) |
--duration <seconds> | number | Non | Durée de la vidéo en secondes (par défaut : 5) |
--prompt-extend <bool> | boolean | Non | Activer l’extension du prompt (true/false). Omettre le flag pour omettre le paramètre (comportement par défaut DashScope). |
--watermark <bool> | boolean | Non | Activer le filigrane (true/false). Omettre le flag pour utiliser le paramètre du profil ou la valeur par défaut CLI (true). |
--seed <n> | number | Non | Graine aléatoire pour une génération reproductible |
--download <path> | string | Non | Enregistrer la vidéo dans un fichier à la fin |
--async | switch | Non | Retourner l’ID de tâche asynchrone sans attendre |
--concurrent <n> | number | Non | Exécuter N requêtes parallèles (par défaut : 1) |
--poll-interval <seconds> | number | Non | Intervalle de sondage lors de l’attente (par défaut : 15) |
Exemple : Créer une vidéo à l’aide d’une image de référence et d’une description
bl video ref --prompt "Image1 running on the grass" --image person.jpg
bl video edit
Éditer une vidéo avec happyhorse-1.0-video-edit (transfert de style, remplacement d’objet, etc.). Nécessite une authentification par clé API.
Utilisation
bl video edit --video <url> --prompt <text> [flags]
| Paramètre | Type | Requis | Description |
|---|---|---|---|
--model <model> | string | Non | ID du modèle (par défaut : happyhorse-1.0-video-edit) |
--video <url> | string | Oui | URL de vidéo d’entrée ou fichier local (mp4/mov, 2-10s) |
--prompt <text> | string | Non | Instruction d’édition (ex. « Convertir la scène en style argile ») |
--ref-image <url> | string | Non | URL d’image de référence (jusqu’à 4, séparées par des virgules) |
--negative-prompt <text> | string | Non | Prompt négatif pour exclure des contenus indésirables |
--resolution <res> | string | Non | Résolution : 720P ou 1080P (par défaut : 1080P) |
--ratio <ratio> | string | Non | Ratio d’aspect (16:9, 9:16, 1:1, 4:3, 3:4) |
--duration <seconds> | number | Non | Durée de la vidéo de sortie en secondes (2-10) |
--audio-setting <mode> | string | Non | Audio : auto (par défaut) ou origin (garder l’original) |
--prompt-extend <bool> | boolean | Non | Activer l’extension du prompt (true/false). Omettre le flag pour omettre le paramètre (comportement par défaut DashScope). |
--watermark <bool> | boolean | Non | Activer le filigrane (true/false). Omettre le flag pour utiliser le paramètre du profil ou la valeur par défaut CLI (true). |
--seed <n> | number | Non | Graine aléatoire pour une génération reproductible |
--download <path> | string | Non | Enregistrer la vidéo dans un fichier à la fin |
--async | switch | Non | Retourner l’ID de tâche asynchrone sans attendre |
--concurrent <n> | number | Non | Exécuter N requêtes parallèles (par défaut : 1) |
--poll-interval <seconds> | number | Non | Intervalle de sondage lors de l’attente (par défaut : 15) |
Exemple : Modifier une vidéo avec des changements de style ou d’objet
bl video edit --video https://example.com/input.mp4 --prompt "Convert the entire scene to claymation style"
bl video download
Télécharger une vidéo terminée à partir de son ID de tâche. Nécessite une authentification par clé API.
Utilisation
bl video download --task-id <id> --out <path>
| Paramètre | Type | Requis | Description |
|---|---|---|---|
--task-id <id> | string | Oui | ID de tâche à télécharger |
--out <path> | string | Oui | Chemin du fichier de sortie |
Exemple : Télécharger une vidéo à partir de son ID de tâche
bl video download --task-id 3b256896-xxxx --out video.mp4
bl video task get
Interroger l’état d’une tâche asynchrone. Nécessite une authentification par clé API.
Utilisation
bl video task get --task-id <id>
| Paramètre | Type | Requis | Description |
|---|---|---|---|
--task-id <id> | string | Oui | ID de tâche asynchrone |
Exemple : Vérifier l’état d’une tâche vidéo asynchrone
bl video task get --task-id 3b256896-3e70-xxxx-xxxx-xxxxxxxxxxxx