PixVerse CLI: KI-Video- und Bildgenerierung im Terminal

 
Führen Sie den Anmeldebefehl aus:```bash
pixverse auth login
```Die CLI öffnet einen Browser für die OAuth-Geräteautorisierung. Sie können die URL auch kopieren und die Autorisierung von jedem Browser auf jedem Gerät aus abschließen, was für SSH- und Headless-Umgebungen nützlich ist. Ihr Token wird automatisch in `~/.pixverse/` gespeichert und ist 30 Tage lang gültig.
 
Um zu überprüfen, ob Sie angemeldet sind und Ihr verfügbares Guthaben prüfen:```bash
pixverse auth status
pixverse account info
```Der Befehl `account info` zeigt Ihre Abonnementstufe, das verbleibende Guthaben und den täglichen Zeitplan zum Zurücksetzen des Guthabens an. Überprüfen Sie immer Ihr Guthaben, bevor Sie Batch-Jobs ausführen.
 
## Schritt 3: Generieren Sie Ihr erstes Bild
 
Die Text-zu-Bild-Generierung ist die schnellste Möglichkeit, Ihr Setup zu testen. Laufen:```bash
pixverse create image --prompt "A photorealistic forest path at golden hour" --json
```Das Flag `--json` gibt eine strukturierte Ausgabe zurück:```json
{
  "image_id": 789012,
  "status": "completed",
  "image_url": "https://...",
  "prompt": "A photorealistic forest path at golden hour",
  "model": "qwen-image",
  "width": 1024,
  "height": 1024
}
```Geben Sie für eine Ausgabe mit höherer Auflösung ein Modell an, das dies unterstützt:```bash
pixverse create image \
  --prompt "A photorealistic forest path at golden hour" \
  --model seedream-5.0-lite \
  --quality 1800p \
  --aspect-ratio 16:9 \
  --json
```PixVerse unterstützt mehrere Bildmodelle mit jeweils unterschiedlichen Auflösungsgrenzen und -stärken:
 
| Modell | Maximale Auflösung | Am besten für |
|:---|:---|:---|
| `qwen-image` | 1080p | Schnelle Generierung, allgemeine Verwendung |
| `gpt-image-2.0` | 2160p | Hochauflösende kreative Ausgaben in mehreren Formaten |
| `seedream-5.0-lite` | 1800p | Kreative Bilder mit hoher Detailgenauigkeit |
| `seedream-4.5` | 2160p | Ultrahohe Auflösung |
| `gemini-3.1-flash` (Nano-Banane 2) | 2160p | Großer Auflösungsbereich, schnell |
| `gemini-3.0` (Nano Banana Pro) | 2160p | Hohe Qualität im Maßstab |
| `gemini-2.5-flash` (Nano-Banane) | 1080p | Leichte, schnelle Abwicklung |
| `kling-image-o3` | 2160p | Stilisierte visuelle Ausgaben mit flexiblem Rahmen |
| `kling-image-v3` | 1440p | Ausgewogene Qualität und Geschwindigkeit |
 
So laden Sie das generierte Bild herunter:```bash
pixverse asset download 789012
```## Schritt 4: Erstellen Sie Ihr erstes Video
 
Text-to-Video funktioniert auf die gleiche Weise. Erzeugen Sie einen 5-Sekunden-Clip:```bash
pixverse create video --prompt "A sunset over ocean waves" --json
```Für eine vollständig maßgeschneiderte Generation:```bash
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
```Das Flag `--audio` ermöglicht KI-generierten Umgebungsklang, der zu Ihrem Videoinhalt passt. Das Flag `--json` gibt nach Abschluss einen `video_url` zurück, den Sie direkt an einen Download-Befehl oder den nächsten Schritt in einer Pipeline übergeben können.
 
PixVerse bietet mehrere Videomodelle mit unterschiedlichen Funktionen:
 
| Modell | Maximale Qualität | Dauerbereich | Notizen |
|:---|:---|:---|:---|
| `v6` | 1080p | 1–15 Sek. | Standard-PixVerse-Modell mit breiter Unterstützung für Seitenverhältnisse |
| `pixverse-c1` | 1080p | 1–15 Sek. | Starke Unterstützung für Video- und Referenz-Workflows |
| `v5.6` | 1080p | 1–10 Sek. | Unterstützt den Motion-Control-Erstellungsmodus |
| `veo-3.1-standard` | 2160p | 4, 6, 8 Sek. | Unterstützt sowohl Video- als auch Übergangsworkflows |
| `grok-imagine` | 720p | 1–15 Sek. | Unterstützt das Erstellen, Erweitern und Referenzieren von Videos |
| `sora-2-pro` | 1080p | 4, 8, 12 Sek. | High-Fidelity-Ergebnisse mit Optionen mit fester Dauer |
 
### Animieren Sie ein statisches Bild
 
Um ein Foto oder ein generiertes Bild in ein Video umzuwandeln, geben Sie das Flag `--image` an:```bash
pixverse create video \
  --prompt "Gentle wind moves through the scene" \
  --image ./product-photo.jpg \
  --model v6 \
  --quality 1080p \
  --json
```Sie können einen lokalen Dateipfad oder eine URL übergeben. Lokale Dateien werden automatisch hochgeladen – kein manueller Upload-Schritt erforderlich.
 
## Schritt 5: Führen Sie den interaktiven Assistenten aus
 
Wenn Sie zum ersten Mal erkunden und noch nicht mit allen verfügbaren Flags vertraut sind, führen Sie einen beliebigen Erstellungsbefehl ohne Argumente aus, um den geführten Assistenten aufzurufen:```bash
pixverse create video
pixverse create image
```Der Assistent führt Sie Schritt für Schritt durch Eingabeaufforderung, Modellauswahl, Qualität, Seitenverhältnis, Dauer und andere Optionen – nützlich, um herauszufinden, welche Parameter verfügbar sind, bevor Sie sie mit einem Skript versehen.
 
## Beyond Generation: Verwalten Sie Ihre Assets und Ihren Arbeitsbereich
 
Die neueste PixVerse-CLI enthält außerdem Verwaltungsbefehle, die Sie beim Aufbau durchgängiger Terminal-Workflows unterstützen:
 
- `pixverse task status <id>` und `pixverse task wait <id>` für Aufgabenabfragen
- `pixverse asset list|upload|info|download|delete` für Asset-Lebenszyklusvorgänge
- `pixverse saved list|items|new|rename|add|remove|delete` für gespeicherte Ordner
- `pixverse workspace list|status|switch|manage` für Multi-Workspace-Vorgänge
 
Dies macht es einfach, nicht nur die Erstellung, sondern auch die Organisation, den Download und die Bereitstellung in einem Skript zu automatisieren.
 
## Bringen Sie Ihrem KI-Agenten bei, Medien zu generieren
 
Hier wird PixVerse CLI wirklich transformativ. Da jeder Befehl strukturiertes JSON zurückgibt und deterministische Exit-Codes verwendet, kann jedem KI-Agenten, der Shell-Befehle ausführen kann, beigebracht werden, bei Bedarf Bilder und Videos zu generieren.
 
### PixVerse Skills installieren
 
**PixVerse Skills** ist eine strukturierte Skill-Bibliothek, die Agenten die korrekte Verwendung der CLI beibringt: Befehlsflags, Modelleinschränkungen, mehrstufige Pipelines und robuste Fehlerbehandlung.
 
Für Claude Code und andere Agenten, die das Skills-Format unterstützen, fügen Sie die PixVerse-Skills direkt hinzu:```bash
npx skills add https://github.com/pixverseai/skills --skill pixverse-ai-image-and-video-generator
```Für Cursor, Claude Code, Codex und andere Agent-Frameworks verbessert diese Fähigkeit die Zuverlässigkeit, indem sie dem Agent explizite Einschränkungen gibt, anstatt ihn zu zwingen, diese von Grund auf abzuleiten.
 
Sobald Ihr Agent über die PixVerse-Kenntnisse verfügt, können Sie ihm Anweisungen in natürlicher Sprache geben wie:
 
- „Generieren Sie aus diesem Screenshot ein 10-sekündiges Produktdemovideo.“
- „Erstellen Sie vier Variationen dieses Blog-Titelbilds im 16:9-Format“
- „Animieren Sie dieses Diagramm in einen 5-Sekunden-Erklärclip mit Umgebungsgeräuschen“
- „Erzeugen Sie drei 8-sekündige 16:9-Werbeclips mit unterschiedlichen Kamerabewegungen“
 
Der Agent übersetzt diese Anweisungen in die richtigen CLI-Befehle, analysiert die JSON-Ausgabe und kümmert sich um Abfragen und Downloads – kein manueller Eingriff erforderlich.
 
### Claude Code
 
In Claude Code wird PixVerse CLI zu einem nativen Tool, das der Agent autonom verwendet. Nachdem Sie die PixVerse-Fähigkeiten geladen haben, können Sie die Medienerstellung direkt in jede Aufgabe einbinden:```
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 ruft die richtigen CLI-Befehle auf, analysiert die Bild-URL aus der JSON-Antwort und lädt die Datei in Ihren angegebenen Pfad herunter – alles innerhalb derselben Sitzung, in der auch Ihr Code geschrieben wird.
 
Ein typischer Claude Code-Workflow:```bash
# 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
 
Cursor-Benutzer können PixVerse Skills als Projektkontextdatei laden. Platzieren Sie die relevanten Skilldateien in Ihrem `.cursor/`-Verzeichnis oder fügen Sie sie Ihren Arbeitsbereichsregeln hinzu. Sobald es geladen ist, kennt Cursor alle PixVerse-CLI-Befehle vollständig und kann im Rahmen jeder Codierungsaufgabe Medien generieren.
 
Ein gängiger Cursor-Workflow: Bitten Sie den Agenten, ein Mockup-Bild basierend auf einem von Ihnen erstellten Design zu erstellen, und verwenden Sie es dann direkt in Ihrer IDE-Sitzung als Referenz – ohne jemals den Editor zu verlassen.
 
### Codex und andere Agenten
 
PixVerse CLI ist mit jedem Agenten kompatibel, der Shell-Befehle ausführen und JSON analysieren kann. Das strukturierte Ausgabeformat – konsistente Feldnamen, vorhersehbare Fehlercodes und durch stderr getrennte Fehlermeldungen – stellt sicher, dass selbst einfache Skriptagenten die Generierung zuverlässig integrieren können.
 
Der Exit-Code-Vertrag vereinfacht die Fehlerbehandlung:
 
| Code | Bedeutung | Agentenaktion |
|:---|:---|:---|
| 1 | Allgemeiner Fehler | Überprüfen Sie stderr und versuchen Sie es erneut mit validierten Eingaben |
| 0 | Erfolg | JSON-Ausgabe analysieren |
| 2 | Zeitüberschreitung | Versuchen Sie es erneut mit längerem `--timeout` |
| 3 | Authentifizierung abgelaufen | Führen Sie `pixverse auth login` | erneut aus
| 4 | Kein Abspann mehr | Guthaben prüfen, Benutzer benachrichtigen |
| 5 | Generierung fehlgeschlagen | Probieren Sie verschiedene Parameter aus |
| 6 | Validierungsfehler | Flag-Werte überprüfen |
 
## Automatisierungspipelines
 
Sobald Sie die einzelnen Befehle verstanden haben, schaltet PixVerse CLI leistungsstarke mehrstufige Arbeitsabläufe frei, die völlig ohne Benutzerinteraktion ausgeführt werden.
 
### Text zu Bild zu Video
 
Eine der nützlichsten Pipelines: Generieren Sie aus einer Textaufforderung ein hochauflösendes Bild und animieren Sie es dann zu einem Video.```bash
# 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 Videoproduktionspipeline
 
Für eine polierte Ausgabe Kettenerstellung mit Nachbearbeitungsschritten:```bash
# 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
```### Batch-Generierung
 
Für Inhaltspipelines, die mehrere Variationen erfordern, führen Sie Jobs parallel aus:```bash
# 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
```Das Flag `--no-wait` sendet den Job und kehrt sofort mit einer Aufgaben-ID zurück, sodass Sie vor der Abfrage mehrere Jobs senden können. Der Befehl `pixverse task wait` übernimmt die adaptive Abfrage für Sie – es sind keine manuellen Schlafschleifen erforderlich.
 
## Standardeinstellungen konfigurieren
 
Wenn Sie stets dasselbe Modell, dieselbe Qualität oder dasselbe Seitenverhältnis verwenden, legen Sie diese als Standardwerte fest, damit Sie die Markierungen nicht jedes Mal wiederholen müssen:```bash
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
```Befehlszeilenflags setzen Ihre konfigurierten Standardeinstellungen immer außer Kraft, sodass Sie die volle Flexibilität behalten und gleichzeitig Wiederholungen reduzieren.
 
## Was Sie bauen können
 
Durch die Integration von PixVerse CLI in Ihren Agenten-Workflow erweitert sich das Spektrum automatisierbarer Aufgaben erheblich:
 
- **Dokumentation** – Generieren Sie im Rahmen Ihres Dokumenterstellungsprozesses automatisch Produktdemovideos und Screenshots
- **Marketing** – Führen Sie nächtliche Batch-Jobs aus, die Variationen von Social-Media-Inhalten aus einer einzigen Eingabeaufforderungsbibliothek erstellen
- **App-Entwicklung** – Lassen Sie Ihren Programmieragenten Platzhaltervisualisierungen, Mockup-Animationen oder Ladebildschirmvideos generieren, während Sie die Benutzeroberfläche erstellen
- **Content-Pipelines** – verketten Sie CLI-Aufrufe mit anderen Tools (ffmpeg, ImageMagick, Cloud-Speicher), um vollständig automatisierte Medienproduktions-Workflows zu erstellen
- **Prototyping** – Erstellen Sie in Sekundenschnelle schnelle Konzepte, um Ideen zu validieren, bevor Sie mit der vollständigen Produktion beginnen
 
Die CLI ist so konzipiert, dass sie sich natürlich in jeden Shell-basierten Workflow einfügt. Wenn Ihre vorhandene Automatisierung in Bash, Python, Node oder einer CI/CD-Pipeline ausgeführt wird, fügt sich PixVerse CLI ohne zusätzlichen Integrationsaufwand ein.
 
## Checkliste für den Einstieg
 
- [ ] Installieren Sie Node.js 20 oder höher
- [ ] Führen Sie `npm install -g pixverse` aus
- [ ] Führen Sie `pixverse auth login` aus und autorisieren Sie es im Browser
- [ ] Führen Sie `pixverse account info` aus, um die Gutschrift zu überprüfen
- [ ] Generieren Sie Ihr erstes Bild: `pixverse create image --prompt "..." --json`
- [ ] Erstelle dein erstes Video: `pixverse create video --prompt "..." --json`
- [ ] Installieren Sie PixVerse Skills für Ihren Agenten (Claude Code, Cursor oder Codex)
- [ ] Richten Sie Ihre bevorzugten Standardeinstellungen mit `pixverse config defaults set` ein
- [ ] Erstellen Sie Ihre erste Automatisierungspipeline
 
## Die CLI auf dem neuesten Stand halten
 
Verwenden Sie npm, um Ihre lokale CLI auf dem neuesten Stand zu halten:```bash
npm update -g pixverse
```Informationen zu Änderungen auf Release-Ebene und neu unterstützten Modellen finden Sie im offiziellen CLI-Änderungsprotokoll:
 
- [PixVerse CLI Changelog](https://github.com/PixVerseAI/cli/blob/main/CHANGELOG.md)
 
## Nächste Schritte
 
Mit der PixVerse-CLI auf npm (`npm install -g pixverse`) erhalten Sie über eine einzige Schnittstelle sofortigen Zugriff auf Generierung, Aufgabenabfrage, Asset-Management, gespeicherte Ordner und Arbeitsbereichssteuerelemente. Der [PixVerse Skills repository](https://github.com/PixVerseAI/skills) bietet agentenbereite Anleitungen, sodass Claude Code, Cursor, Codex und andere Tools diese Arbeitsabläufe zuverlässiger ausführen können.
 
Die Kombination aus einer zuverlässigen CLI und einer agentenbereiten Skill-Bibliothek bedeutet, dass die Bild- und Videogenerierung im selben Workflow wie Ihr Code erfolgen kann – verwaltet von demselben Agenten, im selben Terminal, ohne die Tools zu wechseln.
 
Beginnen Sie mit einem einzigen Befehl. Bauen Sie von dort aus.