PixVerse CLI: AI-video's en afbeeldingen genereren in de terminal
Inleiding
Elke creatieve workflow heeft een knelpunt — het moment waarop je je code-editor moet verlaten, een browser moet openen en handmatig door een webinterface moet klikken om media te genereren. Voor ontwikkelaars, AI-agents en iedereen die geautomatiseerde contentpipelines bouwt, veroorzaakt die contextwisseling extra werk dat snel oploopt.
PixVerse CLI neemt dat knelpunt weg. Het is de officiële opdrachtregelinterface voor PixVerse en geeft je rechtstreeks vanuit je terminal toegang tot de generatie- en werkruimteworkflows van PixVerse. Tekst-naar-video, afbeelding-naar-video, tekst-naar-afbeelding, afbeelding-naar-afbeelding, overgangen, stemgeneratie, muziekgeneratie, referentievideo, bewegingsbesturing, sjablonen, resolutieverhoging en mediabeheer zijn allemaal via scripts te gebruiken, met pipes te verbinden en beschikbaar zonder een browser te openen. Begin voor de kortste installatieroute en een overzicht van de agentconfiguratie op de officiële PixVerse CLI-pagina.
Wat PixVerse CLI bijzonder nuttig maakt, is de ontwerpfilosofie: de tool is gebouwd met AI-agents in gedachten. Opdrachten kunnen gestructureerde JSON retourneren met --json of -p, exitcodes zijn deterministisch en elke pipelinestap is combineerbaar. Daardoor kun je Claude Code, Cursor, Codex of een andere agent leren om namens jou afbeeldingen, video’s, stemgeluid en muziek te genereren, met minder kwetsbare overdrachten.
Deze gids sluit aan op het huidige GitHub README van PixVerseAI/cli, het openbare mogelijkhedenmanifest en de productpagina van PixVerse CLI, gecontroleerd op 13 juli 2026. PixVerse CLI wordt voortdurend bijgewerkt via de GitHub-repository, dus productiescripts moeten vóór een grote batchrun nog steeds pixverse --version, pixverse create <mode> --help en pixverse update controleren.
Vereisten
Voordat je begint, heb je het volgende nodig:
- Node.js 20 of hoger — controleer dit met
node --version - Een PixVerse-account — meld je aan op pixverse.ai
- Een actief PixVerse-abonnement — de CLI gebruikt hetzelfde creditsysteem als de website; alleen gebruikers met een abonnement kunnen content genereren
Voor PixVerse CLI hoef je geen API-sleutels handmatig te kopiëren. Authenticatie verloopt via een browsergebaseerde OAuth-procedure die je token lokaal opslaat.
Stap 1: De CLI installeren
Installeer globaal met npm:
npm install -g pixverseControleer de installatie:
pixverse --versionAls je liever niet globaal installeert, kun je opdrachten ook via npx uitvoeren:
npx pixverse create video --prompt "A cat walking on Mars"Stap 2: Authenticeren
Voer de aanmeldopdracht uit:
pixverse auth loginDe CLI opent een browser voor OAuth-apparaatautorisatie. Je kunt ook de URL kopiëren en de autorisatie vanuit elke browser op elk apparaat voltooien, wat handig is voor SSH en omgevingen zonder grafische interface. Je token wordt automatisch opgeslagen in ~/.pixverse/ en is 30 dagen geldig.
Om te controleren of je bent aangemeld en hoeveel credits je beschikbaar hebt:
pixverse auth status
pixverse account info
pixverse account slotsDe opdracht account info toont je abonnementsniveau, werkruimtecredits en gebruikscontext. pixverse account usage helpt je het creditverbruik te bekijken, terwijl pixverse account slots de huidige plekken voor gelijktijdige generatie van afbeeldingen en video’s toont. CLI-sessies zijn onafhankelijk van PixVerse-web-/app-sessies en je kunt het opgeslagen CLI-token verwijderen met pixverse auth logout. Controleer altijd je saldo en beschikbare plekken voordat je batchtaken uitvoert.
Opdrachten om snel te beginnen
Als je alleen de kortste route van installatie naar een gegenereerd mediabestand nodig hebt, begin dan met deze reeks:
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 --jsonHoud voor agent- en CI-workflows --json of -p ingeschakeld, zodat stdout machineleesbaar blijft en voortgang en fouten op stderr blijven. Voeg voor herhaalde pogingen in productie --idempotency-key <key> toe aan aanmaakopdrachten, zodat herhaalde inzendingen niet per ongeluk dubbele taken aanmaken waarvoor credits worden afgeschreven.
Stap 3: Je eerste afbeelding genereren
Tekst-naar-afbeeldinggeneratie is de snelste manier om je configuratie te testen. Voer uit:
pixverse create image --prompt "A photorealistic forest path at golden hour" --jsonHet huidige GitHub README vermeldt GPT Image 2 als het standaard afbeeldingsmodel. Stel voor reproduceerbare automatiseringen toch --model expliciet in en controleer vóór batchwerk de actuele CLI-help of capabilities.json. De optie --json retourneert gestructureerde uitvoer:
{
"image_id": 789012,
"status": "completed",
"image_url": "https://...",
"prompt": "A photorealistic forest path at golden hour",
"model": "gpt-image-2.0",
"width": 1440,
"height": 1440
}Geef voor uitvoer met een hogere resolutie een model op dat dit ondersteunt:
pixverse create image \
--prompt "A photorealistic forest path at golden hour" \
--model seedream-5.0-lite \
--quality 2160p \
--aspect-ratio 16:9 \
--jsonPixVerse ondersteunt verschillende afbeeldingsmodellen, elk met andere maximale resoluties en ondersteuning voor beeldverhoudingen:
| Model | Waarde voor --model |
Kwaliteit | Opmerkingen |
|---|---|---|---|
| GPT Image 2 | gpt-image-2.0 |
1080p, 1440p, 2160p | Standaard afbeeldingsmodel; ondersteunt brede en hoge beeldverhoudingen |
| Nano Banana 2 | gemini-3.1-flash |
512p, 1080p, 1440p, 2160p | Flexibele auto en standaardbeeldverhoudingen |
| Nano Banana 2 Lite | gemini-3.1-flash-lite |
1080p | Lichtgewicht Nano Banana 2-optie voor snelle afbeeldingsworkflows |
| Qwen Image | qwen-image |
720p, 1080p | Snelle generatie voor gangbare creatieve taken |
| Nano Banana Pro | gemini-3.0 |
1080p, 1440p, 2160p | Afbeeldingen van hoge kwaliteit maken op grotere formaten |
| Nano Banana | gemini-2.5-flash |
1080p | Lichtgewicht afbeeldingsgeneratie met een korte doorlooptijd |
| Seedream 5.0 Pro | seedream-5.0-pro |
1080p, 1440p | Ondersteunt standaardbeeldverhoudingen en afbeeldingsworkflows met meerdere referenties |
| Seedream 5.0 Lite | seedream-5.0-lite |
1440p, 1800p, 2160p | Creatieve afbeeldingen met veel detail |
| Seedream 4.5 | seedream-4.5 |
1440p, 2160p | Afbeeldingsgeneratie met hoge resolutie |
| Seedream 4.0 | seedream-4.0 |
1080p, 1440p, 2160p | Extra Seedream-optie voor afbeeldingsworkflows |
| Kling Image O3 | kling-image-o3 |
1080p, 1440p, 2160p | Gestileerde visuele resultaten met flexibele kadrering |
| Kling Image V3 | kling-image-v3 |
1080p, 1440p | Evenwicht tussen kwaliteit en snelheid |
Je kunt ook een bestaande afbeelding transformeren met afbeelding-naar-afbeelding:
pixverse create image \
--prompt "Turn this product photo into a clean watercolor illustration" \
--image ./product-photo.png \
--model gpt-image-2.0 \
--jsonOm de gegenereerde afbeelding te downloaden:
pixverse asset download 789012Stap 4: Je eerste video genereren
Tekst-naar-video werkt op dezelfde manier. Genereer een clip van 5 seconden:
pixverse create video --prompt "A sunset over ocean waves" --jsonVoor een volledig aangepaste generatie:
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 \
--jsonDe optie --audio schakelt AI-gegenereerd omgevingsgeluid in dat bij je videocontent past. De optie --json retourneert na voltooiing een video_url die je rechtstreeks kunt doorgeven aan een downloadopdracht of de volgende stap in een pipeline.
PixVerse biedt meerdere videomodellen met verschillende ondersteuning voor kwaliteit, duur en modi:
| Model | Waarde voor --model |
Maximale kwaliteit | Duur | Opmerkingen |
|---|---|---|---|---|
| PixVerse V6 | v6 |
1080p | 1–15 sec | Standaard videomodel; brede ondersteuning voor beeldverhoudingen |
| PixVerse C1 | pixverse-c1 |
1080p | 1–15 sec | Uitgebreide ondersteuning voor video-, referentie- en overgangsworkflows |
| Seedance 2.0 Standard | seedance-2.0-standard |
2160p | 4–15 sec | Ondersteunt video-, referentie- en overgangsmodi |
| Seedance 2.0 Fast | seedance-2.0-fast |
720p | 4–15 sec | Snellere Seedance-optie voor video-, referentie- en overgangsmodi |
| Seedance 2.0 Mini | seedance-2.0-mini |
720p | 4–15 sec | Lichtgewicht Seedance-optie voor video-, referentie- en overgangsmodi |
| Google Gemini Omni | gemini-omni-flash |
720p | 3–10 sec | Ondersteunt video- en referentieworkflows in 16:9 of 9:16 |
| Happy Horse 1.0 | happyhorse-1.0 |
1080p | 3–15 sec | Video-optie die rekening houdt met audio, beschikbaar voor create video |
| Kling O3 Pro | kling-o3-pro |
720p | 3–15 sec | Ondersteunt video-, referentie- en overgangsworkflows |
| Kling O3 Standard | kling-o3-standard |
720p | 3–15 sec | Standaard Kling O3-optie |
| Kling 3.0 Pro | kling-3.0-pro |
720p | 3–15 sec | Ondersteunt video- en overgangsworkflows |
| Kling 3.0 Standard | kling-3.0-standard |
720p | 3–15 sec | Standaard Kling 3.0-optie |
| Grok Imagine 1.5 | grok-imagine-1.5 |
720p | 1–15 sec | Alleen afbeelding-naar-video; vereist --image en volgt de beeldverhouding van de invoerafbeelding |
| Grok Imagine | grok-imagine |
720p | 1–15 sec | Eerdere Grok-optie; ondersteunt video-, verlengings- en referentieworkflows |
| Veo 3.1 Lite | veo-3.1-lite |
1080p | 4, 6 of 8 sec | Ondersteunt video- en overgangsworkflows met 2 frames |
| Veo 3.1 Standard | veo-3.1-standard |
2160p | 4, 6 of 8 sec | Veo-optie met hogere resolutie |
| Veo 3.1 Fast | veo-3.1-fast |
2160p | 4, 6 of 8 sec | Snellere Veo-optie |
| Sora 2 Pro | sora-2-pro |
1080p | 4, 8 of 12 sec | Sora-optie met vaste duur |
| Sora 2 | sora-2 |
720p | 4, 8 of 12 sec | Standaard Sora-optie |
| PixVerse v5.6 | v5.6 |
1080p | 1–10 sec | Wordt nog gebruikt voor bewegingsbesturing en bepaalde generatieworkflows |
| PixVerse v5.5 | v5.5 |
1080p | 1–10 sec | Wordt gebruikt voor create modify-workflows |
| PixVerse v5 | v5 |
1080p | 1–10 sec | Wordt gebruikt voor overgangsworkflows met 3+ frames |
Partnermodellen zoals Seedance, Kling, Veo, Sora, Gemini Omni, Grok Imagine en HappyHorse zijn opties op PixVerse. Gebruik dezelfde CLI-interface om ze te vergelijken met PixVerse V6 en C1.
Een statische afbeelding animeren
Geef de optie --image op om een foto of gegenereerde afbeelding in een video om te zetten:
pixverse create video \
--prompt "Gentle wind moves through the scene" \
--image ./product-photo.jpg \
--model v6 \
--quality 1080p \
--jsonJe kunt een lokaal bestandspad of een URL opgeven. Lokale bestanden worden automatisch geüpload — een handmatige uploadstap is niet nodig. Lokale invoerafbeeldingen die groter zijn dan 1920x1920 of 5MB worden vóór het uploaden automatisch verkleind of gecomprimeerd; externe afbeeldings-URL’s worden ongewijzigd door de backend gevalideerd.
Voor Grok Imagine 1.5 is een afbeelding vereist en volgt de beeldverhouding van de uitvoer die van de afbeelding:
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 \
--jsonReferenties, overgangen, bewegingsbesturing en sjablonen gebruiken
De huidige CLI ondersteunt meer dan eenvoudige tekst-naar-video en afbeelding-naar-video. Deze aanmaakmodi zijn handig wanneer je meer controle nodig hebt over personages, sleutelframes, bewerkingen of effecten:
# 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
pixverse create upscale --video <video_id> --quality 1080p
# 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.pngNiet elk model ondersteunt elke aanmaakmodus. In de huidige README-matrix ondersteunt create video v6, pixverse-c1, Seedance 2.0 Standard/Fast/Mini, Google Gemini Omni, Happy Horse 1.0, Kling O3, Kling 3.0, Grok Imagine, Veo 3.1, Sora 2 en v5.6. grok-imagine-1.5 ondersteunt alleen afbeelding-naar-video en vereist --image; create extend ondersteunt v6 en grok-imagine; create reference ondersteunt v6, pixverse-c1, Seedance 2.0 Standard/Fast/Mini, Google Gemini Omni, Kling O3, grok-imagine en v5.6; overgangen met 2 frames ondersteunen de nieuwere videofamilies; overgangen met 3+ frames gebruiken v5; create modify gebruikt v5.5; en create motion-control gebruikt v5.6.
Stap 5: Stemgeluid en muziek genereren
Het huidige GitHub README beschrijft zelfstandige audio via specifieke aanmaakopdrachten. Gebruik create voice voor tekst-naar-spraak en create music voor het genereren van muziek op basis van een prompt. Stem- en muziekuitvoer worden opgeslagen als audiobestanden, zodat je ze kunt volgen met task, weergeven in een lijst met asset list --type audio en downloaden met asset download --type audio. Gebruik voor ingebouwd omgevingsgeluid in video’s --audio of --no-audio bij ondersteunde opdrachten voor het maken van video’s.
Genereer stemgeluid:
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 \
--jsonBekijk stemmodellen en vooraf ingestelde stemmen:
pixverse voice models --json
pixverse voice presets --model speech-2.8-hd --jsonMuziek genereren:
pixverse create music \
--prompt "A bright cinematic synth-pop track for a 30-second product reveal" \
--auto-lyrics \
--duration-seconds 30 \
--jsonGebruik --instrumental voor instrumentale nummers. Voor modellen die songteksten ondersteunen, geef je de songtekst mee als letterlijke tekst, een lokaal bestandspad of stdin:
pixverse create music \
--prompt "Uplifting electronic pop with a confident chorus" \
--lyrics ./lyrics.txt \
--jsonDe huidige families van stemmodellen omvatten MiniMax Speech 2.8 en ElevenLabs-modellen. De huidige families van muziekmodellen omvatten MiniMax Music, ElevenLabs Music en Google Lyria 3 Pro. Gebruik pixverse voice models en pixverse music models om de actuele catalogus te bekijken voordat je een script voor een productieworkflow schrijft.
Stap 6: De interactieve wizard uitvoeren
Als je voor het eerst aan het verkennen bent en nog niet alle beschikbare opties kent, voer dan een willekeurige aanmaakopdracht zonder argumenten uit om de begeleide wizard te starten:
pixverse create video
pixverse create imageDe wizard begeleidt je stap voor stap bij de prompt, modelkeuze, kwaliteit, beeldverhouding, duur en andere opties — handig om te ontdekken welke parameters beschikbaar zijn voordat je ze in een script gebruikt.
Meer dan genereren: beheer je mediabestanden en werkruimte
De huidige PixVerse CLI bevat ook beheeropdrachten waarmee je complete terminalworkflows kunt bouwen:
pixverse task status <id>enpixverse task wait <id>voor het periodiek opvragen van de taakstatuspixverse task status --ids 123,456,789 --type video --jsonvoor statuscontroles in batchespixverse asset list,asset upload,asset info,asset downloadenasset deletevoor het beheer van video-, beeld- en audiobestanden gedurende hun levenscycluspixverse saved list,saved items,saved new,saved rename,saved add,saved removeensaved deletevoor opgeslagen mappenpixverse template categories,template list,template searchentemplate infovoor het ontdekken van effecten en sjablonenpixverse voice models,voice presetsenmusic modelsvoor het ontdekken van actuele audiomodellenpixverse workspace list,workspace status,workspace switchenworkspace managevoor bewerkingen in meerdere werkruimtenpixverse account info,account usageenaccount slotsvoor controles van credits, gebruik en gelijktijdige verwerkingpixverse config set,config list,config pathenconfig defaultsvoor herhaalbare lokale standaardinstellingen
Hiermee kun je eenvoudig niet alleen het aanmaken, maar ook het organiseren, ontdekken van sjablonen en audio, downloaden, routeren naar werkruimten en opleveren in één script automatiseren. Als je één opdracht voor een andere werkruimte wilt uitvoeren, gebruik je de globale optie --workspace-id <id>; 0 richt zich op je persoonlijke werkruimte.
Opties voor scripts
De meeste automatisering is afhankelijk van voorspelbare uitvoer en voorspelbaar gedrag tijdens de uitvoering. Deze opties zijn bijzonder handig in scripts en workflows met AI-agenten:
| Optie | Gebruik |
|---|---|
--json |
Gestructureerde JSON-uitvoer retourneren |
-p |
Korte alias voor --json |
--count <n> |
1–4 variaties genereren vanuit één verzoek |
--seed <number> |
Een generatie eenvoudiger reproduceerbaar maken |
--off-peak |
Dalurentarieven gebruiken wanneer beschikbaar |
--audio / --no-audio |
Audiogeneratie in- of uitschakelen bij ondersteunde aanmaakopdrachten |
--multi-shot / --no-multi-shot |
De modus voor meerdere shots in- of uitschakelen voor video |
--no-wait |
De taak indienen en onmiddellijk terugkeren |
--timeout <sec> |
De time-out voor het opvragen van de status instellen, standaard 300 seconden |
--workspace-id <id> |
De actieve werkruimte voor één opdracht overschrijven |
--trace-id <uuid> |
Een door de aanroeper aangeleverde UUIDv4 toevoegen aan API-verzoeken voor foutopsporing en waarneembaarheid |
--idempotency-key <key> |
Aanmaakverzoeken veilig opnieuw proberen zonder per ongeluk dubbele betaalde taken aan te maken |
Opties voor tekstinvoer zijn nu eenvoudiger te automatiseren. --prompt, --text en --lyrics accepteren een letterlijke tekenreeks, een lokaal bestandspad of - voor 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 --jsonJe AI-agent leren media te genereren
Voor teams die liever beginnen met begeleiding in een app voordat ze overstappen op automatisering via de opdrachtregel, biedt PixVerse Agent een op agenten gerichte creatieworkflow in de PixVerse-app.
Hier maakt PixVerse CLI echt het verschil. Omdat opdrachten gestructureerde JSON kunnen retourneren en deterministische afsluitcodes gebruiken, kun je elke AI-agent die shellopdrachten kan uitvoeren leren om op verzoek afbeeldingen en video’s te genereren.
PixVerse Skills installeren
PixVerse Skills is een gestructureerde bibliotheek met vaardigheden die agenten leert hoe ze de CLI correct gebruiken: opdrachtopties, modelbeperkingen, pijplijnen met meerdere stappen en robuuste foutafhandeling.
Voeg voor Claude Code en andere agenten die het skills-formaat ondersteunen de PixVerse-vaardigheden rechtstreeks toe:
npx skills add https://github.com/pixverseai/skills --skill pixverse-ai-image-and-video-generatorVoor Cursor, Claude Code, Codex en andere agentframeworks verbetert deze vaardigheid de betrouwbaarheid door de agent expliciete beperkingen te geven, zodat die ze niet helemaal zelf hoeft af te leiden.
PixVerse CLI levert ook een compact, machineleesbaar opdrachtmanifest op dist/capabilities.json, waarvan de openbare bron beschikbaar is als capabilities.json in de GitHub-repository. Dit manifest beschrijft opdrachten, opties, afsluitcodes, verwachte JSON-uitvoer en effectcategorieën, zodat agenten het CLI-contract kunnen bekijken zonder helptekst te scrapen.
Zodra je agent de PixVerse-vaardigheden heeft geladen, kun je instructies in natuurlijke taal geven, zoals:
- “Genereer een productdemovideo van 10 seconden op basis van deze schermafbeelding”
- “Maak vier variaties van deze blogomslagafbeelding in 16:9-formaat”
- “Animeer dit diagram tot een uitlegclip van 5 seconden met omgevingsgeluid”
- “Genereer drie promotieclips van 8 seconden in 16:9 met verschillende camerabewegingen”
De agent vertaalt deze instructies naar de juiste CLI-opdrachten, verwerkt de JSON-uitvoer en handelt het opvragen van de status en het downloaden af — zonder handmatige tussenkomst.
Claude Code
In Claude Code wordt PixVerse CLI een geïntegreerd hulpmiddel dat de agent zelfstandig gebruikt. Nadat je de PixVerse-vaardigheden hebt geladen, kun je mediageneratie rechtstreeks in elke taak opnemen:
Genereer een omslagafbeelding voor deze blogpost over machine learning, gebruik het seedream-5.0-lite-model op 2160p in 16:9-formaat en download de afbeelding naar ./assets/cover.webp
Claude Code roept de juiste CLI-opdrachten aan, haalt de afbeeldings-URL uit het JSON-antwoord en downloadt het bestand naar het opgegeven pad — allemaal binnen dezelfde sessie waarin het ook je code schrijft.
Een typische Claude Code-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 \
--jsonCursor
Cursor-gebruikers kunnen PixVerse Skills laden als een contextbestand voor hun project. Plaats de relevante vaardigheidsbestanden in je map .cursor/ of voeg ze toe aan je werkruimteregels. Na het laden kent Cursor elke PixVerse CLI-opdracht volledig en kan het media genereren als onderdeel van elke programmeertaak.
Een veelgebruikte Cursor-workflow: vraag de agent om een mockupafbeelding te genereren op basis van een ontwerp waaraan je werkt en gebruik die vervolgens rechtstreeks als referentie in je IDE-sessie — zonder de editor te verlaten.
Codex en andere agenten
PixVerse CLI is compatibel met elke agent die shellopdrachten kan uitvoeren en JSON kan verwerken. Het gestructureerde uitvoerformaat — consistente veldnamen, voorspelbare foutcodes en foutmeldingen die apart via stderr worden verzonden — zorgt ervoor dat zelfs eenvoudige scriptagenten generatie betrouwbaar kunnen integreren.
Het afsluitcodecontract maakt foutafhandeling eenvoudig:
| Code | Betekenis | Actie van de agent |
|---|---|---|
| 0 | Geslaagd | JSON-uitvoer verwerken |
| 1 | Algemene fout | stderr controleren en opnieuw proberen met gevalideerde invoer |
| 2 | Time-out | Opnieuw proberen met een langere --timeout |
| 3 | Authenticatie verlopen | pixverse auth login opnieuw uitvoeren |
| 4 | Geen credits meer | Saldo controleren, gebruiker informeren |
| 5 | Generatie mislukt | Andere parameters proberen |
| 6 | Validatiefout | Optiewaarden controleren |
Automatiseringspijplijnen
Zodra je de afzonderlijke opdrachten begrijpt, maakt PixVerse CLI krachtige workflows met meerdere stappen mogelijk die volledig zonder gebruikersinteractie worden uitgevoerd.
Van tekst naar afbeelding naar video
Een van de handigste pijplijnen: genereer een afbeelding met hoge resolutie vanuit een tekstprompt en animeer die vervolgens tot een video.
# 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" --jsonVolledige videoproductiepijplijn
Combineer het aanmaken met nabewerkingsstappen voor een verzorgd resultaat. Gebruik --audio of --no-audio als je ingebouwd geluid wilt bij ondersteunde videoaanmaakopdrachten. Gebruik vervolgens create voice voor tekst-naar-spraakaudio en create music voor losse muziekbestanden die je later in de workflow combineert:
# 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 1080p
FINAL=$(pixverse create upscale \
--video "$EXTENDED" \
--quality 1080p \
--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 \
--jsonGenereren in batches
Voer taken parallel uit voor contentpijplijnen die meerdere variaties vereisen:
# 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
doneDe optie --no-wait dient de taak in en retourneert onmiddellijk een taak-ID, zodat je meerdere taken kunt indienen voordat je hun status opvraagt. Leg met --no-wait --json de geretourneerde taak-ID’s en de uiteindelijke aanmaakparameters vast voor logregistratie en reproduceerbaarheid. Gebruik --count <n> als je meerdere variaties op basis van één prompt wilt, en gebruik batchgewijs task status --ids als je één statusantwoord voor meerdere lopende taken wilt. De opdracht pixverse task wait regelt het adaptief opvragen van de status voor je.
Standaardinstellingen configureren
Als je steeds hetzelfde model, dezelfde kwaliteit of dezelfde beeldverhouding gebruikt, stel die dan als standaard in, zodat je de opties niet telkens hoeft te herhalen:
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 pathOpdrachtregelopties hebben altijd voorrang op je geconfigureerde standaardinstellingen, zodat je volledige flexibiliteit behoudt en minder hoeft te herhalen. Voeg voor werkruimtespecifieke automatisering --workspace-id <id> toe aan een opdracht als je de actieve werkruimte voor die ene uitvoering wilt overschrijven.
Wat je kunt bouwen
Wanneer PixVerse CLI in je agentworkflow is geïntegreerd, neemt het aantal taken dat je kunt automatiseren aanzienlijk toe:
- Documentatie — genereer automatisch productdemovideo’s en schermafbeeldingen als onderdeel van het bouwproces van je documentatie
- Marketing — voer elke nacht batchtaken uit die variaties van socialemediacontent produceren vanuit één promptbibliotheek
- Appontwikkeling — laat je programmeeragent tijdelijke afbeeldingen, mockupanimaties of video’s voor laadschermen genereren terwijl je de gebruikersinterface bouwt
- Audioworkflows — genereer conceptvoice-overs, muzieknummers op basis van prompts of audiobestanden om later te bewerken
- Contentpijplijnen — koppel CLI-aanroepen aan andere hulpmiddelen (ffmpeg, ImageMagick, cloudopslag) om volledig geautomatiseerde mediaproductieworkflows te bouwen
- Prototyping — genereer in enkele seconden snelle bewegingsconcepten om ideeën te toetsen voordat je overgaat tot volledige productie
De CLI is ontworpen om naadloos in elke shellgebaseerde workflow te passen. Als je bestaande automatisering in bash, Python, Node of een CI/CD-pijplijn draait, kun je PixVerse CLI toevoegen zonder extra integratiewerk.
Checklist om aan de slag te gaan
- Installeer Node.js 20 of hoger
- Voer
npm install -g pixverseuit - Voer
pixverse auth loginuit en verleen toestemming in de browser - Voer
pixverse account infouit om je credits te controleren - Voer
pixverse account slotsuit voordat je batchtaken gelijktijdig uitvoert - Genereer je eerste afbeelding:
pixverse create image --prompt "..." --json - Genereer je eerste video:
pixverse create video --prompt "..." --json - Genereer je eerste stembestand:
pixverse create voice --text "..." --json - Genereer je eerste muziekbestand:
pixverse create music --prompt "..." --json - Verken sjablonen met
pixverse template list - Installeer PixVerse Skills voor je agent (Claude Code, Cursor of Codex)
- Stel je gewenste standaardinstellingen in met
pixverse config defaults set - Bouw je eerste automatiseringspijplijn
De CLI up-to-date houden
Gebruik de ingebouwde updater om je lokale CLI up-to-date te houden:
pixverse updateJe kunt npm ook rechtstreeks gebruiken:
npm install -g pixverse@latestOmdat PixVerse CLI actief wordt bijgewerkt en geen eenmalige release is, kun je dit artikel het beste als praktische gids gebruiken en de officiële bronnen als actuele referentie. De officiële PixVerse CLI-pagina biedt de kortste route naar installatie en het inwerken van agenten, terwijl GitHub de plek blijft om wijzigingen per release en nieuw ondersteunde modellen te volgen:
- GitHub-repository van PixVerse CLI
- Capaciteitenmanifest van PixVerse CLI
- Wijzigingslogboek van PixVerse CLI
De huidige documentatie belicht PixVerse V6 als standaardvideomodel, GPT Image 2 als standaardafbeeldingsmodel, video-ondersteuning voor Google Gemini Omni, afbeeldingsondersteuning voor Nano Banana 2 Lite en Seedream 5.0 Pro, ondersteuning voor Seedance 2.0 Mini, modusspecifieke workflows voor PixVerse v5 en v5.5, speciale opdrachten create voice en create music, audiobestandsbeheer, opgeslagen mappen, wisselen tussen werkruimten, config defaults, capabilities.json voor agenten, pixverse update, stdin-ondersteuning voor tekstinvoer, --trace-id en --idempotency-key om veiliger opnieuw te proberen.
Volgende stappen
De officiële PixVerse CLI-pagina, PixVerse CLI op GitHub en npm (npm install -g pixverse) geven je vanuit één interface direct toegang tot generatie, het opvragen van taakstatussen, mediabestandsbeheer, sjablonen, opgeslagen mappen, accountcontroles, het ontdekken van audiomodellen en werkruimtebeheer. De PixVerse Skills-repository voegt instructies voor agenten toe, zodat Claude Code, Cursor, Codex en andere hulpmiddelen deze workflows betrouwbaarder kunnen uitvoeren.
De combinatie van een betrouwbare CLI en een vaardigheidsbibliotheek voor agenten betekent dat het genereren van afbeeldingen, video, stemmen en muziek deel kan uitmaken van dezelfde workflow als je code — beheerd door dezelfde agent, in dezelfde terminal, zonder van hulpmiddel te wisselen.
Begin met één opdracht. Bouw van daaruit verder.
Gerelateerde bronnen
- Recensie van de PixVerse V6 AI-videogenerator
- De beste AI-videomodellen op één platform
- Seedance 2.0 nu beschikbaar op PixVerse
- Grok Imagine nu beschikbaar op PixVerse
- Gids voor het PixVerse AI-platform
Genereer video’s, afbeeldingen, stemmen en muziek vanuit je terminal met PixVerse.