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. Il s’agit de l’interface de ligne de commande officielle pour PixVerse, vous donnant accès aux workflows de génération et d’espace de travail PixVerse directement depuis votre terminal. Le texte vers vidéo, l’image vers vidéo, le texte vers image, l’image vers image, les transitions, la génération vocale, la génération de musique, la vidéo de référence, le contrôle de mouvement, les modèles, la mise à l’échelle et la gestion des actifs sont tous scriptables, canalisables et disponibles sans toucher à un navigateur.

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 et son [manifeste de capacités] public (https://github.com/PixVerseAI/cli/blob/main/capabilities.json), vérifié le 29 juin 2026. La disponibilité des modèles, les modèles par défaut et les indicateurs de commande peuvent changer plus rapidement que les didacticiels permanents, 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 auprès de 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 :

Vérifiez l’installation :

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

Étape 2 : Authentifier

Exécutez la commande de connexion :

Le CLI ouvre un navigateur pour l’autorisation du périphérique OAuth. Vous pouvez également copier l’URL et terminer l’autorisation depuis n’importe quel navigateur sur n’importe quel appareil, ce qui est utile pour les environnements SSH et sans tête. Votre token est stocké automatiquement dans ~/.pixverse/ et est valable 30 jours.

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

La commande account info affiche votre niveau d’abonnement, les crédits d’espace de travail et le contexte d’utilisation. pixverse account usage vous aide à examiner la consommation de crédit, tandis que pixverse account slots affiche les emplacements de génération simultanée actuels pour les tâches d’image et de vidéo. Les sessions CLI sont indépendantes des sessions Web/application PixVerse et vous pouvez supprimer le jeton CLI stocké avec pixverse auth logout. Vérifiez toujours votre solde et les emplacements disponibles avant d’exécuter des tâches par lots.

Commandes de démarrage rapide

Si vous avez uniquement besoin du chemin le plus court entre l’installation et un actif généré, 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 :

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 :

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

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

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

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

É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 :

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

Le drapeau --audio active un son ambiant généré par l’IA qui correspond à votre contenu vidéo. L’indicateur --json renvoie un video_url à la fin que vous pouvez transmettre directement à une commande de téléchargement ou à l’étape suivante d’un pipeline.

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

Animer une image statique

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

Vous pouvez transmettre un chemin de fichier local ou une URL. Les fichiers locaux sont téléchargés automatiquement — aucune étape de téléchargement manuel n’est requise. Les entrées d’images locales plus grandes que 1920x1920 ou 5MB sont automatiquement redimensionnées ou compressées avant le téléchargement ; les URL des images distantes sont validées telles quelles par le backend.

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

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 :

Tous les modèles ne prennent pas en charge tous les modes de création. Dans la matrice README actuelle, create video prend en charge v6, pixverse-c1, Seedance 2.0 Standard/Fast/Mini, Happy Horse 1.0, Kling O3, Kling 3.0, Grok Imagine, Veo 3.1, Sora 2 et v5.6. grok-imagine-1.5 est une conversion image-vidéo uniquement et nécessite --image ; create extend prend en charge v6 et grok-imagine ; create reference prend en charge v6, pixverse-c1, Seedance 2.0 Standard/Fast/Mini, Kling O3, grok-imagine et v5.6 ; Les transitions à 2 images prennent en charge les familles vidéo les plus récentes ; Plus de 3 transitions d’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 d’invites 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 :

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

Générer de la musique :

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 :

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é :

L’assistant vous guide étape par étape à travers l’invite, la sélection du modèle, la qualité, le rapport hauteur/largeur, la durée et d’autres options, ce qui est utile pour découvrir les paramètres disponibles avant de les créer un script.

Au-delà de la génération : gérez vos actifs 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 les opérations du cycle de vie des actifs 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 les contrôles de crédit, d’utilisation et de concurrence
• 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 :

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 :

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

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 Skillsest une bibliothèque de compétences structurées qui enseigne aux agents comment utiliser correctement le CLI : indicateurs de commande, contraintes de modèle, pipelines 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 :

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 également un manifeste de commande compact lisible par machine sur dist/capabilities.json, avec la source publique disponible sous le nom capabilities.json dans le référentiel GitHub. Ce manifeste décrit les commandes, les indicateurs, les codes de sortie, les attentes de sortie JSON et les catégories d’effets, afin que les agents puissent inspecter le contrat CLI sans supprimer le 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 :

• “Générez une vidéo de démonstration du produit de 10 secondes à partir de cette capture d’écran”
• “Créez quatre variantes de cette image de couverture de blog au format 16:9”
• “Animez ce diagramme dans un clip explicatif de 5 secondes avec un son ambiant”
• “Générez trois clips promotionnels 16:9 de 8 secondes avec différents mouvements de caméra”

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 :

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 :

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 :

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’une invite de texte, puis l’animer en vidéo.

Pipeline de production vidéo complet

Pour une sortie soignée, création de chaîne avec étapes de post-traitement. Utilisez --audio ou --no-audio lorsque vous souhaitez un son natif sur les commandes de création vidéo prises en charge, puis utilisez create voice pour la synthèse vocale et create music pour les ressources musicales autonomes que vous combinerez en aval :

Génération par lots

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

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’une seule invite 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 :

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 vidéos de démonstration de produits et des captures d’écran dans le cadre du processus de création de votre document.
• Marketing: exécutez des tâches par lots nocturnes qui produisent des variations de contenu de médias sociaux à partir d’une seule bibliothèque d’invites.
• Développement d’applications: laissez votre agent de codage générer des visuels d’espace réservé, des animations de maquette ou des vidéos d’écran de chargement pendant que vous créez l’interface utilisateur.
• Flux de travail audio: générez des brouillons de voix off, des pistes d’invite de musique ou des ressources audio pour une édition ultérieure.
• 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 rapides en quelques secondes pour valider les idées avant de vous engager dans la 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 premier actif vocal : pixverse create voice --text "..." --json
• Générez votre premier actif musical : 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 :

Vous pouvez également utiliser npm directement :

Pour connaître les modifications apportées au niveau de la version et les modèles nouvellement pris en charge, consultez les sources officielles de CLI :

• Dépôt PixVerse CLI GitHub
• Manifeste des capacités PixVerse CLI
• Journal des modifications PixVerse CLI

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 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

Le PixVerse CLI sur GitHub et npm (npm install -g pixverse) vous donnent un accès immédiat à la génération, à l’interrogation des tâches, à la gestion des actifs, aux modèles, aux dossiers enregistrés, aux vérifications de compte, à la découverte de modèles audio et aux contrôles de l’espace de travail à partir d’une seule interface. Le [référentiel PixVerse Skills] (https://github.com/PixVerseAI/skills) ajoute des conseils prêts à l’emploi afin que Claude Code, Cursor, Codex et d’autres outils puissent exécuter ces flux de travail avec une plus grande fiabilité.

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à.