Mga tutorial

PixVerse CLI: Bumuo ng mga AI Video at Larawan sa Terminal

Huling na-update noong
PixVerse CLI: Bumuo ng mga AI Video at Larawan sa Terminal

Panimula

Bawat malikhaing workflow ay may bottleneck — ang sandaling kailangan mong umalis sa code editor, magbukas ng browser, at manu-manong mag-click sa isang web interface para bumuo ng isang piraso ng media. Para sa mga developer, AI agent, at sinumang gumagawa ng mga automated na content pipeline, ang context switch na iyon ay alitan na mabilis na naiipon.

PixVerse CLI ang nag-aalis ng bottleneck na iyon. Ito ang opisyal na command-line interface para sa PixVerse, na nagbibigay sa iyo ng access sa pagbuo ng PixVerse at mga workspace workflow nang direkta mula sa iyong terminal. Ang text-to-video, image-to-video, text-to-image, image-to-image, mga transition, pagbuo ng boses, pagbuo ng musika, reference video, motion control, mga template, upscaling, at asset management ay scriptable, pipeable, at available nang hindi hinahawakan ang browser. Para sa pinakamaikling landas ng pag-install at pangkalahatang-ideya ng setup ng agent, magsimula sa opisyal na pahina ng PixVerse CLI.

Ang dahilan kung bakit partikular na kapaki-pakinabang ang PixVerse CLI ay ang pilosopiya ng disenyo nito: ginawa ito na isinasaisip ang mga AI agent. Maaaring magbalik ang mga command ng structured na JSON gamit ang --json o -p, deterministic ang mga exit code, at composable ang bawat hakbang ng pipeline. Ibig sabihin nito, maaari mong turuan ang Claude Code, Cursor, Codex, o anumang ibang agent na bumuo ng mga larawan, video, boses, at musika para sa iyo na may mas kaunting marupok na handoff.

Ang gabay na ito ay nakaayon sa kasalukuyang PixVerseAI/cli GitHub README, sa pampublikong capabilities manifest nito, at sa pahina ng produkto ng PixVerse CLI, sinuri noong Hulyo 13, 2026. Patuloy na ina-update ang PixVerse CLI sa pamamagitan ng GitHub repository, kaya dapat pa ring i-verify ng mga production script ang pixverse --version, pixverse create <mode> --help, at pixverse update bago ang malaking batch run.

Mga Kinakailangan

Bago magsimula, kailangan mo ng:

  • Node.js 20 o mas mataas — suriin gamit ang node --version
  • Isang PixVerse account — mag-sign up sa pixverse.ai
  • Isang aktibong PixVerse subscription — ginagamit ng CLI ang parehong credit system ng website; ang mga naka-subscribe na user lang ang makakabuo ng content

Hindi kailangan ng PixVerse CLI na manu-manong kopyahin ang anumang API key. Hinahawakan ang authentication sa pamamagitan ng browser-based na OAuth flow na lokal na nag-iimbak ng iyong token.

Hakbang 1: I-install ang CLI

I-install nang global gamit ang npm:

npm install -g pixverse

I-verify ang pag-install:

pixverse --version

Kung mas gusto mong hindi mag-install nang global, maaari mo ring patakbuhin ang mga command sa pamamagitan ng npx:

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

Hakbang 2: Mag-authenticate

Patakbuhin ang login command:

pixverse auth login

Binubuksan ng CLI ang isang browser para sa OAuth device authorization. Maaari mo ring kopyahin ang URL at tapusin ang authorization mula sa anumang browser sa anumang device, na kapaki-pakinabang para sa SSH at headless na mga environment. Awtomatikong iniimbak ang iyong token sa ~/.pixverse/ at valid ito sa loob ng 30 araw.

Para i-verify na naka-log in ka at suriin ang iyong available na mga credit:

pixverse auth status
pixverse account info
pixverse account slots

Ipinapakita ng command na account info ang iyong subscription tier, mga workspace credit, at konteksto ng paggamit. Tinutulungan ka ng pixverse account usage na suriin ang pagkonsumo ng credit, habang ipinapakita ng pixverse account slots ang kasalukuyang sabay-sabay na mga generation slot para sa mga trabaho sa larawan at video. Independiyente ang mga CLI session sa mga session ng PixVerse web/app, at maaari mong alisin ang nakaimbak na CLI token gamit ang pixverse auth logout. Laging suriin ang iyong balanse at available na mga slot bago magpatakbo ng mga batch job.

Mga Quick Start Command

Kung kailangan mo lang ng pinakamaikling landas mula sa pag-install patungo sa isang nabuo na asset, magsimula sa sequence na ito:

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

Para sa mga workflow ng agent at CI, panatilihing naka-enable ang --json o -p para manatiling machine-readable ang stdout habang nasa stderr ang progreso at mga error. Para sa mga production retry, idagdag ang --idempotency-key <key> sa mga creation command para ang paulit-ulit na pagsusumite ay hindi aksidenteng lumikha ng duplicate na sisingilin na mga trabaho.

Hakbang 3: Buuin ang Iyong Unang Larawan

Ang text-to-image generation ang pinakamabilis na paraan para subukan ang iyong setup. Patakbuhin:

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

Inililista ng kasalukuyang GitHub README ang GPT Image 2 bilang default na modelo ng larawan. Para sa maaaring ulitin na mga automation, itakda pa rin nang hayagan ang --model at suriin ang live na tulong ng CLI o ang capabilities.json bago ang batch na trabaho. Nagbabalik ng structured na output ang flag na --json:

{
  "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
}

Para sa mas mataas na resolusyon ng output, tukuyin ang isang modelong sumusuporta rito:

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

Sinusuportahan ng PixVerse ang ilang modelo ng larawan, bawat isa ay may iba’t ibang kisame ng resolusyon at suporta sa aspect ratio:

Modelo halaga ng --model Kalidad Mga tala
GPT Image 2 gpt-image-2.0 1080p, 1440p, 2160p Default na modelo ng larawan; sumusuporta sa malapad at mataas na aspect ratio
Nano Banana 2 gemini-3.1-flash 512p, 1080p, 1440p, 2160p Flexible na auto at karaniwang aspect ratio
Nano Banana 2 Lite gemini-3.1-flash-lite 1080p Magaan na opsyon ng Nano Banana 2 para sa mabibilis na workflow ng larawan
Qwen Image qwen-image 720p, 1080p Mabilis na pagbuo para sa karaniwang malikhaing gawain
Nano Banana Pro gemini-3.0 1080p, 1440p, 2160p Mataas na kalidad na paggawa ng larawan sa mas malalaking laki
Nano Banana gemini-2.5-flash 1080p Magaan na pagbuo ng larawan na may mabilis na turnaround
Seedream 5.0 Pro seedream-5.0-pro 1080p, 1440p Sumusuporta sa karaniwang aspect ratio at multi-reference na mga workflow ng larawan
Seedream 5.0 Lite seedream-5.0-lite 1440p, 1800p, 2160p Mataas ang detalye na malikhaing mga larawan
Seedream 4.5 seedream-4.5 1440p, 2160p Pagbuo ng larawan na may mataas na resolusyon
Seedream 4.0 seedream-4.0 1080p, 1440p, 2160p Karagdagang opsyon ng Seedream para sa mga workflow ng larawan
Kling Image O3 kling-image-o3 1080p, 1440p, 2160p Estilong visual na output na may flexible na framing
Kling Image V3 kling-image-v3 1080p, 1440p Balanseng kalidad at bilis

Maaari mo ring baguhin ang isang umiiral na larawan gamit ang image-to-image:

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

Para i-download ang nabuo na larawan:

pixverse asset download 789012

Hakbang 4: Buuin ang Iyong Unang Video

Ganito rin gumagana ang text-to-video. Bumuo ng 5-segundong clip:

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

Para sa lubos na naka-customize na pagbuo:

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

Pinapagana ng flag na --audio ang AI-generated na ambient sound na tumutugma sa content ng iyong video. Nagbabalik ang flag na --json ng video_url kapag tapos na na maaari mong ipasa nang direkta sa isang download command o sa susunod na hakbang sa isang pipeline.

Nagbibigay ang PixVerse ng maraming modelo ng video na may iba’t ibang kalidad, tagal, at suporta sa mode:

Modelo halaga ng --model Pinakamataas na Kalidad Tagal Mga tala
PixVerse V6 v6 1080p 1–15 seg Default na modelo ng video; malawak na suporta sa aspect ratio
PixVerse C1 pixverse-c1 1080p 1–15 seg Malakas na suporta sa mga workflow ng video, reference, at transition
Seedance 2.0 Standard seedance-2.0-standard 2160p 4–15 seg Sumusuporta sa mga mode ng video, reference, at transition
Seedance 2.0 Fast seedance-2.0-fast 720p 4–15 seg Mas mabilis na opsyon ng Seedance para sa mga mode ng video, reference, at transition
Seedance 2.0 Mini seedance-2.0-mini 720p 4–15 seg Magaan na opsyon ng Seedance para sa mga mode ng video, reference, at transition
Google Gemini Omni gemini-omni-flash 720p 3–10 seg Sumusuporta sa mga workflow ng video at reference sa 16:9 o 9:16
Happy Horse 1.0 happyhorse-1.0 1080p 3–15 seg Available ang audio-aware na opsyon ng video para sa create video
Kling O3 Pro kling-o3-pro 720p 3–15 seg Sumusuporta sa mga workflow ng video, reference, at transition
Kling O3 Standard kling-o3-standard 720p 3–15 seg Karaniwang opsyon ng Kling O3
Kling 3.0 Pro kling-3.0-pro 720p 3–15 seg Sumusuporta sa mga workflow ng video at transition
Kling 3.0 Standard kling-3.0-standard 720p 3–15 seg Karaniwang opsyon ng Kling 3.0
Grok Imagine 1.5 grok-imagine-1.5 720p 1–15 seg Image-to-video lang; kailangan ang --image at sumusunod sa aspect ratio ng input na larawan
Grok Imagine grok-imagine 720p 1–15 seg Mas naunang opsyon ng Grok; sumusuporta sa mga workflow ng video, extend, at reference
Veo 3.1 Lite veo-3.1-lite 1080p 4, 6, o 8 seg Sumusuporta sa mga workflow ng video at 2-frame na transition
Veo 3.1 Standard veo-3.1-standard 2160p 4, 6, o 8 seg Mas mataas na resolusyon na opsyon ng Veo
Veo 3.1 Fast veo-3.1-fast 2160p 4, 6, o 8 seg Mas mabilis na opsyon ng Veo
Sora 2 Pro sora-2-pro 1080p 4, 8, o 12 seg Opsyon ng Sora na may nakapirming tagal
Sora 2 sora-2 720p 4, 8, o 12 seg Karaniwang opsyon ng Sora
PixVerse v5.6 v5.6 1080p 1–10 seg Ginagamit pa rin para sa motion-control at piling mga workflow ng pagbuo
PixVerse v5.5 v5.5 1080p 1–10 seg Ginagamit para sa mga workflow ng create modify
PixVerse v5 v5 1080p 1–10 seg Ginagamit para sa mga workflow ng transition na 3+ frame

Ang mga partner model tulad ng Seedance, Kling, Veo, Sora, Gemini Omni, Grok Imagine, at HappyHorse ay mga opsyon sa PixVerse. Gamitin ang parehong CLI surface para ihambing ang mga ito laban sa PixVerse V6 at C1.

I-animate ang isang Static na Larawan

Para gawing video ang isang larawan o nabuo na larawan, ibigay ang flag na --image:

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

Maaari kang magpasa ng lokal na file path o URL. Awtomatikong ina-upload ang mga lokal na file — walang kinakailangang manu-manong hakbang sa pag-upload. Ang mga lokal na input ng larawan na mas malaki sa 1920x1920 o 5MB ay awtomatikong nire-resize o kino-compress bago i-upload; ang mga remote na URL ng larawan ay bini-validate ng backend nang walang binabago.

Para sa Grok Imagine 1.5, kailangan ang isang larawan at sinusundan ng output aspect ratio ang larawang iyon:

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

Gamitin ang Reference, Transition, Motion Control, at mga Template

Sumusuporta ang kasalukuyang CLI sa higit pa sa simpleng text-to-video at image-to-video. Kapaki-pakinabang ang mga creation mode na ito kapag kailangan mo ng mas maraming kontrol sa mga character, keyframe, edit, o effect:

# 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.png

Hindi lahat ng modelo ay sumusuporta sa bawat creation mode. Sa kasalukuyang matrix ng README, sinusuportahan ng create video ang 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, at v5.6. Ang grok-imagine-1.5 ay image-to-video lang at kailangan ang --image; sinusuportahan ng create extend ang v6 at grok-imagine; sinusuportahan ng create reference ang v6, pixverse-c1, Seedance 2.0 Standard/Fast/Mini, Google Gemini Omni, Kling O3, grok-imagine, at v5.6; sinusuportahan ng mga 2-frame na transition ang mas bagong pamilya ng video; gumagamit ang mga transition na 3+ frame ng v5; gumagamit ang create modify ng v5.5; at gumagamit ang create motion-control ng v5.6.

Hakbang 5: Bumuo ng Boses at Musika

Idinodokumento ng kasalukuyang GitHub README ang standalone na audio sa pamamagitan ng mga nakalaang creation command. Gamitin ang create voice para sa text-to-speech at ang create music para sa prompt-to-music na pagbuo. Nase-save ang mga output ng boses at musika bilang mga audio asset, kaya maaari mong subaybayan ang mga ito gamit ang task, ilista ang mga ito gamit ang asset list --type audio, at i-download ang mga ito gamit ang asset download --type audio. Para sa native na ambience ng video, gamitin ang --audio o --no-audio sa mga suportadong command sa paggawa ng video.

Bumuo ng audio ng boses:

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

Mag-browse ng mga modelo ng boses at preset na boses:

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

Gumawa ng musika:

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

Para sa instrumental na mga track, gamitin ang --instrumental. Para sa mga modelong kayang gumawa ng lyrics, ipasa ang lyrics bilang literal na text, lokal na file path, o stdin:

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

Kasama sa kasalukuyang pamilya ng voice model ang MiniMax Speech 2.8 at mga modelong ElevenLabs. Kasama sa kasalukuyang pamilya ng music model ang MiniMax Music, ElevenLabs Music, at Google Lyria 3 Pro. Gamitin ang pixverse voice models at pixverse music models para sa live na katalogo bago mag-script ng production workflow.

Hakbang 6: Patakbuhin ang Interactive Wizard

Kung unang beses mong sinusuri at hindi ka pa pamilyar sa lahat ng available na flag, patakbuhin ang anumang creation command nang walang argument para makapasok sa guided wizard:

pixverse create video
pixverse create image

Hakbang-hakbang kang gagabayan ng wizard sa prompt, pagpili ng modelo, kalidad, aspect ratio, tagal, at iba pang opsyon — kapaki-pakinabang para malaman kung anong mga parameter ang available bago i-script ang mga ito.

Higit pa sa Generation: Pamahalaan ang Iyong mga Asset at Workspace

Kasama rin sa kasalukuyang PixVerse CLI ang mga management command na tumutulong sa iyo na bumuo ng end-to-end na terminal workflow:

  • pixverse task status <id> at pixverse task wait <id> para sa task polling
  • pixverse task status --ids 123,456,789 --type video --json para sa batch status check
  • pixverse asset list, asset upload, asset info, asset download, at asset delete para sa lifecycle operation ng video, image, at audio asset
  • pixverse saved list, saved items, saved new, saved rename, saved add, saved remove, at saved delete para sa mga naka-save na folder
  • pixverse template categories, template list, template search, at template info para sa pagtuklas ng effect at template
  • pixverse voice models, voice presets, at music models para sa live na pagtuklas ng audio model
  • pixverse workspace list, workspace status, workspace switch, at workspace manage para sa multi-workspace na operasyon
  • pixverse account info, account usage, at account slots para sa pagsusuri ng credit, paggamit, at concurrency
  • pixverse config set, config list, config path, at config defaults para sa mauulit na lokal na default

Dahil dito, madaling i-automate hindi lang ang paglikha, kundi pati ang organisasyon, pagtuklas ng template, pagtuklas ng audio, pag-download, workspace routing, at delivery sa iisang script. Kung kailangan mong patakbuhin ang isang command sa ibang workspace, gamitin ang global na flag na --workspace-id <id>; tinutukoy ng 0 ang iyong personal na workspace.

Mga Flag na Madaling Gamitin sa Script

Karamihan sa automation ay umaasa sa predictable na output at predictable na runtime behavior. Lalong kapaki-pakinabang ang mga flag na ito sa mga script at AI-agent workflow:

Flag Gamitin Para sa
--json Magbalik ng structured na JSON output
-p Maikling alias para sa --json
--count <n> Gumawa ng 1–4 na variation mula sa isang request
--seed <number> Gawing mas madaling ulitin ang isang generation
--off-peak Gamitin ang off-peak na presyo kapag available
--audio / --no-audio I-enable o i-disable ang audio generation sa mga suportadong creation command
--multi-shot / --no-multi-shot I-enable o i-disable ang multi-shot mode para sa video
--no-wait Isumite ang job at agad na bumalik
--timeout <sec> Itakda ang polling timeout, na default na 300 segundo
--workspace-id <id> I-override ang aktibong workspace para sa isang command
--trace-id <uuid> Mag-attach ng caller-supplied na UUIDv4 sa mga API request para sa debugging at observability
--idempotency-key <key> Ligtas na ulitin ang mga creation request nang hindi aksidenteng lumilikha ng duplicate na charged job

Mas madali nang i-automate ang mga text input flag. Ang --prompt, --text, at --lyrics ay tumatanggap ng literal na string, lokal na file path, o - para sa 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

Turuan ang Iyong AI Agent na Gumawa ng Media

Para sa mga team na mas gusto ang guided, app-based na panimulang punto bago lumipat sa command-line automation, nagbibigay ang PixVerse Agent ng agent-oriented na creation workflow sa PixVerse app.

Dito tunay na nagiging transformative ang PixVerse CLI. Dahil maaaring magbalik ang mga command ng structured na JSON at gumamit ng deterministic na exit code, anumang AI agent na kayang magpatakbo ng shell command ay maaaring turuan na gumawa ng mga larawan at video on demand.

Pag-install ng PixVerse Skills

Ang PixVerse Skills ay isang structured na skill library na nagtuturo sa mga agent kung paano gamitin nang tama ang CLI: mga command flag, limitasyon ng modelo, multi-step na pipeline, at matatag na error handling.

Para sa Claude Code at iba pang agent na sumusuporta sa skills format, direktang idagdag ang PixVerse skills:

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

Para sa Cursor, Claude Code, Codex, at iba pang agent framework, pinapabuti ng skill na ito ang pagiging maaasahan sa pamamagitan ng pagbibigay sa agent ng malinaw na mga limitasyon sa halip na pilitin itong hulaan ang mga ito mula sa simula.

May kasama ring compact na machine-readable na command manifest ang PixVerse CLI sa dist/capabilities.json, at available ang public source bilang capabilities.json sa GitHub repository. Inilalarawan ng manifest na ito ang mga command, flag, exit code, inaasahang JSON output, at kategorya ng effect, kaya maaaring suriin ng mga agent ang CLI contract nang hindi kinakailangang i-scrape ang help text.

Kapag na-load na ng iyong agent ang PixVerse skills, maaari mo itong bigyan ng natural-language na mga tagubilin tulad ng:

  • “Gumawa ng 10-segundong product demo video mula sa screenshot na ito”
  • “Gumawa ng apat na variation ng blog cover image na ito sa 16:9 na format”
  • “I-animate ang diagram na ito sa 5-segundong explainer clip na may ambient sound”
  • “Gumawa ng tatlong 8-segundong 16:9 promo clip na may magkakaibang galaw ng camera”

Isasalin ng agent ang mga tagubiling iyon sa tamang CLI command, ipa-parse ang JSON output, at hahawakan ang polling at mga download — walang kailangang manu-manong interbensyon.

Claude Code

Sa Claude Code, nagiging native tool ang PixVerse CLI na awtomatikong ginagamit ng agent. Pagkatapos i-load ang PixVerse skills, maaari mong isama ang media generation nang direkta sa anumang task:

Gumawa ng cover image para sa blog post na ito tungkol sa machine learning, gamitin ang modelong seedream-5.0-lite sa 2160p sa 16:9 na format, i-download ito sa ./assets/cover.webp

Tatawagin ng Claude Code ang tamang CLI command, kukunin ang image URL mula sa JSON response, at ida-download ang file sa tinukoy mong path — lahat sa loob ng parehong session kung saan nagsusulat din ito ng iyong code.

Isang tipikal na 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 \
  --json

Cursor

Maaaring i-load ng mga user ng Cursor ang PixVerse Skills bilang project context file. Ilagay ang mga kaugnay na skill file sa iyong direktoryong .cursor/ o idagdag ang mga ito sa workspace rules. Kapag na-load na, may ganap na kamalayan ang Cursor sa bawat PixVerse CLI command at maaaring gumawa ng media bilang bahagi ng anumang coding task.

Isang karaniwang Cursor workflow: hilingin sa agent na gumawa ng mockup image batay sa disenyong binubuo mo, pagkatapos ay gamitin ito bilang reference nang direkta sa iyong IDE session — nang hindi umaalis sa editor.

Codex at Iba pang Agent

Compatible ang PixVerse CLI sa anumang agent na kayang magpatupad ng shell command at mag-parse ng JSON. Tinitiyak ng structured output format — pare-parehong field name, predictable na error code, at mga error message na hiwalay sa stderr — na kahit simpleng scripting agent ay maaasahang makakasama sa generation.

Dahil sa exit code contract, nagiging diretso ang error handling:

Code Kahulugan Aksyon ng Agent
0 Tagumpay I-parse ang JSON output
1 Pangkalahatang error Suriin ang stderr at subukang muli gamit ang validated na input
2 Timeout Subukang muli gamit ang mas mahabang --timeout
3 Nag-expire ang auth Patakbuhing muli ang pixverse auth login
4 Ubos na ang credit Suriin ang balanse, abisuhan ang user
5 Nabigo ang generation Subukan ang ibang parameter
6 Validation error Suriin ang mga value ng flag

Mga Automation Pipeline

Kapag naintindihan mo na ang bawat command, nabubuksan ng PixVerse CLI ang malalakas na multi-step workflow na tumatakbo nang buo nang walang interaksyon ng user.

Text to Image to Video

Isa sa pinakakapaki-pakinabang na pipeline: gumawa ng high-resolution na larawan mula sa text prompt, pagkatapos ay i-animate ito bilang 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" --json

Buong Video Production Pipeline

Para sa pulidong output, i-chain ang creation sa mga hakbang ng post-processing. Gamitin ang --audio o --no-audio kapag gusto mo ng native sound sa mga suportadong video creation command, pagkatapos ay gamitin ang create voice para sa text-to-speech na audio at ang create music para sa standalone na music asset na pagsasamahin mo sa downstream:

# 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 \
  --json

Batch Generation

Para sa mga content pipeline na nangangailangan ng maraming variation, patakbuhin ang mga job nang magkasabay:

# 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

Isinusumite ng flag na --no-wait ang job at agad na bumabalik kasama ang task ID, kaya maaari kang magsumite ng maraming job bago mag-poll. Gamit ang --no-wait --json, itala ang mga ibinalik na task ID at ang naresolbang creation parameter para sa logging at reproducibility. Gamitin ang --count <n> kapag gusto mo ng maraming variation mula sa isang prompt, at gamitin ang batch na task status --ids kapag gusto mo ng isang status response para sa ilang tumatakbong job. Hinahawakan ng command na pixverse task wait ang adaptive polling para sa iyo.

Pag-configure ng mga Default

Kung palagi mong ginagamit ang parehong modelo, kalidad, o aspect ratio, itakda ang mga ito bilang default para hindi mo na kailangang ulitin ang mga flag sa bawat pagkakataon:

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

Laging ino-override ng mga command-line flag ang iyong naka-configure na default, kaya nananatili ang buong flexibility habang nababawasan ang pag-uulit. Para sa workspace-specific na automation, idagdag ang --workspace-id <id> sa isang command kapag gusto mong i-override ang aktibong workspace para sa iisang run na iyon.

Ano ang Maaari Mong Buuin

Kapag naisama na ang PixVerse CLI sa iyong agent workflow, lumalawak nang malaki ang saklaw ng mga task na maaaring i-automate:

  • Dokumentasyon — awtomatikong gumawa ng product demo video at screenshot bilang bahagi ng proseso ng pagbuo ng doc
  • Marketing — magpatakbo ng nightly batch job na gumagawa ng variation ng social media content mula sa iisang prompt library
  • Pag-develop ng app — hayaan ang iyong coding agent na gumawa ng placeholder visual, mockup animation, o loading screen video habang binubuo mo ang UI
  • Mga audio workflow — gumawa ng draft ng voiceover, prompt-to-music na track, o audio asset para sa susunod na pag-edit
  • Mga content pipeline — i-chain ang mga CLI call sa ibang tool (ffmpeg, ImageMagick, cloud storage) para bumuo ng ganap na automated na media production workflow
  • Prototyping — gumawa ng mabilis na motion concept sa loob ng ilang segundo para masuri ang mga ideya bago mag-commit sa buong production

Dinisenyo ang CLI para natural na umangkop sa anumang shell-based na workflow. Kung tumatakbo ang iyong kasalukuyang automation sa bash, Python, Node, o CI/CD pipeline, diretsong nakakapasok ang PixVerse CLI nang walang karagdagang integration overhead.

Checklist sa Pagsisimula

  • I-install ang Node.js 20 o mas mataas
  • Patakbuhin ang npm install -g pixverse
  • Patakbuhin ang pixverse auth login at mag-authorize sa browser
  • Patakbuhin ang pixverse account info para ma-verify ang mga credit
  • Patakbuhin ang pixverse account slots bago ang concurrent batch work
  • Gumawa ng iyong unang larawan: pixverse create image --prompt "..." --json
  • Gumawa ng iyong unang video: pixverse create video --prompt "..." --json
  • Gumawa ng iyong unang voice asset: pixverse create voice --text "..." --json
  • Gumawa ng iyong unang music asset: pixverse create music --prompt "..." --json
  • Tuklasin ang mga template gamit ang pixverse template list
  • I-install ang PixVerse Skills para sa iyong agent (Claude Code, Cursor, o Codex)
  • I-set up ang mga gustong default gamit ang pixverse config defaults set
  • Buuin ang iyong unang automation pipeline

Panatilihing Napapanahon ang CLI

Gamitin ang built-in updater para manatiling napapanahon ang iyong lokal na CLI:

pixverse update

Maaari mo ring gamitin nang direkta ang npm:

npm install -g pixverse@latest

Dahil ang PixVerse CLI ay aktibong ina-update na tool at hindi one-time na launch, ituring ang artikulong ito bilang praktikal na field guide at ang mga opisyal na source bilang live na reference layer. Ang opisyal na pahina ng PixVerse CLI ang pinakamaikling landas sa install at agent onboarding, habang ang GitHub ang lugar para subaybayan ang mga pagbabago sa antas ng release at mga bagong suportadong modelo:

Itinatampok ng kasalukuyang docs ang PixVerse V6 bilang default na video model, ang GPT Image 2 bilang default na image model, ang suporta sa Google Gemini Omni video, ang suporta sa Nano Banana 2 Lite at Seedream 5.0 Pro image, ang suporta sa Seedance 2.0 Mini, ang mode-specific na workflow ng PixVerse v5 at v5.5, ang mga dedicated na command na create voice at create music, ang pamamahala ng audio asset, ang mga naka-save na folder, ang paglipat ng workspace, ang config defaults, ang capabilities.json para sa mga agent, ang pixverse update, ang suporta sa stdin para sa text input, ang --trace-id, at ang --idempotency-key para sa mas ligtas na retry.

Mga Susunod na Hakbang

Ang opisyal na pahina ng PixVerse CLI, ang PixVerse CLI sa GitHub, at ang npm (npm install -g pixverse) ay nagbibigay sa iyo ng agarang access sa generation, task polling, pamamahala ng asset, mga template, naka-save na folder, pagsusuri ng account, pagtuklas ng audio model, at kontrol sa workspace mula sa iisang interface. Nagdaragdag ang PixVerse Skills repository ng gabay na handa para sa agent para mas maaasahang mapatakbo ng Claude Code, Cursor, Codex, at iba pang tool ang mga workflow na ito.

Ang pagsasama ng maaasahang CLI at skill library na handa para sa agent ay nangangahulugang ang generation ng larawan, video, boses, at musika ay maaaring manatili sa parehong workflow ng iyong code — pinamamahalaan ng parehong agent, sa parehong terminal, nang hindi lumilipat ng tool.

Magsimula sa iisang command. Buuin mula roon.

Mga Kaugnay na Resource

Gumawa ng mga video, larawan, boses, at musika mula sa iyong terminal gamit ang PixVerse.