Tutorial

PixVerse CLI: Jana Video dan Imej AI dalam Terminal

Dikemas kini kali terakhir pada
PixVerse CLI: Jana Video dan Imej AI dalam Terminal

Pengenalan

Setiap aliran kerja kreatif ada kesesakan — saat anda terpaksa meninggalkan editor kod, membuka pelayar, dan mengklik secara manual melalui antara muka web untuk menjana sekeping media. Bagi pembangun, ejen AI, dan sesiapa yang membina saluran paip kandungan automatik, pertukaran konteks itu ialah geseran yang cepat bertambah.

PixVerse CLI menghapuskan kesesakan itu. Ia ialah antara muka baris perintah rasmi untuk PixVerse, memberi anda akses kepada penjanaan PixVerse dan aliran kerja ruang kerja terus dari terminal anda. Teks-ke-video, imej-ke-video, teks-ke-imej, imej-ke-imej, peralihan, penjanaan suara, penjanaan muzik, video rujukan, kawalan gerakan, templat, peningkatan resolusi, dan pengurusan aset semuanya boleh diskrip, boleh disalurkan, dan tersedia tanpa menyentuh pelayar. Untuk laluan pemasangan paling singkat dan gambaran keseluruhan persediaan ejen, mulakan dari halaman rasmi PixVerse CLI.

Yang menjadikan PixVerse CLI sangat berguna ialah falsafah reka bentuknya: ia dibina dengan ejen AI dalam fikiran. Perintah boleh mengembalikan JSON berstruktur dengan --json atau -p, kod keluar adalah deterministik, dan setiap langkah saluran paip boleh digubah. Ini bermakna anda boleh mengajar Claude Code, Cursor, Codex, atau mana-mana ejen lain untuk menjana imej, video, suara, dan muzik bagi pihak anda dengan kurang serahan yang rapuh.

Panduan ini selaras dengan README GitHub PixVerseAI/cli semasa, manifes keupayaan awamnya, dan halaman produk PixVerse CLI, disemak pada 13 Julai 2026. PixVerse CLI dikemas kini secara berterusan melalui repositori GitHub, jadi skrip produksi masih harus mengesahkan pixverse --version, pixverse create <mode> --help, dan pixverse update sebelum larian kelompok yang besar.

Prasyarat

Sebelum bermula, anda perlukan:

  • Node.js 20 atau lebih tinggi — semak dengan node --version
  • Akaun PixVerse — daftar di pixverse.ai
  • Langganan PixVerse yang aktif — CLI menggunakan sistem kredit yang sama seperti laman web; hanya pengguna berlangganan boleh menjana kandungan

PixVerse CLI tidak memerlukan sebarang kunci API disalin secara manual. Pengesahan dikendalikan melalui aliran OAuth berasaskan pelayar yang menyimpan token anda secara tempatan.

Langkah 1: Pasang CLI

Pasang secara global dengan npm:

npm install -g pixverse

Sahkan pemasangan:

pixverse --version

Jika anda lebih suka tidak memasang secara global, anda juga boleh menjalankan perintah melalui npx:

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

Langkah 2: Sahkan Identiti

Jalankan perintah log masuk:

pixverse auth login

CLI membuka pelayar untuk kebenaran peranti OAuth. Anda juga boleh menyalin URL dan menyelesaikan kebenaran daripada mana-mana pelayar pada mana-mana peranti, yang berguna untuk persekitaran SSH dan tanpa kepala. Token anda disimpan secara automatik dalam ~/.pixverse/ dan sah selama 30 hari.

Untuk mengesahkan anda telah log masuk dan menyemak kredit tersedia:

pixverse auth status
pixverse account info
pixverse account slots

Perintah account info menunjukkan peringkat langganan, kredit ruang kerja, dan konteks penggunaan anda. pixverse account usage membantu anda menyemak penggunaan kredit, manakala pixverse account slots menunjukkan slot penjanaan serentak semasa untuk kerja imej dan video. Sesi CLI bebas daripada sesi web/aplikasi PixVerse, dan anda boleh membuang token CLI yang disimpan dengan pixverse auth logout. Sentiasa semak baki dan slot tersedia sebelum menjalankan kerja kelompok.

Perintah Permulaan Pantas

Jika anda hanya perlukan laluan paling singkat daripada pemasangan ke aset yang dijana, mulakan dengan urutan ini:

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

Untuk aliran kerja ejen dan CI, kekalkan --json atau -p didayakan supaya stdout kekal boleh dibaca mesin manakala kemajuan dan ralat kekal pada stderr. Untuk percubaan semula produksi, tambah --idempotency-key <key> pada perintah penciptaan supaya penyerahan berulang tidak secara tidak sengaja mencipta kerja bercaj pendua.

Langkah 3: Jana Imej Pertama Anda

Penjanaan teks-ke-imej ialah cara paling pantas untuk menguji persediaan anda. Jalankan:

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

README GitHub semasa menyenaraikan GPT Image 2 sebagai model imej lalai. Untuk automasi yang boleh diulang, tetap tetapkan --model secara eksplisit dan semak bantuan CLI langsung atau capabilities.json sebelum kerja kelompok. Bendera --json mengembalikan output berstruktur:

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

Untuk output beresolusi lebih tinggi, nyatakan model yang menyokongnya:

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

PixVerse menyokong beberapa model imej, masing-masing dengan siling resolusi dan sokongan nisbah aspek yang berbeza:

Model Nilai --model Kualiti Nota
GPT Image 2 gpt-image-2.0 1080p, 1440p, 2160p Model imej lalai; menyokong nisbah aspek lebar dan tinggi
Nano Banana 2 gemini-3.1-flash 512p, 1080p, 1440p, 2160p auto yang fleksibel dan nisbah aspek standard
Nano Banana 2 Lite gemini-3.1-flash-lite 1080p Pilihan Nano Banana 2 yang ringan untuk aliran kerja imej yang pantas
Qwen Image qwen-image 720p, 1080p Penjanaan pantas untuk tugas kreatif biasa
Nano Banana Pro gemini-3.0 1080p, 1440p, 2160p Penciptaan imej berkualiti tinggi pada saiz yang lebih besar
Nano Banana gemini-2.5-flash 1080p Penjanaan imej ringan dengan masa siap yang pantas
Seedream 5.0 Pro seedream-5.0-pro 1080p, 1440p Menyokong nisbah aspek standard dan aliran kerja imej berbilang rujukan
Seedream 5.0 Lite seedream-5.0-lite 1440p, 1800p, 2160p Imej kreatif berbutiran tinggi
Seedream 4.5 seedream-4.5 1440p, 2160p Penjanaan imej beresolusi tinggi
Seedream 4.0 seedream-4.0 1080p, 1440p, 2160p Pilihan Seedream tambahan untuk aliran kerja imej
Kling Image O3 kling-image-o3 1080p, 1440p, 2160p Output visual bergaya dengan pembingkaian yang fleksibel
Kling Image V3 kling-image-v3 1080p, 1440p Kualiti dan kelajuan yang seimbang

Anda juga boleh mengubah imej sedia ada dengan imej-ke-imej:

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

Untuk memuat turun imej yang dijana:

pixverse asset download 789012

Langkah 4: Jana Video Pertama Anda

Teks-ke-video berfungsi dengan cara yang sama. Jana klip 5 saat:

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

Untuk penjanaan yang disesuaikan sepenuhnya:

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

Bendera --audio mendayakan bunyi ambien yang dijana AI yang sepadan dengan kandungan video anda. Bendera --json mengembalikan video_url apabila selesai yang boleh anda hantar terus ke perintah muat turun atau langkah seterusnya dalam saluran paip.

PixVerse menyediakan pelbagai model video dengan sokongan kualiti, tempoh, dan mod yang berbeza:

Model Nilai --model Kualiti Maks. Tempoh Nota
PixVerse V6 v6 1080p 1–15 saat Model video lalai; sokongan nisbah aspek yang luas
PixVerse C1 pixverse-c1 1080p 1–15 saat Sokongan kukuh merentas aliran kerja video, rujukan, dan peralihan
Seedance 2.0 Standard seedance-2.0-standard 2160p 4–15 saat Menyokong mod video, rujukan, dan peralihan
Seedance 2.0 Fast seedance-2.0-fast 720p 4–15 saat Pilihan Seedance yang lebih pantas untuk mod video, rujukan, dan peralihan
Seedance 2.0 Mini seedance-2.0-mini 720p 4–15 saat Pilihan Seedance yang ringan untuk mod video, rujukan, dan peralihan
Google Gemini Omni gemini-omni-flash 720p 3–10 saat Menyokong aliran kerja video dan rujukan dalam 16:9 atau 9:16
Happy Horse 1.0 happyhorse-1.0 1080p 3–15 saat Pilihan video sedar audio tersedia untuk create video
Kling O3 Pro kling-o3-pro 720p 3–15 saat Menyokong aliran kerja video, rujukan, dan peralihan
Kling O3 Standard kling-o3-standard 720p 3–15 saat Pilihan Kling O3 standard
Kling 3.0 Pro kling-3.0-pro 720p 3–15 saat Menyokong aliran kerja video dan peralihan
Kling 3.0 Standard kling-3.0-standard 720p 3–15 saat Pilihan Kling 3.0 standard
Grok Imagine 1.5 grok-imagine-1.5 720p 1–15 saat Imej-ke-video sahaja; memerlukan --image dan mengikut nisbah aspek imej input
Grok Imagine grok-imagine 720p 1–15 saat Pilihan Grok yang lebih awal; menyokong aliran kerja video, lanjutan, dan rujukan
Veo 3.1 Lite veo-3.1-lite 1080p 4, 6, atau 8 saat Menyokong aliran kerja video dan peralihan 2 bingkai
Veo 3.1 Standard veo-3.1-standard 2160p 4, 6, atau 8 saat Pilihan Veo beresolusi lebih tinggi
Veo 3.1 Fast veo-3.1-fast 2160p 4, 6, atau 8 saat Pilihan Veo yang lebih pantas
Sora 2 Pro sora-2-pro 1080p 4, 8, atau 12 saat Pilihan Sora tempoh tetap
Sora 2 sora-2 720p 4, 8, atau 12 saat Pilihan Sora standard
PixVerse v5.6 v5.6 1080p 1–10 saat Masih digunakan untuk kawalan gerakan dan aliran kerja penjanaan terpilih
PixVerse v5.5 v5.5 1080p 1–10 saat Digunakan untuk aliran kerja create modify
PixVerse v5 v5 1080p 1–10 saat Digunakan untuk aliran kerja peralihan 3+ bingkai

Model rakan kongsi seperti Seedance, Kling, Veo, Sora, Gemini Omni, Grok Imagine, dan HappyHorse ialah pilihan pada PixVerse. Gunakan permukaan CLI yang sama untuk membandingkannya dengan PixVerse V6 dan C1.

Animasikan Imej Statik

Untuk menukar foto atau imej yang dijana menjadi video, berikan bendera --image:

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

Anda boleh menghantar laluan fail tempatan atau URL. Fail tempatan dimuat naik secara automatik — tiada langkah muat naik manual diperlukan. Input imej tempatan yang lebih besar daripada 1920x1920 atau 5MB disaiz semula atau dimampatkan secara automatik sebelum muat naik; URL imej jauh disahkan oleh bahagian belakang sebagaimana adanya.

Untuk Grok Imagine 1.5, imej diperlukan dan nisbah aspek output mengikut imej itu:

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

Gunakan Rujukan, Peralihan, Kawalan Gerakan, dan Templat

CLI semasa menyokong lebih daripada teks-ke-video dan imej-ke-video yang mudah. Mod penciptaan ini berguna apabila anda perlukan lebih kawalan ke atas watak, bingkai kekunci, suntingan, atau kesan:

# 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

Bukan setiap model menyokong setiap mod penciptaan. Dalam matriks README semasa, create video menyokong 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, dan v5.6. grok-imagine-1.5 ialah imej-ke-video sahaja dan memerlukan --image; create extend menyokong v6 dan grok-imagine; create reference menyokong v6, pixverse-c1, Seedance 2.0 Standard/Fast/Mini, Google Gemini Omni, Kling O3, grok-imagine, dan v5.6; peralihan 2 bingkai menyokong keluarga video yang lebih baharu; peralihan 3+ bingkai menggunakan v5; create modify menggunakan v5.5; dan create motion-control menggunakan v5.6.

Langkah 5: Jana Suara dan Muzik

README GitHub semasa mendokumentasikan audio kendiri melalui perintah penciptaan khusus. Gunakan create voice untuk teks-ke-pertuturan dan create music untuk penjanaan promp-ke-muzik. Output suara dan muzik disimpan sebagai aset audio, jadi anda boleh menjejaknya dengan task, menyenaraikannya dengan asset list --type audio, dan memuat turunnya dengan asset download --type audio. Untuk suasana video asli, gunakan --audio atau --no-audio pada perintah penciptaan video yang disokong.

Jana audio suara:

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

Layari model suara dan suara pratetap:

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

Jana muzik:

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

Untuk trek instrumental, gunakan --instrumental. Untuk model yang menyokong lirik, hantar lirik sebagai teks literal, laluan fail tempatan, atau stdin:

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

Keluarga model suara semasa termasuk MiniMax Speech 2.8 dan model ElevenLabs. Keluarga model muzik semasa termasuk MiniMax Music, ElevenLabs Music, dan Google Lyria 3 Pro. Gunakan pixverse voice models dan pixverse music models untuk katalog langsung sebelum menulis skrip aliran kerja produksi.

Langkah 6: Jalankan Wizard Interaktif

Jika anda meneroka buat kali pertama dan belum biasa dengan semua bendera yang tersedia, jalankan mana-mana arahan penciptaan tanpa argumen untuk memasuki wizard berpandu:

pixverse create video
pixverse create image

Wizard ini membimbing anda melalui prompt, pemilihan model, kualiti, nisbah aspek, tempoh, dan pilihan lain langkah demi langkah — berguna untuk mengetahui parameter yang tersedia sebelum anda menulis skrip untuknya.

Melangkaui Penjanaan: Urus Aset dan Ruang Kerja Anda

PixVerse CLI semasa juga menyertakan arahan pengurusan yang membantu anda membina aliran kerja terminal hujung ke hujung:

  • pixverse task status <id> dan pixverse task wait <id> untuk peninjauan tugas
  • pixverse task status --ids 123,456,789 --type video --json untuk semakan status kelompok
  • pixverse asset list, asset upload, asset info, asset download, dan asset delete untuk operasi kitaran hayat aset video, imej, dan audio
  • pixverse saved list, saved items, saved new, saved rename, saved add, saved remove, dan saved delete untuk folder yang disimpan
  • pixverse template categories, template list, template search, dan template info untuk menemui kesan dan templat
  • pixverse voice models, voice presets, dan music models untuk penemuan model audio langsung
  • pixverse workspace list, workspace status, workspace switch, dan workspace manage untuk operasi berbilang ruang kerja
  • pixverse account info, account usage, dan account slots untuk semakan kredit, penggunaan, dan serentakan
  • pixverse config set, config list, config path, dan config defaults untuk lalai tempatan yang boleh diulang

Ini memudahkan anda mengautomasikan bukan sahaja penciptaan, tetapi juga penyusunan, penemuan templat, penemuan audio, muat turun, penghalaan ruang kerja, dan penghantaran dalam satu skrip. Jika anda perlu menjalankan satu arahan terhadap ruang kerja yang berbeza, gunakan bendera global --workspace-id <id>; 0 menyasarkan ruang kerja peribadi anda.

Bendera Mesra Skrip

Kebanyakan automasi bergantung pada output yang boleh diramal dan tingkah laku masa jalan yang boleh diramal. Bendera ini amat berguna dalam skrip dan aliran kerja ejen AI:

Bendera Gunakannya Untuk
--json Kembalikan output JSON berstruktur
-p Alias pendek untuk --json
--count <n> Jana 1–4 variasi daripada satu permintaan
--seed <number> Jadikan penjanaan lebih mudah dihasilkan semula
--off-peak Gunakan harga luar waktu puncak apabila tersedia
--audio / --no-audio Dayakan atau lumpuhkan penjanaan audio pada arahan penciptaan yang disokong
--multi-shot / --no-multi-shot Dayakan atau lumpuhkan mod berbilang syot untuk video
--no-wait Hantar kerja dan kembali serta-merta
--timeout <sec> Tetapkan tamat masa peninjauan, lalai kepada 300 saat
--workspace-id <id> Ganti ruang kerja aktif untuk satu arahan
--trace-id <uuid> Lampirkan UUIDv4 yang dibekalkan pemanggil pada permintaan API untuk penyahpepijatan dan kebolehcerapan
--idempotency-key <key> Cuba semula permintaan penciptaan dengan selamat tanpa secara tidak sengaja mencipta kerja bercas pendua

Bendera input teks kini lebih mudah diautomasikan. --prompt, --text, dan --lyrics boleh menerima rentetan literal, laluan fail tempatan, atau - untuk 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

Mengajar Ejen AI Anda Menjana Media

Bagi pasukan yang lebih suka titik permulaan berpandu berasaskan aplikasi sebelum beralih kepada automasi baris arahan, PixVerse Agent menyediakan aliran kerja penciptaan berorientasikan ejen dalam aplikasi PixVerse.

Di sinilah PixVerse CLI benar-benar transformatif. Oleh kerana arahan boleh mengembalikan JSON berstruktur dan menggunakan kod keluar yang deterministik, mana-mana ejen AI yang boleh menjalankan arahan shell boleh diajar untuk menjana imej dan video atas permintaan.

Memasang PixVerse Skills

PixVerse Skills ialah pustaka kemahiran berstruktur yang mengajar ejen cara menggunakan CLI dengan betul: bendera arahan, kekangan model, saluran paip berbilang langkah, dan pengendalian ralat yang teguh.

Untuk Claude Code dan ejen lain yang menyokong format kemahiran, tambah kemahiran PixVerse secara terus:

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

Untuk Cursor, Claude Code, Codex, dan rangka kerja ejen lain, kemahiran ini meningkatkan kebolehpercayaan dengan memberikan ejen kekangan yang jelas dan bukannya memaksanya menyimpulkannya dari awal.

PixVerse CLI juga disertakan dengan manifes arahan padat yang boleh dibaca mesin di dist/capabilities.json, dengan sumber awam tersedia sebagai capabilities.json dalam repositori GitHub. Manifes ini menerangkan arahan, bendera, kod keluar, jangkaan output JSON, dan kategori kesan, supaya ejen boleh memeriksa kontrak CLI tanpa mengikis teks bantuan.

Setelah ejen anda memuatkan kemahiran PixVerse, anda boleh memberinya arahan bahasa semula jadi seperti:

  • “Jana video demo produk 10 saat daripada tangkapan skrin ini”
  • “Cipta empat variasi imej kulit blog ini dalam format 16:9”
  • “Animasikan rajah ini menjadi klip penerang 5 saat dengan bunyi ambien”
  • “Jana tiga klip promo 8 saat 16:9 dengan gerakan kamera yang berbeza”

Ejen akan menterjemah arahan itu kepada arahan CLI yang betul, menghuraikan output JSON, serta mengendalikan peninjauan dan muat turun — tanpa campur tangan manual.

Claude Code

Dalam Claude Code, PixVerse CLI menjadi alat asli yang digunakan ejen secara autonomi. Selepas memuatkan kemahiran PixVerse, anda boleh menyertakan penjanaan media secara terus dalam mana-mana tugas:

Jana imej kulit untuk catatan blog tentang pembelajaran mesin ini, gunakan model seedream-5.0-lite pada 2160p dalam format 16:9, muat turun ke ./assets/cover.webp

Claude Code akan memanggil arahan CLI yang betul, menghuraikan URL imej daripada respons JSON, dan memuat turun fail ke laluan yang anda tentukan — semuanya dalam sesi yang sama di mana ia juga menulis kod anda.

Aliran kerja Claude Code yang tipikal:

# 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

Pengguna Cursor boleh memuatkan PixVerse Skills sebagai fail konteks projek. Letakkan fail kemahiran yang berkaitan dalam direktori .cursor/ anda atau tambahkannya pada peraturan ruang kerja anda. Setelah dimuatkan, Cursor mempunyai kesedaran penuh tentang setiap arahan PixVerse CLI dan boleh menjana media sebagai sebahagian daripada mana-mana tugas pengekodan.

Aliran kerja Cursor yang biasa: minta ejen menjana imej mockup berdasarkan reka bentuk yang sedang anda bina, kemudian gunakannya sebagai rujukan terus dalam sesi IDE anda — tanpa meninggalkan editor.

Codex dan Ejen Lain

PixVerse CLI serasi dengan mana-mana ejen yang boleh melaksanakan arahan shell dan menghuraikan JSON. Format output berstruktur — nama medan yang konsisten, kod ralat yang boleh diramal, dan mesej ralat yang dipisahkan pada stderr — memastikan walaupun ejen penskripan yang ringkas boleh menyepadukan penjanaan dengan andal.

Kontrak kod keluar menjadikan pengendalian ralat mudah:

Kod Maksud Tindakan Ejen
0 Berjaya Huraikan output JSON
1 Ralat umum Semak stderr dan cuba semula dengan input yang disahkan
2 Tamat masa Cuba semula dengan --timeout yang lebih lama
3 Pengesahan tamat tempoh Jalankan semula pixverse auth login
4 Kredit habis Semak baki, maklumkan pengguna
5 Penjanaan gagal Cuba parameter yang berbeza
6 Ralat pengesahan Semak nilai bendera

Saluran Paip Automasi

Setelah anda memahami arahan individu, PixVerse CLI membuka aliran kerja berbilang langkah yang berkuasa yang berjalan sepenuhnya tanpa interaksi pengguna.

Teks ke Imej ke Video

Salah satu saluran paip yang paling berguna: jana imej resolusi tinggi daripada prompt teks, kemudian animasikannya menjadi 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

Saluran Paip Produksi Video Penuh

Untuk output yang digilap, rantaikan penciptaan dengan langkah pasca-pemprosesan. Gunakan --audio atau --no-audio apabila anda mahukan bunyi asli pada arahan penciptaan video yang disokong, kemudian gunakan create voice untuk audio teks-ke-pertuturan dan create music untuk aset muzik kendiri yang akan anda gabungkan di hiliran:

# 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

Penjanaan Kelompok

Untuk saluran paip kandungan yang memerlukan berbilang variasi, jalankan kerja secara selari:

# 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

Bendera --no-wait menghantar kerja dan kembali serta-merta dengan ID tugas, membolehkan anda menghantar berbilang kerja sebelum meninjau. Dengan --no-wait --json, rekodkan ID tugas yang dikembalikan dan parameter penciptaan yang diselesaikan untuk pengelogan dan kebolehulangan. Gunakan --count <n> apabila anda mahukan berbilang variasi daripada satu prompt, dan gunakan kelompok task status --ids apabila anda mahukan satu respons status untuk beberapa kerja yang sedang berjalan. Arahan pixverse task wait mengendalikan peninjauan adaptif untuk anda.

Mengkonfigurasi Lalai

Jika anda sentiasa menggunakan model, kualiti, atau nisbah aspek yang sama, tetapkan sebagai lalai supaya anda tidak perlu mengulang bendera setiap kali:

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

Bendera baris arahan sentiasa mengatasi lalai yang dikonfigurasi, jadi anda mengekalkan fleksibiliti penuh sambil mengurangkan pengulangan. Untuk automasi khusus ruang kerja, tambah --workspace-id <id> pada arahan apabila anda mahu mengganti ruang kerja aktif untuk larian tunggal itu.

Apa yang Boleh Anda Bina

Dengan PixVerse CLI disepadukan ke dalam aliran kerja ejen anda, julat tugas yang boleh diautomasikan berkembang dengan ketara:

  • Dokumentasi — jana secara automatik video demo produk dan tangkapan skrin sebagai sebahagian daripada proses binaan dokumen anda
  • Pemasaran — jalankan kerja kelompok malam yang menghasilkan variasi kandungan media sosial daripada satu pustaka prompt
  • Pembangunan aplikasi — biarkan ejen pengekodan anda menjana visual pemegang tempat, animasi mockup, atau video skrin pemuatan semasa anda membina UI
  • Aliran kerja audio — jana draf suara latar, trek prompt-ke-muzik, atau aset audio untuk suntingan kemudian
  • Saluran paip kandungan — rantaikan panggilan CLI dengan alat lain (ffmpeg, ImageMagick, storan awan) untuk membina aliran kerja produksi media yang automatik sepenuhnya
  • Prototaip — jana konsep gerakan pantas dalam beberapa saat untuk mengesahkan idea sebelum komited kepada produksi penuh

CLI direka untuk sesuai secara semula jadi ke dalam mana-mana aliran kerja berasaskan shell. Jika automasi sedia ada anda berjalan dalam bash, Python, Node, atau saluran paip CI/CD, PixVerse CLI masuk tanpa sebarang overhed penyepaduan tambahan.

Senarai Semak Permulaan

  • Pasang Node.js 20 atau lebih tinggi
  • Jalankan npm install -g pixverse
  • Jalankan pixverse auth login dan benarkan dalam pelayar
  • Jalankan pixverse account info untuk mengesahkan kredit
  • Jalankan pixverse account slots sebelum kerja kelompok serentak
  • Jana imej pertama anda: pixverse create image --prompt "..." --json
  • Jana video pertama anda: pixverse create video --prompt "..." --json
  • Jana aset suara pertama anda: pixverse create voice --text "..." --json
  • Jana aset muzik pertama anda: pixverse create music --prompt "..." --json
  • Terokai templat dengan pixverse template list
  • Pasang PixVerse Skills untuk ejen anda (Claude Code, Cursor, atau Codex)
  • Sediakan lalai pilihan anda dengan pixverse config defaults set
  • Bina saluran paip automasi pertama anda

Mengekalkan CLI Terkini

Gunakan pengemas kini terbina dalam untuk memastikan CLI tempatan anda sentiasa terkini:

pixverse update

Anda juga boleh menggunakan npm secara terus:

npm install -g pixverse@latest

Oleh kerana PixVerse CLI ialah alat yang dikemas kini secara aktif dan bukannya pelancaran sekali sahaja, anggap artikel ini sebagai panduan lapangan praktikal dan sumber rasmi sebagai lapisan rujukan langsung. Halaman rasmi PixVerse CLI ialah laluan pemasangan dan onboarding ejen yang paling ringkas, manakala GitHub kekal tempat untuk menjejaki perubahan peringkat keluaran dan model yang baru disokong:

Dokumen semasa menonjolkan PixVerse V6 sebagai model video lalai, GPT Image 2 sebagai model imej lalai, sokongan video Google Gemini Omni, sokongan imej Nano Banana 2 Lite dan Seedream 5.0 Pro, sokongan Seedance 2.0 Mini, aliran kerja PixVerse v5 dan v5.5 khusus mod, arahan khusus create voice dan create music, pengurusan aset audio, folder yang disimpan, penukaran ruang kerja, config defaults, capabilities.json untuk ejen, pixverse update, sokongan stdin untuk input teks, --trace-id, dan --idempotency-key untuk cubaan semula yang lebih selamat.

Langkah Seterusnya

Halaman rasmi PixVerse CLI, PixVerse CLI di GitHub, dan npm (npm install -g pixverse) memberi anda akses segera kepada penjanaan, peninjauan tugas, pengurusan aset, templat, folder yang disimpan, semakan akaun, penemuan model audio, dan kawalan ruang kerja daripada satu antara muka. Repositori PixVerse Skills menambah panduan sedia ejen supaya Claude Code, Cursor, Codex, dan alat lain boleh menjalankan aliran kerja ini dengan kebolehpercayaan yang lebih kukuh.

Gabungan CLI yang andal dan pustaka kemahiran sedia ejen bermakna penjanaan imej, video, suara, dan muzik boleh hidup dalam aliran kerja yang sama dengan kod anda — diurus oleh ejen yang sama, dalam terminal yang sama, tanpa menukar alat.

Mulakan dengan satu arahan. Bina dari situ.

Sumber Berkaitan

Jana video, imej, suara, dan muzik daripada terminal anda dengan PixVerse.