PixVerse CLI : Génération de Vidéos et d’Images IA pour les Développeurs

Introduction

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

PixVerse CLI élimine ce goulot d’étranglement. Il s’agit de l’interface en ligne de commande officielle de PixVerse, vous donnant accès à chaque modèle, chaque fonctionnalité et chaque capacité de la plateforme PixVerse — directement depuis votre terminal. Texte vers vidéo, image vers vidéo, texte vers image, synchronisation labiale, effets sonores, mise à l’échelle — tout est scriptable, tout est composable, tout est disponible sans toucher à un navigateur.

Ce qui rend PixVerse CLI particulièrement puissant, c’est sa philosophie de conception : il a été conçu en pensant aux agents IA. Chaque commande produit du JSON structuré, chaque code de sortie est déterministe et chaque étape de pipeline est composable. Cela signifie que vous pouvez apprendre à Claude Code, Cursor, Codex ou tout autre agent à générer des images et des vidéos en votre nom — et ils le feront correctement, à chaque fois.

Ce guide vous accompagne tout au long du parcours complet : de l’installation à votre première génération, puis vers des pipelines d’automatisation en plusieurs étapes et des flux de travail 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 — inscrivez-vous 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 nécessite pas de copier manuellement des clés API. L’authentification est gérée via un flux OAuth basé sur le navigateur qui stocke votre jeton 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 ne pas installer globalement, vous pouvez aussi exécuter les commandes via npx :

npx pixverse create video --prompt "Un chat qui marche sur Mars"

Étape 2 : S’authentifier

Exécutez la commande de connexion :

pixverse auth login

Le CLI affichera une URL courte et un code. Ouvrez l’URL dans votre navigateur, entrez le code et autorisez avec votre compte PixVerse. Votre jeton est stocké automatiquement dans ~/.pixverse/ et est valide pendant 30 jours.

Pour vérifier que vous êtes connecté et consulter 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 d’exécuter des tâches par lot.

Étape 3 : Générer votre Première Image

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

pixverse create image --prompt "Un chemin forestier photoréaliste à l'heure dorée" --json

L’option --json retourne une sortie structurée :

{
  "image_id": 789012,
  "status": "completed",
  "image_url": "https://...",
  "prompt": "Un chemin forestier photoréaliste à l'heure dorée",
  "model": "qwen-image",
  "width": 1024,
  "height": 1024
}

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

pixverse create image \
  --prompt "Un chemin forestier photoréaliste à l'heure dorée" \
  --model seedream-5.0-lite \
  --quality 1800p \
  --aspect-ratio 16:9 \
  --json

PixVerse prend en charge plusieurs modèles d’image, chacun avec des plafonds 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

La génération texte vers vidéo fonctionne de la même façon. Générez un clip de 5 secondes :

pixverse create video --prompt "Un coucher de soleil sur les vagues de l'océan" --json

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

pixverse create video \
  --prompt "Un plan cinématographique de drone sur une vallée montagneuse brumeuse à l'aube" \
  --model v5.6 \
  --quality 1080p \
  --aspect-ratio 16:9 \
  --duration 8 \
  --audio \
  --json

L’option --audio active le son ambiant généré par IA qui correspond au contenu de votre vidéo. L’option --json retourne une 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 l’option --image :

pixverse create video \
  --prompt "Une douce brise traverse la scène" \
  --image ./product-photo.jpg \
  --model v5.6 \
  --quality 1080p \
  --json

Vous pouvez passer un chemin de fichier local ou une URL. Les fichiers locaux sont téléversés automatiquement — aucune étape de téléversement manuel n’est requise.

Étape 5 : Utiliser l’Assistant Interactif

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

pixverse create video
pixverse create image

L’assistant vous guide à travers le prompt, la sélection du modèle, la qualité, le format d’image, la durée et d’autres options étape par étape — utile pour découvrir quels paramètres sont disponibles avant de les scripter.

Apprendre à votre Agent IA à Générer des Médias

C’est là que PixVerse CLI devient véritablement transformateur. Parce que chaque commande retourne du JSON structuré et utilise des codes de sortie déterministes, tout agent IA capable d’exécuter des commandes shell peut être formé pour générer des images et des vidéos à la demande.

Installation des PixVerse Skills

PixVerse Skills est une bibliothèque de fichiers de compétences structurés qui enseigne aux agents exactement comment utiliser le CLI : quelles options chaque commande accepte, quels modèles prennent en charge quels paramètres, comment enchaîner les commandes en pipelines et comment gérer les erreurs.

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

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

Pour Cursor, les skills se trouvent dans le dossier skills/ du dépôt GitHub PixVerse Skills et peuvent être chargés comme contexte directement dans votre éditeur. Pour Codex et les agents basés sur LangChain, chaque fichier de compétence est un fichier markdown autonome qui peut être injecté dans le prompt système de l’agent.

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

• “Génère une vidéo de démonstration produit de 10 secondes à partir de cette capture d’écran”
• “Crée quatre variations de cette image de couverture de blog au format 16:9”
• “Anime ce diagramme en un clip explicatif de 5 secondes avec son ambiant”

L’agent traduira ces instructions en commandes CLI correctes, analysera la sortie JSON et gérera le polling 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 PixVerse skills, vous pouvez inclure la génération de médias directement dans n’importe quelle tâche :

Génère une image de couverture pour cet article de blog sur l'apprentissage automatique,
utilise le modèle seedream-5.0-lite à 1800p au format 16:9,
télécharge-la vers ./assets/cover.webp

Claude Code invoquera les commandes CLI correctes, analysera l’URL de l’image depuis la réponse JSON et téléchargera le fichier vers le chemin que vous avez spécifié — tout dans la même session où il écrit également votre code.

Un flux de travail typique avec Claude Code :

# Claude Code exécute ceci de manière autonome selon votre instruction
IMG=$(pixverse create image \
  --prompt "Visualisation abstraite de couches de réseau neuronal, fond sombre, tons bleus et violets" \
  --model seedream-5.0-lite \
  --quality 1800p \
  --aspect-ratio 16:9 \
  --json | jq -r '.image_url')
 
# Puis l'anime
pixverse create video \
  --prompt "Panoramique lent sur des connexions neuronales lumineuses" \
  --image "$IMG" \
  --model v5.6 \
  --quality 1080p \
  --duration 6 \
  --json

Cursor

Les utilisateurs de Cursor peuvent charger PixVerse Skills comme fichier de contexte de projet. Placez les fichiers de compétences pertinents dans votre répertoire .cursor/ ou ajoutez-les à vos règles d’espace de travail. Une fois chargé, Cursor a une connaissance complète de 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 courant avec Cursor : demander à l’agent de générer une image de maquette basée sur un design que vous construisez, puis l’utiliser 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 du JSON. Le format de sortie structuré — noms de champs cohérents, codes d’erreur prévisibles et messages d’erreur séparés dans 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 maîtrisez les commandes individuelles, PixVerse CLI déverrouille de puissants flux de travail en plusieurs étapes qui s’exécutent entièrement sans interaction utilisateur.

Texte vers Image vers Vidéo

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

# Étape 1 : Générer une image de base
IMG_RESULT=$(pixverse create image \
  --prompt "Un paysage urbain cyberpunk de nuit, lumières néon se reflétant sur le pavé mouillé" \
  --model gemini-3.1-flash \
  --quality 2160p \
  --aspect-ratio 16:9 \
  --json)
 
IMAGE_URL=$(echo "$IMG_RESULT" | jq -r '.image_url')
 
# Étape 2 : L'animer en vidéo
VID_RESULT=$(pixverse create video \
  --prompt "La caméra parcourt lentement les rues éclairées au néon" \
  --image "$IMAGE_URL" \
  --model v5.6 \
  --quality 1080p \
  --duration 8 \
  --json)
 
VIDEO_ID=$(echo "$VID_RESULT" | jq -r '.video_id')
 
# Étape 3 : Télécharger la vidéo finale
pixverse asset download "$VIDEO_ID" --json

Pipeline de Production Vidéo Complet

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

# Étape 1 : Créer la vidéo de base
RESULT=$(pixverse create video \
  --prompt "Un produit en cours d'assemblage au ralenti" \
  --model v5.6 \
  --quality 720p \
  --duration 5 \
  --json)
 
VID=$(echo "$RESULT" | jq -r '.video_id')
 
# Étape 2 : Prolonger la durée
EXTENDED=$(pixverse create extend \
  --video "$VID" \
  --prompt "Continuer la séquence d'assemblage" \
  --duration 5 \
  --json | jq -r '.video_id')
 
pixverse task wait "$EXTENDED" --json
 
# Étape 3 : Ajouter un son ambiant
WITH_SOUND=$(pixverse create sound \
  --video "$EXTENDED" \
  --prompt "Ambiance d'atelier industriel, sons mécaniques doux" \
  --json | jq -r '.video_id')
 
pixverse task wait "$WITH_SOUND" --json
 
# Étape 4 : Mettre à l'échelle en 1080p
FINAL=$(pixverse create upscale \
  --video "$WITH_SOUND" \
  --quality 1080p \
  --json | jq -r '.video_id')
 
pixverse task wait "$FINAL" --json
 
# Étape 5 : Télécharger
pixverse asset download "$FINAL" --json

Génération par Lot

Pour les pipelines de contenu nécessitant plusieurs variations, exécutez les tâches en parallèle :

# Vérifier les crédits d'abord
CREDITS=$(pixverse account info --json | jq -r '.credits.total')
echo "Crédits disponibles : $CREDITS"
 
# Soumettre quatre générations en parallèle
pixverse create video --prompt "Lever de soleil sur les montagnes" --no-wait --json > /tmp/v1.json &
pixverse create video --prompt "Coucher de soleil sur l'océan" --no-wait --json > /tmp/v2.json &
pixverse create video --prompt "Étoiles au-dessus d'un désert" --no-wait --json > /tmp/v3.json &
pixverse create video --prompt "Aurore au-dessus d'un lac gelé" --no-wait --json > /tmp/v4.json &
wait
 
# Attendre chaque résultat et télécharger
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’option --no-wait soumet la tâche et retourne immédiatement avec un identifiant de tâche, vous permettant de soumettre plusieurs tâches avant de les interroger. La commande pixverse task wait gère le polling adaptatif pour vous — aucune boucle de délai manuel n’est requise.

Configurer les Valeurs par Défaut

Si vous utilisez systématiquement le même modèle, la même qualité ou le même format d’image, définissez-les comme valeurs par défaut pour ne pas avoir à répéter les options à chaque fois :

pixverse config defaults set --mode video --model v5.6 --quality 1080p --aspect-ratio 16:9
pixverse config defaults set --mode image --model seedream-5.0-lite --quality 1800p
pixverse config set output-dir ~/Downloads/pixverse

Les options en ligne de commande remplacent toujours vos valeurs par défaut configurées, vous conservez ainsi toute la flexibilité tout en réduisant les répétitions.

Ce que Vous Pouvez Construire

Avec PixVerse CLI intégré dans votre flux de travail d’agent, l’éventail des tâches automatisables s’élargit considérablement :

• Documentation — générez automatiquement des vidéos de démonstration produit et des captures d’écran dans le cadre de votre processus de construction de documentation
• Marketing — exécutez des tâches nocturnes par lot qui produisent des variations de contenu pour les réseaux sociaux à partir d’une bibliothèque de prompts unique
• Développement d’applications — laissez votre agent de codage générer des visuels de remplacement, des animations de maquettes ou des vidéos d’écran de chargement pendant que vous construisez l’interface utilisateur
• Pipelines de contenu — enchaînez les appels CLI avec d’autres outils (ffmpeg, ImageMagick, stockage cloud) pour construire des flux de production multimédia entièrement automatisés
• Prototypage — générez des concepts de mouvement rapides en quelques secondes pour valider des idées avant de vous engager dans une production complète

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

Liste de Vérification pour Démarrer

• 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 préférées avec pixverse config defaults set
• Construire votre premier pipeline d’automatisation

Prochaines Étapes

PixVerse CLI sur npm (npm install -g pixverse) vous donne un accès immédiat à toutes les capacités de génération. Le dépôt PixVerse Skills fournit les fichiers de compétences structurés qui apprennent à votre agent IA comment utiliser ces capacités correctement dans n’importe quel contexte.

La combinaison d’un CLI fiable et d’une bibliothèque de compétences prête pour les agents signifie que la génération d’images et de vidéos peut désormais 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à.