PixVerse CLI : créer des vidéos et images IA dans le terminal

Installez PixVerse CLI pour générer vidéos, images, voix et musique IA dans le terminal et automatiser les workflows agents avec JSON.

Product Update •
PixVerse CLI : créer des vidéos et images IA dans le terminal

Introduction

Chaque flux de travail créatif présente un goulot d’étranglement : le moment où vous devez quitter votre éditeur de code, ouvrir un navigateur et cliquer manuellement sur une interface Web pour générer un élément multimédia. Pour les développeurs, les agents d’IA et toute personne créant des pipelines de contenu automatisés, ce changement de contexte est une source de friction qui s’accumule rapidement.

PixVerse CLI élimine ce goulot d’étranglement. L’interface officielle en ligne de commande donne accès aux flux de génération et aux espaces de travail PixVerse directement depuis le terminal. Texte en vidéo, image en vidéo, texte en image, image en image, transitions, voix, musique, vidéo à partir de références, contrôle du mouvement, modèles prédéfinis, augmentation de résolution et gestion des ressources peuvent tous être scriptés et reliés par des pipes, sans passer par un navigateur. Elle intègre le flux du générateur vidéo IA de PixVerse aux scripts et aux chaînes d’agents. Pour l’installation la plus courte et un aperçu de la configuration des agents, commencez par la page officielle de PixVerse CLI.

Ce qui rend PixVerse CLI particulièrement utile, c’est sa philosophie de conception : il a été conçu en pensant aux agents IA. Les commandes peuvent renvoyer un JSON structuré avec --json ou -p, les codes de sortie sont déterministes et chaque étape du pipeline est composable. Cela signifie que vous pouvez apprendre à Claude Code, Cursor, Codex ou à tout autre agent à générer des images, des vidéos, de la voix et de la musique en votre nom avec moins de transferts fragiles.

Ce guide est aligné sur le PixVerseAI/cli GitHub README actuel, son manifeste de capacités public et la page produit de PixVerse CLI, vérifiés le 13 juillet 2026. PixVerse CLI est mis à jour en continu via le dépôt GitHub. Les scripts de production doivent donc toujours vérifier pixverse --version, pixverse create <mode> --help et pixverse update avant une exécution par lots volumineux.

Conditions préalables

Avant de commencer, il vous faut :

  • Node.js 20 ou supérieur — vérifiez avec node --version
  • Un compte PixVerse— inscrivez-vous sur pixverse.ai
  • Un abonnement PixVerse actif— le CLI utilise le même système de crédit que le site Web ; seuls les utilisateurs abonnés peuvent générer du contenu

PixVerse CLI ne nécessite aucune copie manuelle des clés API. L’authentification est gérée via un flux OAuth basé sur un navigateur qui stocke votre jeton localement.

Étape 1 : Installez le CLI

Installez globalement avec npm :

npm install -g pixverse

Vérifiez l’installation :

pixverse --version

Si vous préférez ne pas installer globalement, vous pouvez également exécuter des commandes via npx :

npx pixverse create video --prompt "A cat walking on Mars"

Étape 2 : Authentifier

Exécutez la commande de connexion :

pixverse auth login

Le CLI ouvre un navigateur pour l’autorisation d’appareil OAuth. Vous pouvez aussi copier l’URL et terminer l’autorisation depuis le navigateur de n’importe quel appareil, ce qui est utile pour les environnements SSH et sans interface graphique. Votre jeton est automatiquement stocké dans ~/.pixverse/ et reste valable 30 jours.

Pour vérifier que vous êtes connecté et vérifier vos crédits disponibles :

pixverse auth status pixverse account info pixverse account slots

La commande account info affiche votre niveau d’abonnement, les crédits de l’espace de travail et le contexte d’utilisation. pixverse account usage permet d’examiner la consommation de crédits ; pixverse account slots affiche les places disponibles pour les générations simultanées d’images et de vidéos. Les sessions CLI sont indépendantes des sessions web et application PixVerse. Vous pouvez supprimer le jeton CLI stocké avec pixverse auth logout. Vérifiez toujours le solde et les places disponibles avant de lancer des lots.

Commandes de démarrage rapide

Pour le chemin le plus court entre l’installation et une ressource générée, commencez par cette séquence :

npm install -g pixverse
pixverse auth login
pixverse create image --prompt "A photorealistic forest path at golden hour" --json
pixverse create video --prompt "A sunset over ocean waves" --model v6 --quality 720p --duration 5 --json

Pour les workflows d’agent et de CI, laissez --json ou -p activés afin que stdout reste lisible par machine tandis que la progression et les erreurs restent sur stderr. Pour les tentatives de production, ajoutez --idempotency-key <key> aux commandes de création afin que les soumissions répétées ne créent pas accidentellement des tâches facturées en double.

Étape 3 : Générez votre première image

La génération de texte en image est le moyen le plus rapide de tester votre configuration. Exécutez :

pixverse create image --prompt "A photorealistic forest path at golden hour" --json

Le GitHub README actuel répertorie GPT Image 2 comme modèle d’image par défaut. Pour des automatisations reproductibles, définissez toujours --model explicitement et consultez l’aide en direct de CLI ou capabilities.json avant le travail par lots. L’indicateur --json renvoie une sortie structurée :

{ "image_id": 789012, "status": "completed", "image_url": "https://...", "prompt": "A photorealistic forest path at golden hour", "model": "gpt-image-2.0", "width": 1440, "height": 1440 }

Pour une sortie à plus haute résolution, spécifiez un modèle qui la prend en charge :

pixverse create image \ --prompt "A photorealistic forest path at golden hour" \ --model seedream-5.0-lite \ --quality 2160p \ --aspect-ratio 16:9 \ --json

PixVerse prend en charge plusieurs modèles d’image, chacun avec des plafonds de résolution et des formats d’image différents :

Modèle Valeur de --model Qualité Remarques
GPT Image 2 gpt-image-2.0 1080p, 1440p, 2160p Modèle d’image par défaut ; prend en charge les formats d’image larges et hauts
Nano Banana 2 gemini-3.1-flash 512p, 1080p, 1440p, 2160p auto flexible et formats d’image standard
Nano Banana 2 Lite gemini-3.1-flash-lite 1080p Option Nano Banana 2 légère pour les workflows d’image rapides
Qwen Image qwen-image 720p, 1080p Génération rapide pour les tâches créatives courantes
Nano Banana Pro gemini-3.0 1080p, 1440p, 2160p Création d’images de haute qualité dans des tailles plus grandes
Nano Banana gemini-2.5-flash 1080p Génération d’images légère avec un délai d’exécution rapide
Seedream 5.0 Pro seedream-5.0-pro 1080p, 1440p Prend en charge les formats standard et les workflows avec plusieurs images de référence
Seedream 5.0 Lite seedream-5.0-lite 1440p, 1800p, 2160p Images créatives très détaillées
Seedream 4.5 seedream-4.5 1440p, 2160p Génération d’images haute résolution
Seedream 4.0 seedream-4.0 1080p, 1440p, 2160p Option Seedream supplémentaire pour les flux de travail d’images
Kling Image O3 kling-image-o3 1080p, 1440p, 2160p Résultats visuels stylisés avec un cadrage flexible
Kling Image V3 kling-image-v3 1080p, 1440p Qualité et vitesse équilibrées

Vous pouvez également transformer une image existante avec image en image :

pixverse create image \ --prompt "Turn this product photo into a clean watercolor illustration" \ --image ./product-photo.png \ --model gpt-image-2.0 \ --json

Pour télécharger l’image générée :

pixverse asset download 789012

Étape 4 : générez votre première vidéo

La conversion texte-vidéo fonctionne de la même manière. Générez un clip de 5 secondes :

pixverse create video --prompt "A sunset over ocean waves" --json

Pour une génération entièrement personnalisée :

pixverse create video \ --prompt "A cinematic drone shot over a misty mountain valley at dawn" \ --model v6 \ --quality 1080p \ --aspect-ratio 16:9 \ --duration 8 \ --audio \ --json

L’option --audio active une ambiance sonore générée par l’IA qui correspond au contenu vidéo. L’option --json renvoie à la fin un champ video_url, à transmettre directement à une commande de téléchargement ou à l’étape suivante d’une chaîne de traitement.

PixVerse propose plusieurs modèles vidéo avec différentes qualités, durées et modes de prise en charge :

Modèle Valeur de --model Qualité maximale Durée Remarques
PixVerse V6 v6 1080p 1 à 15 secondes Modèle vidéo par défaut ; large prise en charge des formats d’image
PixVerse C1 pixverse-c1 1080p 1 à 15 secondes Prise en charge solide des flux de travail vidéo, de référence et de transition
Seedance 2.0 Standard seedance-2.0-standard 2160p 4 à 15 secondes Prend en charge les modes vidéo, référence et transition
Seedance 2.0 Fast seedance-2.0-fast 720p 4 à 15 secondes Option Seedance plus rapide pour les modes vidéo, référence et transition
Seedance 2.0 Mini seedance-2.0-mini 720p 4 à 15 secondes Option Seedance légère pour les modes vidéo, référence et transition
Google Gemini Omni gemini-omni-flash 720p 3 à 10 secondes Prend en charge les workflows vidéo et de référence en 16:9 ou 9:16
Happy Horse 1.0 happyhorse-1.0 1080p 3 à 15 secondes Option vidéo compatible audio disponible pour le create video
Kling O3 Pro kling-o3-pro 720p 3 à 15 secondes Prend en charge les flux de travail vidéo, de référence et de transition
Kling O3 Standard kling-o3-standard 720p 3 à 15 secondes Option Kling O3 standard
Kling 3.0 Pro kling-3.0-pro 720p 3 à 15 secondes Prend en charge les flux de travail vidéo et de transition
Kling 3.0 Standard kling-3.0-standard 720p 3 à 15 secondes Option Kling 3.0 standard
Grok Imagine 1.5 grok-imagine-1.5 1080p 1 à 15 secondes Image vers vidéo uniquement ; nécessite --image et suit le rapport hauteur/largeur de l’image d’entrée
Grok Imagine grok-imagine 720p 1 à 15 secondes Option Grok antérieure ; prend en charge les flux de travail vidéo, d’extension et de référence
Veo 3.1 Lite veo-3.1-lite 1080p 4, 6 ou 8 secondes Prend en charge les flux de travail de transition vidéo et à 2 images
Veo 3.1 Standard veo-3.1-standard 2160p 4, 6 ou 8 secondes Option Veo haute résolution
Veo 3.1 Fast veo-3.1-fast 2160p 4, 6 ou 8 secondes Option Veo plus rapide
Sora 2 Pro sora-2-pro 1080p 4, 8 ou 12 secondes Option historique ; API fermée le 24 septembre 2026
Sora 2 sora-2 720p 4, 8 ou 12 secondes Option historique ; API fermée le 24 septembre 2026
PixVerse v5.6 v5.6 1080p 1 à 10 secondes Toujours utilisé pour le contrôle du mouvement et certains flux de génération
PixVerse v5.5 v5.5 1080p 1 à 10 secondes Utilisé pour les flux de travail create modify
PixVerse v5 v5 1080p 1 à 10 secondes Utilisé pour les transitions avec au moins 3 images

Animer une image statique

Pour transformer une photo ou une image générée en vidéo, fournissez le drapeau --image :

pixverse create video \ --prompt "Gentle wind moves through the scene" \ --image ./product-photo.jpg \ --model v6 \ --quality 1080p \ --json

Vous pouvez transmettre un chemin de fichier local ou une URL. Les fichiers locaux sont téléversés automatiquement, sans étape manuelle. Les images locales dépassant 1920x1920 ou 5MB sont automatiquement redimensionnées ou compressées avant le téléversement ; les URL distantes sont validées telles quelles par le serveur.

Pour Grok Imagine 1.5, une image est requise et le rapport hauteur/largeur de sortie suit cette image :

pixverse create video \ --prompt "Slow camera push-in, subtle fabric motion, clean native ambience" \ --image ./campaign-poster.png \ --model grok-imagine-1.5 \ --quality 720p \ --duration 6 \ --json

Utiliser la référence, la transition, le contrôle de mouvement et les modèles

Le CLI actuel prend en charge bien plus que de simples conversions de texte en vidéo et d’image en vidéo. Ces modes de création sont utiles lorsque vous avez besoin de plus de contrôle sur les personnages, les images clés, les modifications ou les effets :

# Create a transition between keyframes pixverse create transition --images ./frame1.png ./frame2.png # Generate speech audio from text pixverse create voice --text "Welcome to the launch" --voice-id <preset_voice_id> --output ./voiceover.mp3 # Generate music from a prompt pixverse create music --prompt "A cinematic synth-pop intro with bright percussion" --auto-lyrics pixverse create music --prompt "Uplifting piano theme for a product reveal" --instrumental --duration-seconds 60 # Extend a generated video pixverse create extend --video <video_id> # Modify an existing video pixverse create modify --video <video_id> --prompt "Change the background to a beach" # Upscale video resolution pixverse create upscale --video <video_id> --quality 1080p # Generate video with reference images pixverse create reference --images ./char1.png ./char2.png --prompt "Two friends walking in a park" # Seedance 2.0 reference can mix image and video inputs pixverse create reference \ --model seedance-2.0-standard \ --images ./character.png \ --videos ./motion.mp4 \ --prompt "@image1 follows the motion in @video1" # Seedance 2.0 models support up to 9 reference images pixverse create reference \ --model seedance-2.0-standard \ --images ./char1.png ./char2.png ./char3.png ./char4.png \ --prompt "@image1 and @image2 walk through the scene together" # Motion control with a character image and motion reference video pixverse create motion-control --image ./character.png --video ./dance.mp4 # Create from a template or effect pixverse create template --template-id 12345 --image ./photo.png

Tous les modèles ne prennent pas en charge tous les modes. Dans la matrice du README, create video liste v6, pixverse-c1, Seedance 2.0 Standard/Fast/Mini, Google Gemini Omni, Happy Horse 1.0, Kling O3, Kling 3.0, Grok Imagine, Veo 3.1, Sora 2 et v5.6 ; l’entrée Sora 2 est historique puisque son API a fermé le 24 septembre 2026. grok-imagine-1.5 sert uniquement à l’image en vidéo et exige --image ; create extend accepte v6 et grok-imagine ; create reference accepte v6, pixverse-c1, Seedance 2.0 Standard/Fast/Mini, Google Gemini Omni, Kling O3, grok-imagine et v5.6. Les transitions à 2 images acceptent les familles vidéo récentes ; les transitions à au moins 3 images utilisent v5 ; create modify utilise v5.5 et create motion-control utilise v5.6.

Étape 5 : générer de la voix et de la musique

Le GitHub README actuel documente l’audio autonome via des commandes de création dédiées. Utilisez create voice pour la synthèse vocale et create music pour la génération de prompts en musique. Les sorties vocales et musicales sont enregistrées en tant que ressources audio, vous pouvez donc les suivre avec task, les répertorier avec asset list --type audio et les télécharger avec asset download --type audio. Pour une ambiance vidéo native, utilisez --audio ou --no-audio sur les commandes de création vidéo prises en charge.

Générer de l’audio vocal :

pixverse create voice \ --text "Welcome to the launch. Here is what changed this week." \ --model speech-2.8-hd \ --voice-id <preset_voice_id> \ --output ./voiceover.mp3 \ --json

Parcourez les modèles vocaux et les voix prédéfinies :

pixverse voice models --json pixverse voice presets --model speech-2.8-hd --json

Générer de la musique :

pixverse create music \ --prompt "A bright cinematic synth-pop track for a 30-second product reveal" \ --auto-lyrics \ --duration-seconds 30 \ --json

Pour les pistes instrumentales, utilisez --instrumental. Pour les modèles compatibles avec les paroles, transmettez les paroles sous forme de texte littéral, de chemin de fichier local ou de stdin :

pixverse create music \ --prompt "Uplifting electronic pop with a confident chorus" \ --lyrics ./lyrics.txt \ --json

Les familles de modèles vocaux actuelles incluent les modèles MiniMax Speech 2.8 et ElevenLabs. Les familles de modèles musicaux actuelles incluent MiniMax Music, ElevenLabs Music et Google Lyria 3 Pro. Utilisez pixverse voice models et pixverse music models pour le catalogue en direct avant de créer un script pour un flux de production.

Étape 6 : Exécutez l’assistant interactif

Si vous explorez pour la première fois et n’êtes pas encore familier avec tous les indicateurs disponibles, exécutez n’importe quelle commande de création sans arguments pour accéder à l’assistant guidé :

pixverse create video pixverse create image

L’assistant vous guide étape par étape dans le prompt, le choix du modèle, la qualité, le format d’image, la durée et les autres options. Vous découvrez ainsi les paramètres disponibles avant de les intégrer à un script.

Au-delà de la génération : gérez vos ressources et votre espace de travail

Le PixVerse CLI actuel comprend également des commandes de gestion qui vous aident à créer des flux de travail de terminal de bout en bout :

  • pixverse task status <id> et pixverse task wait <id> pour l’interrogation des tâches
  • pixverse task status --ids 123,456,789 --type video --json pour les contrôles d’état des lots
  • pixverse asset list, asset upload, asset info, asset download et asset delete pour gérer le cycle de vie des ressources vidéo, image et audio
  • pixverse saved list, saved items, saved new, saved rename, saved add, saved remove et saved delete pour les dossiers enregistrés
  • pixverse template categories, template list, template search et template info pour découvrir des effets et des modèles
  • pixverse voice models, voice presets et music models pour la découverte de modèles audio en direct
  • pixverse workspace list, workspace status, workspace switch et workspace manage pour les opérations multi-espaces de travail
  • pixverse account info, account usage et account slots pour vérifier les crédits, l’utilisation et la capacité de génération simultanée
  • pixverse config set, config list, config path et config defaults pour des valeurs par défaut locales reproductibles

Cela facilite l’automatisation non seulement de la création, mais également de l’organisation, de la découverte de modèles, de la découverte audio, du téléchargement, du routage de l’espace de travail et de la livraison dans un seul script. Si vous devez exécuter une commande sur un autre espace de travail, utilisez l’indicateur global --workspace-id <id> ; 0 cible votre espace de travail personnel.

Indicateurs adaptés aux scripts

La plupart des automatisations dépendent d’une sortie prévisible et d’un comportement d’exécution prévisible. Ces indicateurs sont particulièrement utiles dans les scripts et les workflows des agents IA :

Option Utilisation
--json Renvoie une sortie JSON structurée
-p Alias court pour --json
--count <n> Générez 1 à 4 variantes à partir d’une seule demande
--seed <number> Rendre une génération plus facile à reproduire
--off-peak Utilisez les tarifs hors pointe lorsqu’ils sont disponibles
--audio / --no-audio Activer ou désactiver la génération audio sur les commandes de création prises en charge
--multi-shot / --no-multi-shot Activer ou désactiver le mode multi-plans vidéo
--no-wait Soumettez le travail et revenez immédiatement
--timeout <sec> Définir le délai d’attente de l’interrogation, par défaut sur 300 secondes
--workspace-id <id> Remplacer l’espace de travail actif pour une seule commande
--trace-id <uuid> Attachez un UUIDv4 fourni par l’appelant aux requêtes API pour le débogage et l’observabilité
--idempotency-key <key> Réessayez en toute sécurité les demandes de création sans créer accidentellement des tâches facturées en double

Les indicateurs de saisie de texte sont désormais plus faciles à automatiser. --prompt, --text et --lyrics peuvent accepter une chaîne littérale, un chemin de fichier local ou - pour stdin :

pixverse create video --prompt ./scene.txt --json cat scene.txt | pixverse create image --prompt - --json echo "Hello from the command line" | pixverse create voice --text - --json pixverse create music --prompt "Bright synth-pop" --lyrics ./lyrics.txt --json

Apprendre à votre agent IA à générer des médias

Pour les équipes qui préfèrent un point de départ guidé dans l’application avant l’automatisation en ligne de commande, PixVerse Agent propose un flux de création orienté agent dans l’application PixVerse.

C’est là que PixVerse CLI devient véritablement transformateur. Étant donné que les commandes peuvent renvoyer un JSON structuré et utiliser des codes de sortie déterministes, tout agent IA capable d’exécuter des commandes shell peut apprendre à générer des images et des vidéos à la demande.

Installation de PixVerse Skills

PixVerse Skills est une bibliothèque structurée de compétences qui apprend aux agents à utiliser le CLI correctement : options de commande, contraintes des modèles, chaînes de traitement en plusieurs étapes et gestion robuste des erreurs.

Pour Claude Code et les autres agents prenant en charge le format de compétences, ajoutez directement les compétences PixVerse :

npx skills add https://github.com/pixverseai/skills --skill pixverse-ai-image-and-video-generator

Pour Cursor, Claude Code, Codex et d’autres frameworks d’agents, cette compétence améliore la fiabilité en donnant à l’agent des contraintes explicites au lieu de l’obliger à les déduire à partir de zéro.

PixVerse CLI fournit aussi un manifeste compact de commandes lisible par machine dans dist/capabilities.json. Sa source publique, capabilities.json, se trouve dans le dépôt GitHub. Ce manifeste décrit les commandes, options, codes de sortie, sorties JSON attendues et catégories d’effets : les agents peuvent inspecter le contrat du CLI sans extraire ces informations du texte d’aide.

Une fois que votre agent a chargé les compétences PixVerse, vous pouvez lui donner des instructions en langage naturel telles que :

  • “Generate a 10-second product demo video from this screenshot”
  • “Create four variations of this blog cover image in 16:9 format”
  • “Animate this diagram into a 5-second explainer clip with ambient sound”
  • “Generate three 8-second 16:9 promo clips with different camera motions”

L’agent traduira ces instructions en commandes CLI correctes, analysera la sortie JSON et gérera les interrogations et les téléchargements — aucune intervention manuelle n’est requise.

Claude Code

Dans Claude Code, PixVerse CLI devient un outil natif que l’agent utilise de manière autonome. Après avoir chargé les compétences PixVerse, vous pouvez inclure la génération de médias directement dans n’importe quelle tâche :

Generate a cover image for this blog post about machine learning, use the seedream-5.0-lite model at 2160p in 16:9 format, download it to ./assets/cover.webp

Claude Code appellera les commandes CLI correctes, analysera l’URL de l’image à partir de la réponse JSON et téléchargera le fichier sur votre chemin spécifié, le tout au cours de la même session où il écrit également votre code.

Un flux de travail Claude Code typique :

# Claude Code runs this autonomously based on your instruction IMG=$(pixverse create image \ --prompt "Abstract visualization of neural network layers, dark background, blue and purple tones" \ --model seedream-5.0-lite \ --quality 2160p \ --aspect-ratio 16:9 \ --json | jq -r '.image_url') # Then animates it pixverse create video \ --prompt "Slow pan across glowing neural connections" \ --image "$IMG" \ --model v6 \ --quality 1080p \ --duration 6 \ --json

Cursor

Les utilisateurs de Cursor peuvent charger PixVerse Skills en tant que fichier de contexte de projet. Placez les fichiers de compétences pertinents dans votre répertoire .cursor/ ou ajoutez-les aux règles de votre espace de travail. Une fois chargé, Cursor connaît parfaitement chaque commande PixVerse CLI et peut générer des médias dans le cadre de n’importe quelle tâche de codage.

Un flux de travail Cursor courant : demandez à l’agent de générer une image de maquette basée sur une conception que vous créez, puis utilisez-la comme référence directement dans votre session IDE, sans jamais quitter l’éditeur.

Codex et autres agents

PixVerse CLI est compatible avec tout agent capable d’exécuter des commandes shell et d’analyser JSON. Le format de sortie structuré (noms de champs cohérents, codes d’erreur prévisibles et messages d’erreur séparés par stderr) garantit que même les agents de script simples peuvent intégrer la génération de manière fiable.

Le contrat de code de sortie simplifie la gestion des erreurs :

Code Signification Action de l’agent
0 Succès Analyser la sortie JSON
1 Erreur générale Vérifiez stderr et réessayez avec des entrées validées
2 Délai d’attente Réessayez avec un --timeout plus long
3 Authentification expirée Réexécutez pixverse auth login
4 Plus de crédits Vérifier le solde, informer l’utilisateur
5 La génération a échoué Essayez différents paramètres
6 Erreur de validation Vérifier les valeurs des indicateurs

Pipelines d’automatisation

Une fois que vous comprenez les commandes individuelles, PixVerse CLI débloque de puissants flux de travail en plusieurs étapes qui s’exécutent entièrement sans interaction de l’utilisateur.

Texte en image en vidéo

L’un des pipelines les plus utiles : générer une image haute résolution à partir d’un prompt de texte, puis l’animer en vidéo.

# Step 1: Generate a base image IMG_RESULT=$(pixverse create image \ --prompt "A cyberpunk cityscape at night, neon lights reflecting on wet pavement" \ --model gemini-3.1-flash \ --quality 2160p \ --aspect-ratio 16:9 \ --json) IMAGE_URL=$(echo "$IMG_RESULT" | jq -r '.image_url') # Step 2: Animate it into a video VID_RESULT=$(pixverse create video \ --prompt "Camera slowly pans across the neon-lit streets" \ --image "$IMAGE_URL" \ --model v6 \ --quality 1080p \ --duration 8 \ --json) VIDEO_ID=$(echo "$VID_RESULT" | jq -r '.video_id') # Step 3: Download the final video pixverse asset download "$VIDEO_ID" --json

Pipeline de production vidéo complet

Pour un résultat soigné, enchaînez la création avec les étapes de post-traitement. Utilisez --audio ou --no-audio pour le son natif dans les commandes vidéo compatibles, puis create voice pour la synthèse vocale et create music pour les ressources musicales autonomes à combiner ensuite :

# Step 1: Create the base video RESULT=$(pixverse create video \ --prompt "A product being assembled in slow motion" \ --model v6 \ --quality 720p \ --duration 5 \ --audio \ --json) VID=$(echo "$RESULT" | jq -r '.video_id') # Step 2: Extend duration EXTENDED=$(pixverse create extend \ --video "$VID" \ --json | jq -r '.video_id') pixverse task wait "$EXTENDED" --json # Step 3: Upscale to 1080p FINAL=$(pixverse create upscale \ --video "$EXTENDED" \ --quality 1080p \ --json | jq -r '.video_id') pixverse task wait "$FINAL" --json # Step 4: Download pixverse asset download "$FINAL" --json # Optional: create a separate voiceover asset pixverse create voice \ --text "The final reveal starts now." \ --voice-id <preset_voice_id> \ --output ./voiceover.mp3 \ --json

Génération par lots

Pour les pipelines de contenu qui nécessitent plusieurs variantes, exécutez les tâches en parallèle :

# Check credits and concurrent generation slots first pixverse account info --json pixverse account slots --json # Submit four parallel generations pixverse create video --prompt "Sunrise over mountains" --no-wait --json > /tmp/v1.json & pixverse create video --prompt "Sunset over ocean" --no-wait --json > /tmp/v2.json & pixverse create video --prompt "Stars over a desert" --no-wait --json > /tmp/v3.json & pixverse create video --prompt "Aurora over a frozen lake" --no-wait --json > /tmp/v4.json & wait # Check all returned task IDs in one batch status call IDS=$(jq -r '.video_id' /tmp/v1.json /tmp/v2.json /tmp/v3.json /tmp/v4.json | paste -sd, -) pixverse task status --ids "$IDS" --type video --json # Wait for each and download for f in /tmp/v1.json /tmp/v2.json /tmp/v3.json /tmp/v4.json; do ID=$(jq -r '.video_id' "$f") pixverse task wait "$ID" --json pixverse asset download "$ID" --json done

L’indicateur --no-wait soumet le travail et revient immédiatement avec un ID de tâche, vous permettant de soumettre plusieurs travaux avant l’interrogation. Avec --no-wait --json, enregistrez les ID de tâches renvoyés et les paramètres de création résolus pour la journalisation et la reproductibilité. Utilisez --count <n> lorsque vous souhaitez plusieurs variantes à partir d’un seul prompt et utilisez le lot task status --ids lorsque vous souhaitez une réponse d’état pour plusieurs tâches en cours d’exécution. La commande pixverse task wait gère l’interrogation adaptative pour vous.

Configuration des valeurs par défaut

Si vous utilisez systématiquement le même modèle, la même qualité ou le même rapport hauteur/largeur, définissez-les par défaut afin de ne pas avoir à répéter les indicateurs à chaque fois :

pixverse config defaults set video model v6 pixverse config defaults set video quality 1080p pixverse config defaults set image model seedream-5.0-lite pixverse config set output-dir ~/Downloads/pixverse pixverse config defaults show pixverse config list pixverse config path

Les indicateurs de ligne de commande remplacent toujours vos valeurs par défaut configurées, afin que vous conserviez une flexibilité totale tout en réduisant les répétitions. Pour une automatisation spécifique à l’espace de travail, ajoutez --workspace-id <id> à une commande lorsque vous souhaitez remplacer l’espace de travail actif pour cette exécution unique.

Ce que vous pouvez construire

Avec PixVerse CLI intégré au flux de travail de votre agent, la gamme de tâches automatisables s’étend considérablement :

  • Documentation — Générez automatiquement des démos vidéo et captures d’écran pendant la compilation de votre documentation.
  • Marketing — Lancez des lots nocturnes produisant des variantes de contenus pour les réseaux sociaux à partir d’une seule bibliothèque de prompts.
  • Développement d’applications — Laissez votre agent de programmation générer des visuels provisoires, des maquettes animées ou des vidéos d’écran de chargement pendant la création de l’interface.
  • Flux audio — Générez des ébauches de voix off, des morceaux à partir de prompts ou des ressources audio à monter plus tard.
  • Pipelines de contenu: chaînez les appels CLI avec d’autres outils (ffmpeg, ImageMagick, stockage cloud) pour créer des flux de production multimédia entièrement automatisés
  • Prototypage — Générez des concepts de mouvement en quelques secondes pour valider vos idées avant une production complète.

Le CLI est conçu pour s’intégrer naturellement dans tout flux de travail basé sur un shell. Si votre automatisation existante s’exécute dans bash, Python, Node ou un pipeline CI/CD, PixVerse CLI s’intègre sans aucune surcharge d’intégration supplémentaire.

Liste de contrôle pour démarrer

  • Installez Node.js 20 ou supérieur
  • Exécutez npm install -g pixverse
  • Exécutez pixverse auth login et autorisez dans le navigateur
  • Exécutez pixverse account info pour vérifier les crédits
  • Exécutez pixverse account slots avant le travail par lots simultané
  • Générez votre première image : pixverse create image --prompt "..." --json
  • Générez votre première vidéo : pixverse create video --prompt "..." --json
  • Générez votre première ressource vocale : pixverse create voice --text "..." --json
  • Générez votre première ressource musicale : pixverse create music --prompt "..." --json
  • Explorez les modèles avec pixverse template list
  • Installez PixVerse Skills pour votre agent (Claude Code, Cursor ou Codex)
  • Configurez vos paramètres par défaut préférés avec pixverse config defaults set
  • Créez votre premier pipeline d’automatisation

Garder le CLI à jour

Utilisez le programme de mise à jour intégré pour maintenir votre CLI local à jour :

pixverse update

Vous pouvez également utiliser npm directement :

npm install -g pixverse@latest

PixVerse CLI est un outil activement mis à jour, et non un lancement ponctuel. Considérez donc cet article comme un guide pratique et les sources officielles comme la couche de référence en direct. La page officielle de PixVerse CLI est le chemin le plus court pour l’installation et l’onboarding des agents, tandis que GitHub reste l’endroit où suivre les changements de version et les modèles nouvellement pris en charge :

La documentation actuelle met en évidence PixVerse V6 comme modèle vidéo par défaut, GPT Image 2 comme modèle d’image par défaut, la prise en charge vidéo de Google Gemini Omni, la prise en charge image de Nano Banana 2 Lite et Seedream 5.0 Pro, la prise en charge de Seedance 2.0 Mini, les flux de travail PixVerse v5 et v5.5 spécifiques au mode, les commandes create voice et create music dédiées, la gestion des ressources audio, les dossiers enregistrés, le changement d’espace de travail, config defaults, capabilities.json pour les agents, pixverse update, la prise en charge stdin pour les entrées de texte, --trace-id et --idempotency-key pour des tentatives plus sûres.

Prochaines étapes

La page officielle de PixVerse CLI, PixVerse CLI sur GitHub et npm (npm install -g pixverse) donnent accès depuis une seule interface à la génération, au suivi des tâches, à la gestion des ressources, aux modèles prédéfinis, aux dossiers enregistrés, aux vérifications du compte, à la découverte des modèles audio et aux espaces de travail. Le dépôt PixVerse Skills ajoute des consignes destinées aux agents pour permettre à Claude Code, Cursor, Codex et aux autres outils d’exécuter ces flux de manière plus fiable.

La combinaison d’un CLI fiable et d’une bibliothèque de compétences prête pour l’agent signifie que la génération d’images, de vidéos, de voix et de musique peut vivre dans le même flux de travail que votre code — géré par le même agent, dans le même terminal, sans changer d’outil.

Commencez par une seule commande. Construisez à partir de là.