PixVerse CLI : génération vidéo et image IA pour développeurs

Introduction

Chaque workflow créatif rencontre un goulot d’étranglement : le moment où vous devez quitter votre éditeur, ouvrir un navigateur et cliquer manuellement dans une interface web pour générer un média. Pour les développeurs, les agents IA et les équipes qui bâtissent des pipelines de contenu automatisés, ce changement de contexte crée une friction qui augmente vite.

PixVerse CLI supprime ce goulot d’étranglement. C’est l’interface en ligne de commande officielle de PixVerse, qui vous donne accès à tous les modèles, toutes les fonctions et toutes les capacités de la plateforme PixVerse, directement depuis votre terminal. Texte vers vidéo, image vers vidéo, texte vers image, synchronisation labiale, effets sonores, upscaling : tout est scriptable, chaînable et disponible sans passer par le navigateur.

Ce qui rend PixVerse CLI particulièrement puissant, c’est sa philosophie de conception : il a été pensé pour les agents IA. Chaque commande renvoie un JSON structuré, chaque code de sortie est déterministe et chaque étape du pipeline est composable. Vous pouvez donc apprendre à Claude Code, Cursor, Codex ou tout autre agent à générer des images et des vidéos pour vous, avec des résultats corrects à chaque exécution.

Ce guide vous accompagne sur tout le parcours : de l’installation à la première génération, puis vers des pipelines d’automatisation en plusieurs étapes et des workflows natifs pour agents.

Prérequis

Avant de commencer, vous avez besoin de :

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

PixVerse CLI ne demande aucune copie manuelle de clé API. L’authentification passe par un flux OAuth via navigateur qui stocke votre token localement.

Étape 1 : Installer le CLI

Installez-le globalement avec npm :

npm install -g pixverse

Vérifiez l’installation :

pixverse --version

Si vous préférez éviter une installation globale, vous pouvez aussi exécuter les commandes avec npx :

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

Étape 2 : S’authentifier

Lancez la commande de connexion :

pixverse auth login

Le CLI ouvre un navigateur pour l’autorisation OAuth device. Vous pouvez également copier l’URL et terminer l’autorisation depuis n’importe quel navigateur sur n’importe quel appareil, ce qui est utile en environnement SSH ou headless. Votre token est enregistré automatiquement dans ~/.pixverse/ et reste valide 30 jours.

Pour vérifier votre connexion et vos crédits disponibles :

pixverse auth status
pixverse account info

La commande account info affiche votre niveau d’abonnement, les crédits restants et le calendrier de réinitialisation quotidienne des crédits. Vérifiez toujours votre solde avant de lancer des jobs batch.

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

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

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

Le flag --json retourne une sortie structurée :

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

Pour une sortie en plus haute résolution, choisissez 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 1800p \
  --aspect-ratio 16:9 \
  --json

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

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

pixverse asset download 789012

Étape 4 : Générer votre première vidéo

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

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

PixVerse propose plusieurs modèles vidéo avec des capacités différentes :

Animer une image statique

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

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

Vous pouvez fournir un chemin local ou une URL. Les fichiers locaux sont téléversés automatiquement, sans étape manuelle d’upload.

Étape 5 : Utiliser l’assistant interactif

Si vous découvrez l’outil et ne maîtrisez pas encore tous les flags disponibles, exécutez une commande de création sans argument pour entrer dans l’assistant guidé :

pixverse create video
pixverse create image

L’assistant vous guide étape par étape sur le prompt, le modèle, la qualité, le ratio, la durée et d’autres options. C’est utile pour découvrir les paramètres avant de les intégrer dans des scripts.

Au-delà de la génération : gérer assets et workspace

La version récente de PixVerse CLI inclut aussi des commandes de gestion qui vous permettent de construire des workflows terminal de bout en bout :

• pixverse task status <id> et pixverse task wait <id> pour le polling des tâches
• pixverse asset list|upload|info|download|delete pour les opérations de cycle de vie des assets
• pixverse saved list|items|new|rename|add|remove|delete pour les dossiers sauvegardés
• pixverse workspace list|status|switch|manage pour les opérations multi-workspace

Vous pouvez ainsi automatiser non seulement la création, mais aussi l’organisation, le téléchargement et la livraison dans un seul script.

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

C’est ici que PixVerse CLI devient réellement transformant. Comme chaque commande renvoie un JSON structuré et utilise 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.

Installer PixVerse Skills

PixVerse Skills est une bibliothèque de skills structurée qui apprend aux agents à utiliser correctement le CLI : flags de commande, contraintes de modèles, pipelines multi-étapes et gestion robuste des erreurs.

Pour Claude Code et les autres agents qui prennent en charge le format skills, ajoutez les skills PixVerse directement :

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 skill améliore la fiabilité en donnant des contraintes explicites à l’agent, au lieu de le laisser tout déduire depuis zéro.

Une fois les PixVerse Skills chargées, vous pouvez donner à votre agent des instructions en langage naturel comme :

• “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 polling et téléchargements, sans intervention manuelle.

Claude Code

Dans Claude Code, PixVerse CLI devient un outil natif que l’agent utilise de façon autonome. Après chargement des PixVerse Skills, vous pouvez intégrer la génération média 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 1800p in 16:9 format,
download it to ./assets/cover.webp

Claude Code exécutera les bonnes commandes CLI, extraira l’URL d’image depuis la réponse JSON et téléchargera le fichier vers le chemin indiqué, le tout dans la même session où il écrit votre code.

Un workflow typique dans Claude Code :

# 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 1800p \
  --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 comme fichier de contexte projet. Placez les fichiers de skill pertinents dans votre dossier .cursor/ ou ajoutez-les à vos règles de workspace. Une fois chargées, Cursor connaît l’ensemble des commandes PixVerse CLI et peut générer des médias dans le cadre de n’importe quelle tâche de développement.

Un workflow courant dans Cursor : demander à l’agent de générer une image de mockup basée sur votre design en cours, puis l’utiliser comme référence directement dans votre session IDE, sans quitter l’éditeur.

Codex et autres agents

PixVerse CLI est compatible avec tout agent capable d’exécuter des commandes shell et d’analyser du JSON. Le format de sortie structuré, avec des noms de champs cohérents, des codes d’erreur prévisibles et des messages d’erreur séparés sur stderr, garantit une intégration fiable, même pour des agents de scripting simples.

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

Pipelines d’automatisation

Une fois les commandes unitaires maîtrisées, PixVerse CLI débloque des workflows puissants en plusieurs étapes, exécutés entièrement sans interaction utilisateur.

Texte vers image vers vidéo

Un des pipelines les plus utiles : générer une image haute résolution depuis un prompt 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 complet de production vidéo

Pour une sortie plus aboutie, enchaînez la création avec des étapes de post-traitement :

# Step 1: Create the base video
RESULT=$(pixverse create video \
  --prompt "A product being assembled in slow motion" \
  --model v6 \
  --quality 720p \
  --duration 5 \
  --json)
 
VID=$(echo "$RESULT" | jq -r '.video_id')
 
# Step 2: Extend duration
EXTENDED=$(pixverse create extend \
  --video "$VID" \
  --prompt "Continue the assembly sequence" \
  --duration 5 \
  --json | jq -r '.video_id')
 
pixverse task wait "$EXTENDED" --json
 
# Step 3: Add ambient sound
WITH_SOUND=$(pixverse create sound \
  --video "$EXTENDED" \
  --prompt "Industrial workshop ambience, soft mechanical sounds" \
  --json | jq -r '.video_id')
 
pixverse task wait "$WITH_SOUND" --json
 
# Step 4: Upscale to 1080p
FINAL=$(pixverse create upscale \
  --video "$WITH_SOUND" \
  --quality 1080p \
  --json | jq -r '.video_id')
 
pixverse task wait "$FINAL" --json
 
# Step 5: Download
pixverse asset download "$FINAL" --json

Génération batch

Pour les pipelines de contenu qui exigent plusieurs variantes, exécutez les jobs en parallèle :

# Check credits first
CREDITS=$(pixverse account info --json | jq -r '.credits.total')
echo "Available credits: $CREDITS"
 
# 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
 
# 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

Le flag --no-wait soumet la tâche et renvoie immédiatement un identifiant, ce qui vous permet d’envoyer plusieurs jobs avant le polling. La commande pixverse task wait gère ce polling adaptatif pour vous, sans boucle manuelle avec sleep.

Configurer les valeurs par défaut

Si vous utilisez toujours le même modèle, la même qualité ou le même ratio, définissez-les en valeurs par défaut pour éviter de répéter les flags :

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

Les flags en ligne de commande gardent toujours la priorité sur les valeurs par défaut configurées, ce qui préserve votre flexibilité tout en réduisant les répétitions.

Ce que vous pouvez construire

Avec PixVerse CLI intégré à votre workflow agent, l’éventail des tâches automatisables s’élargit fortement :

• Documentation — générer automatiquement des vidéos de démo produit et des captures d’écran dans votre process de build documentaire
• Marketing — exécuter des batchs nocturnes qui produisent des variantes de contenus sociaux depuis une seule bibliothèque de prompts
• Développement applicatif — laisser votre agent de code produire des visuels placeholder, des animations mockup et des vidéos d’écran de chargement pendant que vous développez l’UI
• Pipelines de contenu — chaîner des appels CLI avec d’autres outils (ffmpeg, ImageMagick, cloud storage) pour créer des workflows média entièrement automatisés
• Prototypage — générer en quelques secondes des concepts de mouvement pour valider des idées avant de lancer une production complète

Le CLI est conçu pour s’intégrer naturellement à tout workflow shell. Si votre automatisation actuelle tourne sur bash, Python, Node ou un pipeline CI/CD, PixVerse CLI s’intègre sans surcharge supplémentaire.

Checklist de démarrage

• Installer Node.js 20 ou supérieur
• Exécuter npm install -g pixverse
• Exécuter pixverse auth login et autoriser dans le navigateur
• Exécuter pixverse account info pour vérifier les crédits
• Générer votre première image : pixverse create image --prompt "..." --json
• Générer votre première vidéo : pixverse create video --prompt "..." --json
• Installer PixVerse Skills pour votre agent (Claude Code, Cursor ou Codex)
• Configurer vos valeurs par défaut avec pixverse config defaults set
• Construire votre premier pipeline d’automatisation

Garder le CLI à jour

Utilisez npm pour maintenir votre CLI locale à jour :

npm update -g pixverse

Pour les nouveautés de release et les nouveaux modèles pris en charge, consultez le changelog officiel :

• PixVerse CLI Changelog

Prochaines étapes

PixVerse CLI sur npm (npm install -g pixverse) vous donne un accès immédiat à la génération, au polling des tâches, à la gestion d’assets, aux dossiers sauvegardés et aux contrôles de workspace depuis une interface unique. Le référentiel PixVerse Skills ajoute des guides prêts pour agents afin que Claude Code, Cursor, Codex et d’autres outils exécutent ces workflows avec une fiabilité renforcée.

La combinaison d’un CLI fiable et d’une bibliothèque de skills orientée agents permet d’intégrer la génération d’image et de vidéo dans le même workflow que votre code, géré par le même agent, dans le même terminal, sans changer d’outil.

Commencez par une commande. Développez à partir de là.