PixVerse CLI: KI-Videos, Bilder, Sprache und Musik direkt aus dem Terminal generieren

Geprüft am 2026-10-13: Node.js >=22.12 ist erforderlich. GPT Image 2.5 Flare ist das Standard-Bildmodell, PixVerse V6 das Standard-Videomodell. Modelle und Einstellungen hängen vom Erstellungsmodus ab. Prüfen Sie vor der Produktion die installierten capabilities und das offizielle README. README · capabilities.json

pixverse --version
pixverse capabilities create --json
pixverse canvas --help

Einführung

Browserbasierte Generierungsoberflächen eignen sich gut zum Ausprobieren und für einmalige Projekte. Aber mehrere Szenarien erfordern einen anderen Ansatz:

Die PixVerse CLI bringt die Generierung von KI-Videos, Bildern, Sprache und Musik direkt in terminalbasierte Workflows. Statt zwischen einer Browser-Oberfläche und Ihrer Entwicklungsumgebung zu wechseln, können Sie KI-Inhalte über dieselbe Kommandozeile erstellen, verwalten und herunterladen, in der Sie auch Code schreiben, Builds ausführen und Deployments verwalten. PixVerse CLI

Die PixVerse CLI ist genau um diese Liste herum aufgebaut und setzt besonders stark auf den agentengesteuerten Anwendungsfall: Befehle liefern strukturiertes JSON zurück, Exit-Codes sind vorhersehbar, und jeder Schritt ist so konzipiert, dass er von einem Skript oder einem autonomen Agenten kombiniert werden kann, statt von einem Menschen, der durch eine Oberfläche klickt.

Voraussetzungen

Bevor Sie beginnen, benötigen Sie:

Node.js 22.12 oder höher —— prüfen Sie mit node --version
Ein PixVerse-Konto —— registrieren Sie sich unter pixverse.ai
Ein aktives PixVerse-Abonnement —— die CLI nutzt dasselbe Credit-System wie die Website, sodass für Generierungen ein abonniertes Konto erforderlich ist

Es gibt keinen API-Schlüssel, den Sie manuell kopieren müssten. Die Authentifizierung läuft über einen browserbasierten Ablauf, der Ihr Token lokal speichert.

Installation

Installieren Sie die CLI global mit npm:

npm install -g pixverse

Bestätigen Sie, dass die Installation erfolgreich war:

pixverse --version

Wenn Sie nichts global installieren möchten, können Sie Befehle auch bei Bedarf über npx ausführen:

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

Authentifizierung

Melden Sie sich an mit:

pixverse auth login

Dies öffnet ein Browserfenster für die OAuth-Autorisierung. Wenn Sie über SSH arbeiten oder auf einer Headless-Maschine sind, liefert der Anmeldevorgang auch eine URL, die Sie in einen Browser auf einem beliebigen anderen Gerät einfügen können, um die Autorisierung abzuschließen. Nach der Autorisierung wird Ihr Token in ~/.pixverse/ gespeichert und bleibt 30 Tage gültig.

Prüfen Sie Ihren Anmeldestatus und die verfügbaren Credits:

pixverse auth status
pixverse account info
pixverse account slots
pixverse capabilities canvas --json

account info zeigt Ihre Abonnementstufe und die Workspace-Credits an. account usage schlüsselt auf, wie diese Credits verbraucht wurden, und account slots zeigt Ihnen, wie viele Generierungen Sie gleichzeitig ausführen können —— es lohnt sich, dies vor dem Start eines Batch-Jobs zu prüfen. CLI-Sitzungen teilen sich keinen Zustand mit Ihrer Browser- oder App-Sitzung, sodass eine Abmeldung aus der CLI (pixverse auth logout) Ihre anderen Sitzungen nicht beeinträchtigt.

Schnellstart

Wenn Sie so schnell wie möglich von der Installation zu einem fertigen Ergebnis gelangen möchten, führt Sie diese Sequenz dorthin:

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

Für Skripte und Agenten sollten Sie --json (oder die Kurzform -p) aktiviert lassen, damit stdout sauber und parsbar bleibt, während Fortschrittsmeldungen und Fehler stattdessen an stderr gehen. Wenn ein Job möglicherweise mehr als einmal übermittelt wird — bei instabilem Netzwerk oder einem wiederholten CI-Schritt — fügen Sie --idempotency-key <key> hinzu, damit nicht versehentlich doppelt berechnete Jobs entstehen.

Bilder generieren

Text-zu-Bild ist der schnellste Weg, um zu bestätigen, dass alles funktioniert:

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

Das aktuelle Standardbildmodell ist GPT Image 2.5 Flare, aber für alles, was Sie wiederholt ausführen möchten, setzen Sie --model explizit, statt sich auf den Standardwert zu verlassen —— Standardwerte ändern sich, wenn neue Modelle erscheinen. --json liefert Ihnen eine Antwort, die Sie direkt in den nächsten Schritt weiterleiten können:

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

Für höhere Auflösungen greifen Sie auf ein Modell zurück, das diese unterstützt:

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

Das Bildmodell-Angebot deckt mehrere unterschiedliche Anwendungsfälle ab:

pixverse capabilities create image --json
pixverse capabilities create image --model gpt-image-2.5-flare --json

Sie können auch ein vorhandenes Bild erneut einspeisen und transformieren:

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

Dann die Datei lokal herunterladen:

pixverse asset download 789012 --type image

Videos generieren

Text-zu-Video folgt demselben Muster. Ein schneller 5-Sekunden-Clip:

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

Oder eine vollständig spezifizierte Generierung:

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

Bei Modellen mit Unterstützung für natives Audio: --audio fügt KI-generierten Umgebungston hinzu, der zur Szene passt. Nach Abschluss enthält die JSON-Antwort eine video_url, die Sie direkt an einen Download-Schritt oder die nächste Stufe einer Pipeline weitergeben können.

Videomodelle unterscheiden sich stark hinsichtlich Auflösungsobergrenze, Dauerbereich und unterstützten Erstellungsmodi:

pixverse capabilities create video --json
pixverse capabilities create reference --model seedance-2.5 --json

Partnermodelle wie Seedance, Kling, Veo, Sora, Gemini Omni, Grok Imagine und HappyHorse stehen ebenfalls auf PixVerse zur Verfügung. Vergleichen Sie sie über dieselbe CLI mit PixVerse V6 und C1.

Ein statisches Bild animieren

Übergeben Sie --image, um ein Foto oder generiertes Bild in Bewegung zu versetzen:

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

Sie können --image auf einen lokalen Dateipfad oder eine externe URL verweisen lassen —— lokale Dateien werden automatisch hochgeladen, ein separater Upload-Schritt ist nicht nötig. Alles, was größer als 1920×1920 oder 5 MB ist, wird vor dem Upload automatisch skaliert oder komprimiert; externe URLs werden vom Backend so validiert, wie sie sind.

Grok Imagine 1.5 ist ein Sonderfall: Es erfordert --image und legt das Ausgabeseitenverhältnis auf das des Quellbilds fest:

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

Referenz, Übergänge, Bewegungssteuerung und Vorlagen

Über einfaches Text-zu-Video und Bild-zu-Video hinaus bietet die CLI mehrere spezialisiertere Erstellungsmodi, die nützlich sind, wenn Sie mehr Kontrolle über Charaktere, Keyframes oder Effekte benötigen:

# 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 to 2160p
pixverse create upscale --video <video_id> --quality 2160p

# 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

Sprache und Musik generieren

Die eigenständige Audiogenerierung steckt hinter zwei dedizierten Befehlen: create voice für Text-zu-Sprache und create music für promptgesteuerte Musik. Beide speichern ihre Ausgabe als Audio-Assets, sodass Sie sie mit task verfolgen, mit asset list --type audio auflisten und mit asset download herunterladen können. Wenn Sie nur Umgebungston in ein Video einbauen möchten, verwenden Sie stattdessen --audio / --no-audio bei einem unterstützten Video-Erstellungsbefehl —— das ist ein separater Weg gegenüber diesen eigenständigen Audiobefehlen.

Generieren Sie einen Sprachclip:

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

Listen Sie verfügbare Sprachmodelle und voreingestellte Stimmen auf, bevor Sie sich für eine entscheiden:

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

Generieren Sie einen Musiktrack:

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

Fügen Sie --instrumental für einen Track ohne Gesang hinzu. Wenn Sie Liedtexte möchten, akzeptiert --lyrics wörtlichen Text, einen lokalen Dateipfad oder gepipte Standardeingabe:

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

Die aktuellen Sprachoptionen umfassen die Familien MiniMax Speech 2.8 und ElevenLabs, und die Musikgenerierung stammt derzeit von MiniMax Music, ElevenLabs Music und Google Lyria 3 Pro. Da sich diese Angebote im Laufe der Zeit ändern, führen Sie pixverse voice models und pixverse music models aus, um zu sehen, was verfügbar ist, bevor Sie ein Skript schreiben, das Sie wiederverwenden möchten.

Der interaktive Assistent

Wenn Sie noch dabei sind, herauszufinden, welche Flags es gibt, führen Sie einen Erstellungsbefehl ohne Argumente aus:

pixverse create video
pixverse create image

Dies führt Sie zu einem geführten Assistenten, der Sie Schritt für Schritt durch Prompt, Modell, Qualität, Seitenverhältnis, Dauer und andere relevante Optionen führt —— eine gute Möglichkeit, Flags zu entdecken, bevor Sie sie in ein Skript einbauen.

Assets und Ihren Workspace verwalten

Generierung ist nur ein Teil des Gesamtbilds. Die CLI bietet auch Verwaltungsbefehle für alles darum herum:

pixverse task status <id> und pixverse task wait <id> zum Abfragen eines einzelnen Jobs
pixverse task status --ids 123,456,789 --type video --json zum Prüfen mehrerer Jobs in einem Aufruf
pixverse asset list, asset upload, asset info, asset download und asset delete für den gesamten Lebenszyklus von Video-, Bild- und Audio-Assets
pixverse saved list, saved items, saved new, saved rename, saved add, saved remove und saved delete für gespeicherte Ordner
pixverse template categories, template list, template search und template info zum Durchsuchen von Effekten und Vorlagen
pixverse voice models, voice presets und music models für die Live-Erkennung von Audiomodellen
pixverse workspace list, workspace status, workspace switch und workspace manage für Multi-Workspace-Setups
pixverse account info, account usage und account slots zur Prüfung von Credits, Nutzung und Nebenläufigkeit
pixverse config set, config list, config path und config defaults für wiederholbare lokale Einstellungen

Zusammen ermöglichen diese Befehle einem einzigen Skript, Erstellung, Organisation, Vorlagenerkennung, Download und Workspace-Routing zu übernehmen, ohne das Terminal zu verlassen. Um für einen einzelnen Befehl einen anderen als den Standard-Workspace anzusprechen, fügen Sie --workspace-id <id> hinzu (verwenden Sie 0 für Ihren persönlichen Workspace).

Canvas-Projekte und aktuell unterstützte Modelle

Die CLI bietet jetzt Canvas-Workflows für Projekte, Graphen, Knoten, Patches und Dispatch. Prüfen Sie vor einer Automatisierung pixverse canvas --help und pixverse capabilities canvas --json. Canvas-Fähigkeiten erfordern eine Anmeldung und werden vom Dienst abgerufen; die Generierungsfähigkeiten beschreiben die installierte CLI. Aktualisieren Sie die CLI, wenn ein Modell fehlt.

Der aktuelle Katalog enthält Seedance 2.5, MiniMax H3/H3 Max, FLUX 3, Wan 3.0, Kling 4K, GPT Image 2.5 Flare/Sunburst und Nano Banana 2.1. Prüfen Sie Fähigkeiten für das konkrete Modell und den Modus, statt Dauer-, Audio-, Referenz- oder Auflösungseinstellungen anderer Modelle zu übernehmen.

Flags, die Sie für Skripte kennen sollten

Vorhersehbare Ausgabe ist beim Automatisieren wichtiger als alles andere. Diese Flags tauchen ständig in Skripten und Agenten-Workflows auf:

Flag	Verwendung
`--json`	Gibt strukturierte JSON-Ausgabe zurück
`-p`	Kurzform für `--json`
`--count <n>`	Erzeugt 1–4 Varianten aus einer einzigen Anfrage
`--seed <number>`	Erleichtert die Reproduktion einer Generierung
`--off-peak`	Nutzt Nebenzeit-Preise, sofern verfügbar
`--audio` / `--no-audio`	Schaltet Audio bei unterstützten Video-Erstellungsbefehlen um
`--multi-shot` / `--no-multi-shot`	Schaltet den Mehrfach-Einstellungsmodus für Video um
`--no-wait`	Reicht den Job ein und kehrt sofort zurück, statt zu blockieren
`--timeout <sec>`	Legt das Polling-Timeout fest (Standard 300 Sekunden)
`--workspace-id <id>`	Überschreibt den aktiven Workspace für einen einzelnen Befehl
`--trace-id <uuid>`	Hängt eine vom Aufrufer bereitgestellte UUIDv4 zur Fehlersuche an eine Anfrage an
`--idempotency-key <key>`	Wiederholt eine Erstellungsanfrage sicher, ohne doppelte Berechnung

Text-Eingabe-Flags akzeptieren nun mehr als reine Inline-Strings. --prompt, --text und --lyrics akzeptieren alle einen wörtlichen String, einen lokalen Dateipfad oder - zum Lesen von 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

Ihrem KI-Agenten die Mediengenerierung beibringen

Wenn Sie vor der Kommandozeilenautomatisierung einen geführten Agenten-Workflow in der App testen möchten, beginnen Sie mit PixVerse Agent.

Hier hört die CLI auf, eine bloße Annehmlichkeit zu sein, und wird zu einem Fähigkeits-Multiplikator. Da jeder Befehl strukturiertes JSON zurückgibt und mit einem deterministischen Code endet, kann jeder Agent, der Shell-Befehle ausführen kann, beigebracht bekommen, in Ihrem Namen Bilder, Videos, Sprache und Musik zu generieren.

PixVerse Skills installieren

PixVerse Skills ist eine Skill-Bibliothek, die speziell dafür gebaut wurde, Agenten die Flags der CLI, Modellbeschränkungen, mehrstufige Pipelines und Fehlerbehandlungsmuster beizubringen, statt den Agenten aus Hilfetexten raten zu lassen.

Für Claude Code und andere Tools, die das Skills-Format unterstützen:

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

Nach dem Laden verfügt ein Agent über explizite Vorgaben, mit denen er arbeiten kann, statt Verhalten durch Versuch und Irrtum abzuleiten —— was für die Zuverlässigkeit in Cursor, Claude Code, Codex und ähnlichen Frameworks stark ins Gewicht fällt.

Sobald PixVerse Skills geladen ist, können Sie einem Agenten Anweisungen in natürlicher Sprache geben wie:

„Erzeuge ein 10-sekündiges Produktdemo-Video aus diesem Screenshot”
„Erstelle vier Varianten dieses Blog-Titelbilds im 16:9-Format”
„Animiere dieses Diagramm zu einem 5-sekündigen Erklärclip mit Umgebungston”
„Erzeuge drei 8-sekündige 16:9-Promo-Clips mit unterschiedlichen Kamerabewegungen”

Der Agent übersetzt dies in die richtigen CLI-Aufrufe, parst die JSON-Antworten, übernimmt das Polling und lädt das Ergebnis herunter —— ohne manuelle Zwischenschritte.

Claude Code

Innerhalb von Claude Code wird die CLI zu einem Werkzeug, das der Agent selbstständig nutzt. Nachdem PixVerse Skills geladen wurde, können Sie Mediengenerierung in jede Aufgabe einbauen:

Erstellen Sie mit seedream-5.0-lite ein Titelbild für diesen Blogbeitrag über maschinelles Lernen in 2160p und 16:9 und laden Sie es nach ./assets/cover.webp herunter.

Claude Code führt die richtigen Befehle aus, extrahiert die Bild-URL aus dem JSON und speichert die Datei am angegebenen Pfad —— alles innerhalb derselben Sitzung, in der auch Ihr Code bearbeitet wird.

Ein typischer Workflow:

# 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

Cursor-Nutzer können relevante PixVerse-Skills-Dateien in .cursor/ ablegen oder den Workspace-Regeln hinzufügen. Nach dem Laden unterstützen diese Anleitungen die Mediengenerierung während Programmieraufgaben.

Sie können Cursor beispielsweise ein Mockup-Bild für Ihren Entwurf erstellen lassen und es in derselben Editor-Sitzung direkt als Referenz verwenden.

Codex und andere Agenten

Jeder Agent, der Shell-Befehle ausführen und JSON parsen kann, kann diese CLI steuern. Konsistente Feldnamen, vorhersehbare Fehlercodes und auf stderr getrennt gehaltene Fehlermeldungen bedeuten, dass sogar ein einfacher Skripting-Agent die Generierung ohne Sonderbehandlung integrieren kann.

Die Exit-Codes geben einem Agenten einen klaren Entscheidungsbaum:

Code	Bedeutung	Aktion des Agenten
0	Erfolg	JSON-Ausgabe parsen
1	Allgemeiner Fehler	stderr prüfen und mit validierten Eingaben erneut versuchen
2	Timeout	Mit längerem `--timeout` erneut versuchen
3	Authentifizierung abgelaufen	`pixverse auth login` erneut ausführen
4	Keine Credits mehr	Guthaben prüfen, Benutzer benachrichtigen
5	Generierung fehlgeschlagen	Andere Parameter versuchen
6	Validierungsfehler	Flag-Werte überprüfen
7	Parallelitätslimit	Auf einen freien Slot warten und erneut versuchen

Automatisierungspipelines

Sobald Sie sich mit den einzelnen Befehlen wohlfühlen, zeigt sich der eigentliche Mehrwert in mehrstufigen Pipelines, die laufen, ohne dass jemand zusieht.

Text zu Bild zu Video

Erzeugen Sie ein hochauflösendes Bild aus einem Prompt und animieren Sie es anschließend:

# 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

Vollständige Videoproduktions-Pipeline

Für ein ausgereifteres Ergebnis verketten Sie die Generierung mit Nachbearbeitung. Verwenden Sie --audio oder --no-audio, wenn der native Ton eines unterstützten Videomodells ausreicht, und greifen Sie auf create voice oder create music zurück, wenn Sie ein separates Audio-Asset zum späteren Kombinieren benötigen:

# 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 2160p
FINAL=$(pixverse create upscale \
  --video "$EXTENDED" \
  --quality 2160p \
  --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

Batch-Generierung

Für Content-Pipelines, die mehrere Varianten gleichzeitig benötigen, führen Sie Jobs parallel statt nacheinander aus:

# 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

--no-wait reicht einen Job ein und gibt sofort eine Task-ID zurück, sodass Sie mehrere Jobs in eine Warteschlange einreihen können, bevor Sie mit dem Polling beginnen. Notieren Sie sich die Task-IDs und aufgelösten Parameter aus jeder --no-wait --json-Antwort —— diese Aufzeichnung macht einen Batch-Lauf später reproduzierbar. Verwenden Sie --count <n> für mehrere Varianten aus einem einzigen Prompt, und setzen Sie auf Batch-task status --ids, wenn Sie lieber eine einzige Statusantwort für mehrere laufende Jobs erhalten möchten, statt jeden einzeln abzufragen. pixverse task wait übernimmt das adaptive Polling für Sie.

Standardwerte konfigurieren

Wenn Sie sich dabei ertappen, bei jedem Aufruf dasselbe Modell, dieselbe Qualität oder dasselbe Seitenverhältnis zu wiederholen, legen Sie diese einmalig fest:

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

Flags in der Kommandozeile haben immer Vorrang vor konfigurierten Standardwerten, sodass das Festlegen von Standardwerten Sie keine Flexibilität kostet. Für einen einzelnen Lauf gegen einen anderen als den Standard-Workspace fügen Sie zusätzlich zu Ihren gewohnten Standardwerten --workspace-id <id> hinzu.

Was Sie bauen können

Durch die Einbindung der CLI in einen Agenten oder ein Skript erweitert sich die Bandbreite an möglichen Automatisierungen erheblich:

Dokumentation —— automatisches Erzeugen von Produktdemo-Videos und Screenshots als Teil Ihres Dokumentations-Builds
Marketing —— nächtliche Batch-Jobs ausführen, die aus einer einzigen Prompt-Bibliothek Social-Media-Content-Varianten erzeugen
App-Entwicklung —— einen Coding-Agenten Platzhaltervisuals, Mockup-Animationen oder Ladebildschirm-Videos generieren lassen, während Sie die eigentliche UI bauen
Audio-Workflows —— Voiceover-Entwürfe, Prompt-zu-Musik-Tracks oder eigenständige Audio-Assets für spätere Bearbeitung generieren
Content-Pipelines —— CLI-Aufrufe mit ffmpeg, ImageMagick oder Cloud-Speicher-Tools verketten, um eine vollständig automatisierte Produktionspipeline zu bauen
Prototyping —— schnelle Bewegungskonzepte in Sekunden generieren, um Ideen zu validieren, bevor Sie sich auf die vollständige Produktion festlegen

Da es sich einfach um Shell-Befehle handelt, fügt sich die CLI ohne besonderen Integrationsaufwand in bash, Python, Node oder CI/CD ein.

Checkliste für den Einstieg

Die CLI aktuell halten

Verwenden Sie den eingebauten Updater, um Ihre lokale CLI aktuell zu halten:

pixverse update

Sie können auch direkt über npm aktualisieren:

npm install -g pixverse@latest

Modelle und Flags ändern sich schneller als die meiste Dokumentation, prüfen Sie daher für Release-Änderungen direkt die primären Quellen:

Stand dieser Aktualisierung bleibt PixVerse V6 das Standard-Videomodell und GPT Image 2.5 Flare das Standard-Bildmodell, wobei Seedance 2.0 Mini, dedizierte create voice/create music-Befehle, Audio-Asset-Verwaltung, gespeicherte Ordner, Workspace-Wechsel, config defaults, das capabilities.json-Manifest, pixverse update, stdin-Unterstützung für Texteingaben, --trace-id und --idempotency-key allesamt Teil des aktuellen Toolsets sind. PixVerse CLI

Was die CLI ermöglicht

PixVerse CLI, GitHub und npm (npm install -g pixverse) bieten Generierung, Aufgabenabfragen, Assets, Vorlagen, Sprache, Musik und Workspace-Verwaltung. PixVerse Skills ergänzt die Anleitungen für Agenten.

Mit CLI und Agenten-Skills werden Bilder, Videos, Sprache und Musik Teil Ihres Code-Workflows, verwaltet vom selben Agenten im selben Terminal.

Beginnen Sie mit einem einzelnen Befehl und bauen Sie darauf auf.