PixVerse CLI: buat video dan gambar AI di terminal

Pendahuluan

Setiap alur kerja kreatif memiliki hambatan — saat Anda harus meninggalkan editor kode, membuka browser, dan mengklik antarmuka web secara manual untuk menghasilkan suatu media. Bagi pengembang, agen AI, dan siapa pun yang membangun saluran konten otomatis, peralihan konteks tersebut merupakan gesekan yang bertambah dengan cepat.

PixVerse CLImenghilangkan hambatan tersebut. Ini adalah antarmuka baris perintah resmi untuk PixVerse, memberi Anda akses ke generasi PixVerse dan alur kerja ruang kerja langsung dari terminal Anda. Teks-ke-video, gambar-ke-video, teks-ke-gambar, gambar-ke-gambar, transisi, pembuatan suara, pembuatan musik, video referensi, kontrol gerakan, templat, peningkatan skala, dan manajemen aset semuanya dapat dituliskan, dapat disalurkan, dan tersedia tanpa menyentuh browser. Untuk jalur instalasi paling singkat dan gambaran umum penyiapan agen, mulai dari halaman resmi PixVerse CLI.

Apa yang membuat PixVerse CLI sangat berguna adalah filosofi desainnya: PixVerse CLI dibuat dengan mempertimbangkan agen AI. Perintah dapat mengembalikan JSON terstruktur dengan --json atau -p, kode keluar bersifat deterministik, dan setiap langkah pipeline dapat disusun. Ini berarti Anda dapat mengajari Claude Code, Cursor, Codex, atau agen lainnya untuk menghasilkan gambar, video, suara, dan musik atas nama Anda dengan lebih sedikit proses yang rumit.

Panduan ini selaras dengan PixVerseAI/cli GitHub README saat ini, manifes kemampuan publiknya, dan halaman produk PixVerse CLI, yang diperiksa pada 13 Juli 2026. PixVerse CLI terus diperbarui melalui repositori GitHub, sehingga skrip produksi tetap harus memverifikasi pixverse --version, pixverse create <mode> --help, dan pixverse update sebelum batch besar dijalankan.

Prasyarat

Sebelum memulai, Anda memerlukan:

Node.js 20 atau lebih tinggi— periksa dengan node --version
Akun PixVerse— daftar di pixverse.ai
Langganan PixVerse aktif— CLI menggunakan sistem kredit yang sama dengan situs web; hanya pengguna berlangganan yang dapat menghasilkan konten

PixVerse CLI tidak memerlukan kunci API apa pun untuk disalin secara manual. Otentikasi ditangani melalui aliran OAuth berbasis browser yang menyimpan token Anda secara lokal.

Langkah 1: Instal CLI

Instal secara global dengan npm:

npm install -g pixverse

Verifikasi instalasi:

pixverse --version

Jika Anda memilih untuk tidak menginstal secara global, Anda juga dapat menjalankan perintah melalui npx:

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

Langkah 2: Otentikasi

Jalankan perintah masuk:

pixverse auth login

CLI membuka browser untuk otorisasi perangkat OAuth. Anda juga dapat menyalin URL dan menyelesaikan otorisasi dari browser apa pun di perangkat apa pun, yang berguna untuk lingkungan SSH dan tanpa kepala. Token Anda disimpan secara otomatis di ~/.pixverse/ dan berlaku selama 30 hari.

Untuk memverifikasi bahwa Anda masuk dan memeriksa kredit yang tersedia:

pixverse auth status pixverse account info pixverse account slots

Perintah account info menunjukkan tingkat langganan, kredit ruang kerja, dan konteks penggunaan Anda. pixverse account usage membantu Anda meninjau konsumsi kredit, sementara pixverse account slots menunjukkan slot generasi bersamaan saat ini untuk pekerjaan gambar dan video. Sesi CLI tidak bergantung pada sesi web/aplikasi PixVerse, dan Anda dapat menghapus token CLI yang disimpan dengan pixverse auth logout. Selalu periksa saldo Anda dan slot yang tersedia sebelum menjalankan pekerjaan batch.

Perintah Mulai Cepat

Jika Anda hanya memerlukan jalur terpendek dari instalasi ke aset yang dihasilkan, mulailah 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 alur kerja agen dan CI, tetap aktifkan --json atau -p sehingga stdout tetap dapat dibaca mesin sementara kemajuan dan kesalahan tetap ada di stderr. Untuk percobaan ulang produksi, tambahkan --idempotency-key <key> ke perintah pembuatan sehingga pengiriman berulang tidak secara tidak sengaja membuat tugas duplikat yang dikenakan biaya.

Langkah 3: Hasilkan Gambar Pertama Anda

Pembuatan teks-ke-gambar adalah cara tercepat untuk menguji penyiapan Anda. Jalankan:

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

GitHub README saat ini mencantumkan GPT Image 2 sebagai model gambar default. Untuk otomatisasi yang dapat direproduksi, tetap atur --model secara eksplisit dan periksa bantuan CLI langsung atau capabilities.json sebelum pekerjaan batch. Bendera --json mengembalikan keluaran terstruktur:

{ "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 keluaran resolusi lebih tinggi, tentukan model yang mendukungnya:

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

PixVerse mendukung beberapa model gambar, masing-masing dengan batas resolusi dan dukungan rasio aspek yang berbeda:

Model	`--model` value	Kualitas	Catatan
GPT Image 2	`gpt-image-2.0`	1080p, 1440p, 2160p	Model gambar bawaan; mendukung rasio aspek lebar dan tinggi
Nano Banana 2	`gemini-3.1-flash`	512p, 1080p, 1440p, 2160p	`auto` fleksibel dan rasio aspek standar
Nano Banana 2 Lite	`gemini-3.1-flash-lite`	1080p	Opsi Nano Banana 2 ringan untuk alur kerja gambar cepat
Qwen Image	`qwen-image`	720p, 1080p	Generasi cepat untuk tugas kreatif umum
Nano Banana Pro	`gemini-3.0`	1080p, 1440p, 2160p	Pembuatan gambar berkualitas tinggi pada ukuran lebih besar
Nano Banana	`gemini-2.5-flash`	1080p	Pembuatan gambar ringan dengan perputaran cepat
Seedream 5.0 Pro	`seedream-5.0-pro`	1080p, 1440p	Mendukung rasio aspek standar dan alur kerja multi-gambar referensi
Seedream 5.0 Lite	`seedream-5.0-lite`	1440p, 1800p, 2160p	Gambar kreatif dengan detail tinggi
Seedream 4.5	`seedream-4.5`	1440p, 2160p	Pembuatan gambar resolusi tinggi
Seedream 4.0	`seedream-4.0`	1080p, 1440p, 2160p	Opsi Seedream tambahan untuk alur kerja gambar
Kling Image O3	`kling-image-o3`	1080p, 1440p, 2160p	Output visual bergaya dengan pembingkaian fleksibel
Kling Image V3	`kling-image-v3`	1080p, 1440p	Kualitas dan kecepatan seimbang

Anda juga dapat mengubah gambar yang ada dengan gambar-ke-gambar:

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

Untuk mengunduh gambar yang dihasilkan:

pixverse asset download 789012

Langkah 4: Hasilkan Video Pertama Anda

Teks-ke-video bekerja dengan cara yang sama. Hasilkan klip 5 detik:

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

Untuk generasi yang sepenuhnya disesuaikan:

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 mengaktifkan suara sekitar yang dihasilkan AI yang cocok dengan konten video Anda. Bendera --json mengembalikan video_url setelah selesai yang dapat Anda teruskan langsung ke perintah unduh atau langkah berikutnya dalam alur.

PixVerse menyediakan beberapa model video dengan kualitas, durasi, dan dukungan mode berbeda:

Model	`--model` value	Kualitas Maks	Durasi	Catatan
PixVerse V6	`v6`	1080p	1–15 detik	Model video bawaan; dukungan rasio aspek yang luas
PixVerse C1	`pixverse-c1`	1080p	1–15 detik	Dukungan kuat di seluruh alur kerja video, referensi, dan transisi
Seedance 2.0 Standard	`seedance-2.0-standard`	2160p	4–15 detik	Mendukung mode video, referensi, dan transisi
Seedance 2.0 Fast	`seedance-2.0-fast`	720p	4–15 detik	Opsi Seedance Lebih Cepat untuk mode video, referensi, dan transisi
Seedance 2.0 Mini	`seedance-2.0-mini`	720p	4–15 detik	Opsi Seedance Ringan untuk mode video, referensi, dan transisi
Google Gemini Omni	`gemini-omni-flash`	720p	3–10 detik	Mendukung alur kerja video dan referensi dalam 16:9 atau 9:16
Happy Horse 1.0	`happyhorse-1.0`	1080p	3–15 detik	Opsi video sadar audio tersedia untuk `create video`
Kling O3 Pro	`kling-o3-pro`	720p	3–15 detik	Mendukung alur kerja video, referensi, dan transisi
Kling O3 Standard	`kling-o3-standard`	720p	3–15 detik	Opsi Kling O3 standar
Kling 3.0 Pro	`kling-3.0-pro`	720p	3–15 detik	Mendukung alur kerja video dan transisi
Kling 3.0 Standard	`kling-3.0-standard`	720p	3–15 detik	Opsi standar Kling 3.0
Grok Imagine 1.5	`grok-imagine-1.5`	720p	1–15 detik	Hanya gambar-ke-video; membutuhkan `--image` dan mengikuti rasio aspek gambar masukan
Grok Imagine	`grok-imagine`	720p	1–15 detik	Opsi Grok sebelumnya; mendukung alur kerja video, perluasan, dan referensi
Veo 3.1 Lite	`veo-3.1-lite`	1080p	4, 6, atau 8 detik	Mendukung alur kerja transisi video dan 2 bingkai
Veo 3.1 Standard	`veo-3.1-standard`	2160p	4, 6, atau 8 detik	Opsi Veo resolusi lebih tinggi
Veo 3.1 Fast	`veo-3.1-fast`	2160p	4, 6, atau 8 detik	Opsi Veo lebih cepat
Sora 2 Pro	`sora-2-pro`	1080p	4, 8, atau 12 detik	Opsi Sora dengan durasi tetap
Sora 2	`sora-2`	720p	4, 8, atau 12 detik	Opsi Sora standar
PixVerse v5.6	`v5.6`	1080p	1–10 detik	Masih digunakan untuk kontrol gerakan dan alur kerja generasi yang dipilih
PixVerse v5.5	`v5.5`	1080p	1–10 detik	Digunakan untuk alur kerja `create modify`
PixVerse v5	`v5`	1080p	1–10 detik	Digunakan untuk 3+ alur kerja transisi bingkai

Menganimasikan Gambar Statis

Untuk mengubah foto atau gambar yang dihasilkan menjadi video, berikan tanda --image:

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

Anda dapat meneruskan jalur file lokal atau URL. File lokal diunggah secara otomatis — tidak diperlukan langkah pengunggahan manual. Input gambar lokal yang lebih besar dari 1920x1920 atau 5MB secara otomatis diubah ukurannya atau dikompresi sebelum diunggah; URL gambar jarak jauh divalidasi oleh backend apa adanya.

Untuk Grok Imagine 1.5, gambar diperlukan dan rasio aspek keluaran mengikuti gambar tersebut:

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 Referensi, Transisi, Kontrol Gerakan, dan Templat

CLI saat ini mendukung lebih dari sekadar teks-ke-video dan gambar-ke-video. Mode pembuatan ini berguna saat Anda memerlukan kontrol lebih besar atas karakter, bingkai utama, pengeditan, atau efek:

# Create a transition between keyframes pixverse create transition --images ./frame1.png ./frame2.png # Hasilkan audio ucapan dari teks pixverse create voice --text "Welcome to the launch" --voice-id <preset_voice_id> --output ./voiceover.mp3 # Hasilkan musik dari 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 # Perluas video yang dihasilkan pixverse create extend --video <video_id> # Ubah video yang ada pixverse create modify --video <video_id> --prompt "Change the background to a beach" # Resolusi video kelas atas pixverse create upscale --video <video_id> --quality 1080p # Hasilkan video dengan gambar referensi pixverse create reference --images ./char1.png ./char2.png --prompt "Two friends walking in a park" # Referensi Seedance 2.0 dapat mencampur input gambar dan video pixverse create reference \ --model seedance-2.0-standard \ --images ./character.png \ --videos ./motion.mp4 \ --prompt "@image1 follows the motion in @video1" # Model Seedance 2.0 mendukung hingga 9 gambar referensi 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" # Kontrol gerak dengan gambar karakter dan video referensi gerak pixverse create motion-control --image ./character.png --video ./dance.mp4 # Buat dari template atau efek pixverse create template --template-id 12345 --image ./photo.png

Tidak semua model mendukung setiap mode pembuatan. Dalam matriks README saat ini, create video mendukung 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 hanya untuk gambar-ke-video dan memerlukan --image; create extend mendukung v6 dan grok-imagine; create reference mendukung v6, pixverse-c1, Seedance 2.0 Standard/Fast/Mini, Google Gemini Omni, Kling O3, grok-imagine, dan v5.6; Transisi 2 bingkai mendukung kelompok video yang lebih baru; 3+ transisi bingkai menggunakan v5; create modify menggunakan v5.5; dan create motion-control menggunakan v5.6.

Langkah 5: Hasilkan Suara dan Musik

GitHub README saat ini mendokumentasikan audio mandiri melalui perintah pembuatan khusus. Gunakan create voice untuk text-to-speech dan create music untuk pembuatan prompt-to-music. Output suara dan musik disimpan sebagai aset audio, sehingga Anda dapat melacaknya dengan task, mencantumkannya dengan asset list --type audio, dan mendownloadnya dengan asset download --type audio. Untuk suasana video asli, gunakan --audio atau --no-audio pada perintah pembuatan video yang didukung.

Hasilkan 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

Telusuri model suara dan suara preset:

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

Hasilkan musik:

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 mendukung lirik, teruskan lirik sebagai teks literal, jalur file lokal, atau stdin:

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

Kelompok model suara saat ini mencakup model MiniMax Speech 2.8 dan ElevenLabs. Keluarga model musik saat ini termasuk MiniMax Music, ElevenLabs Music, dan Google Lyria 3 Pro. Gunakan pixverse voice models dan pixverse music models untuk katalog langsung sebelum membuat skrip alur kerja produksi.

Langkah 6: Jalankan Wizard Interaktif

Jika Anda baru pertama kali menjelajah dan belum terbiasa dengan semua tanda yang tersedia, jalankan perintah pembuatan apa pun tanpa argumen untuk masuk ke panduan terpandu:

pixverse create video pixverse create image

Wizard memandu Anda melalui prompt, pemilihan model, kualitas, rasio aspek, durasi, dan opsi lainnya langkah demi langkah — berguna untuk menemukan parameter apa yang tersedia sebelum membuat skrip.

Beyond Generation: Kelola Aset dan Ruang Kerja Anda

PixVerse CLI saat ini juga menyertakan perintah manajemen yang membantu Anda membangun alur kerja terminal ujung ke ujung:

pixverse task status <id> dan pixverse task wait <id> untuk polling tugas
pixverse task status --ids 123,456,789 --type video --json untuk pemeriksaan status batch
pixverse asset list, asset upload, asset info, asset download, dan asset delete untuk operasi siklus hidup aset video, gambar, 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 menemukan efek dan template
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 multi-ruang kerja
pixverse account info, account usage, dan account slots untuk pemeriksaan kredit, penggunaan, dan konkurensi
pixverse config set, config list, config path, dan config defaults untuk default lokal berulang

Hal ini memudahkan untuk mengotomatiskan tidak hanya pembuatan, tetapi juga pengorganisasian, penemuan templat, penemuan audio, pengunduhan, perutean ruang kerja, dan pengiriman dalam satu skrip. Jika Anda perlu menjalankan satu perintah pada ruang kerja yang berbeda, gunakan flag --workspace-id <id> global; 0 menargetkan ruang kerja pribadi Anda.

Bendera Ramah Skrip

Sebagian besar otomatisasi bergantung pada keluaran yang dapat diprediksi dan perilaku waktu proses yang dapat diprediksi. Tanda-tanda ini sangat berguna dalam skrip dan alur kerja agen AI:

Bendera	Gunakan Untuk
`--json`	Kembalikan keluaran JSON terstruktur
`-p`	Alias pendek untuk `--json`
`--count <n>`	Hasilkan 1–4 variasi dari satu permintaan
`--seed <number>`	Membuat generasi lebih mudah untuk direproduksi
`--off-peak`	Gunakan harga di luar jam sibuk jika tersedia
`--audio` / `--no-audio`	Mengaktifkan atau menonaktifkan pembuatan audio pada perintah pembuatan yang didukung
`--multi-shot` / `--no-multi-shot`	Mengaktifkan atau menonaktifkan mode multi-shot untuk video
`--no-wait`	Kirim pekerjaan dan segera kembali
`--timeout <sec>`	Atur batas waktu pemungutan suara, defaultnya adalah 300 detik
`--workspace-id <id>`	Ganti ruang kerja aktif untuk satu perintah
`--trace-id <uuid>`	Lampirkan UUIDv4 yang disediakan pemanggil ke permintaan API untuk proses debug dan observasi
`--idempotency-key <key>`	Coba lagi permintaan pembuatan dengan aman tanpa secara tidak sengaja membuat tugas duplikat yang dikenakan biaya

Tanda masukan teks kini lebih mudah diotomatisasi. --prompt, --text, dan --lyrics dapat menerima string literal, jalur file lokal, 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

Mengajari Agen AI Anda untuk Menghasilkan Media

Di sinilah PixVerse CLI menjadi benar-benar transformatif. Karena perintah dapat mengembalikan JSON terstruktur dan menggunakan kode keluar deterministik, setiap agen AI yang dapat menjalankan perintah shell dapat diajarkan untuk menghasilkan gambar dan video sesuai permintaan.

Menginstal PixVerse Skills

PixVerse Skillsadalah pustaka keterampilan terstruktur yang mengajarkan agen cara menggunakan CLI dengan benar: tanda perintah, batasan model, alur multi-langkah, dan penanganan kesalahan yang tangguh.

Untuk Claude Code dan agen lain yang mendukung format skill, tambahkan langsung skill PixVerse:

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

Untuk Cursor, Claude Code, Codex, dan kerangka kerja agen lainnya, keterampilan ini meningkatkan keandalan dengan memberikan batasan eksplisit kepada agen alih-alih memaksanya menyimpulkannya dari awal.

PixVerse CLI juga mengirimkan manifes perintah ringkas yang dapat dibaca mesin di dist/capabilities.json, dengan sumber publik tersedia sebagai capabilities.json di repositori GitHub. Manifes ini menjelaskan perintah, tanda, kode keluar, ekspektasi keluaran JSON, dan kategori efek, sehingga agen dapat memeriksa kontrak CLI tanpa menghapus teks bantuan.

Setelah agen Anda memuat keterampilan PixVerse, Anda dapat memberikan instruksi bahasa alami seperti:

“Buat video demo produk berdurasi 10 detik dari tangkapan layar ini”
“Buat empat variasi gambar sampul blog ini dalam format 16:9”
“Animasi diagram ini menjadi klip penjelasan berdurasi 5 detik dengan suara sekitar”
“Buat tiga klip promo berdurasi 8 detik 16:9 dengan gerakan kamera berbeda”

Agen akan menerjemahkan instruksi tersebut ke dalam perintah CLI yang benar, mengurai output JSON, dan menangani polling dan pengunduhan — tidak diperlukan intervensi manual.

Claude Code

Di Claude Code, PixVerse CLI menjadi alat asli yang digunakan agen secara mandiri. Setelah memuat keterampilan PixVerse, Anda dapat menyertakan pembuatan media secara langsung dalam tugas apa pun:

Generate a cover image for this blog post about machine learning, use the seedream-5.0-lite model at 2160p in 16:9 format, download it to ./assets/cover.webp

Claude Code akan menjalankan perintah CLI yang benar, mengurai URL gambar dari respons JSON, dan mengunduh file ke jalur yang Anda tentukan — semuanya dalam sesi yang sama di mana ia juga menulis kode Anda.

Alur kerja Claude Code yang khas:

# 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') # Kemudian menganimasikannya pixverse create video \ --prompt "Slow pan across glowing neural connections" \ --image "$IMG" \ --model v6 \ --quality 1080p \ --duration 6 \ --json

Cursor

Pengguna Cursor dapat memuat PixVerse Skills sebagai file konteks proyek. Tempatkan file keterampilan yang relevan di direktori .cursor/ Anda atau tambahkan ke aturan ruang kerja Anda. Setelah dimuat, Cursor memiliki kesadaran penuh terhadap setiap perintah PixVerse CLI dan dapat menghasilkan media sebagai bagian dari tugas pengkodean apa pun.

Alur kerja Cursor yang umum: minta agen untuk membuat gambar mockup berdasarkan desain yang Anda buat, lalu gunakan sebagai referensi langsung di sesi IDE Anda — tanpa harus meninggalkan editor.

Codex dan Agen Lainnya

PixVerse CLI kompatibel dengan agen mana pun yang dapat menjalankan perintah shell dan mengurai JSON. Format keluaran terstruktur — nama bidang yang konsisten, kode kesalahan yang dapat diprediksi, dan pesan kesalahan yang dipisahkan stderr — memastikan bahwa bahkan agen skrip sederhana pun dapat mengintegrasikan pembuatan dengan andal.

Kontrak kode keluar membuat penanganan kesalahan menjadi mudah:

Kode	Artinya	Aksi Agen
0	Sukses	Parsing keluaran JSON
1	Kesalahan umum	Periksa stderr dan coba lagi dengan input yang divalidasi
2	Batas waktu	Coba lagi dengan `--timeout` yang lebih panjang
3	Masa berlaku autentikasi sudah habis	Jalankan kembali `pixverse auth login`
4	Kehabisan kredit	Periksa saldo, beri tahu pengguna
5	Generasi gagal	Coba parameter yang berbeda
6	Kesalahan validasi	Tinjau nilai tanda

Saluran Otomasi

Setelah Anda memahami masing-masing perintah, PixVerse CLI membuka alur kerja multi-langkah canggih yang berjalan sepenuhnya tanpa interaksi pengguna.

Teks ke Gambar ke Video

Salah satu pipeline yang paling berguna: menghasilkan gambar resolusi tinggi dari perintah teks, lalu menganimasikannya 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') # Langkah 2: Animasikan menjadi 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') # Langkah 3: Unduh video terakhir pixverse asset download "$VIDEO_ID" --json

Saluran Produksi Video Lengkap

Untuk hasil yang lebih baik, pembuatan rantai dengan langkah-langkah pasca-pemrosesan. Gunakan --audio atau --no-audio bila Anda menginginkan suara asli pada perintah pembuatan video yang didukung, lalu gunakan create voice untuk audio text-to-speech dan create music untuk aset musik mandiri yang akan Anda gabungkan di hilir:

# 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') # Langkah 2: Perpanjang durasi EXTENDED=$(pixverse create extend \ --video "$VID" \ --json | jq -r '.video_id') pixverse task wait "$EXTENDED" --json # Langkah 3: Tingkatkan ke 1080p FINAL=$(pixverse create upscale \ --video "$EXTENDED" \ --quality 1080p \ --json | jq -r '.video_id') pixverse task wait "$FINAL" --json # Langkah 4: Unduh pixverse asset download "$FINAL" --json # Opsional: buat aset sulih suara terpisah pixverse create voice \ --text "The final reveal starts now." \ --voice-id <preset_voice_id> \ --output ./voiceover.mp3 \ --json

Generasi Batch

Untuk alur konten yang memerlukan beberapa variasi, jalankan pekerjaan secara paralel:

# Check credits and concurrent generation slots first pixverse account info --json pixverse account slots --json # Kirimkan empat generasi paralel 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 # Periksa semua ID tugas yang dikembalikan dalam satu panggilan status batch 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 # Tunggu masing-masing dan unduh 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 mengirimkan pekerjaan dan segera kembali dengan ID tugas, memungkinkan Anda mengirimkan beberapa pekerjaan sebelum pemungutan suara. Dengan --no-wait --json, catat ID tugas yang dikembalikan dan selesaikan parameter pembuatan untuk pencatatan dan reproduktifitas. Gunakan --count <n> bila Anda menginginkan beberapa variasi dari satu perintah, dan gunakan batch task status --ids bila Anda menginginkan satu respons status untuk beberapa pekerjaan yang sedang berjalan. Perintah pixverse task wait menangani polling adaptif untuk Anda.

Mengonfigurasi Default

Jika Anda terus-menerus menggunakan model, kualitas, atau rasio aspek yang sama, tetapkan semuanya sebagai default sehingga Anda tidak perlu mengulangi tanda setiap saat:

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

Tanda baris perintah selalu mengesampingkan konfigurasi default Anda, sehingga Anda mempertahankan fleksibilitas penuh sekaligus mengurangi pengulangan. Untuk otomatisasi khusus ruang kerja, tambahkan --workspace-id <id> ke perintah saat Anda ingin mengganti ruang kerja aktif untuk proses tunggal tersebut.

Apa yang Dapat Anda Bangun

Dengan PixVerse CLI terintegrasi ke dalam alur kerja agen Anda, rentang tugas yang dapat diotomatisasi semakin luas:

Dokumentasi— membuat video demo produk dan tangkapan layar secara otomatis sebagai bagian dari proses pembuatan dokumen Anda
Pemasaran— menjalankan pekerjaan batch setiap malam yang menghasilkan variasi konten media sosial dari satu perpustakaan cepat
Pengembangan aplikasi— biarkan agen pengkodean Anda menghasilkan visual placeholder, animasi mockup, atau video layar pemuatan saat Anda membuat UI
Alur kerja audio— menghasilkan draf sulih suara, trek musik yang cepat, atau aset audio untuk diedit nanti
Content pipeline— panggilan berantai CLI dengan alat lain (ffmpeg, ImageMagick, penyimpanan cloud) untuk membangun alur kerja produksi media yang sepenuhnya otomatis
Pembuatan Prototipe— menghasilkan konsep gerakan cepat dalam hitungan detik untuk memvalidasi ide sebelum melakukan produksi penuh

CLI dirancang agar sesuai secara alami dengan alur kerja berbasis shell apa pun. Jika otomatisasi Anda yang ada berjalan di bash, Python, Node, atau pipeline CI/CD, PixVerse CLI masuk tanpa overhead integrasi tambahan apa pun.

Daftar Periksa Memulai

Menjaga CLI Tetap Terkini

Gunakan pembaru bawaan untuk menjaga CLI lokal Anda tetap terkini:

pixverse update

Anda juga dapat menggunakan npm secara langsung:

npm install -g pixverse@latest

Karena PixVerse CLI adalah alat yang terus diperbarui, bukan peluncuran satu kali, perlakukan artikel ini sebagai panduan praktis dan sumber resmi sebagai lapisan referensi langsung. Halaman resmi PixVerse CLI adalah jalur terpendek untuk instalasi dan onboarding agen, sedangkan GitHub tetap menjadi tempat untuk melacak perubahan tingkat rilis dan model baru yang didukung:

Dokumen saat ini menyoroti PixVerse V6 sebagai model video default, GPT Image 2 sebagai model gambar default, dukungan video Google Gemini Omni, dukungan gambar Nano Banana 2 Lite dan Seedream 5.0 Pro, dukungan Seedance 2.0 Mini, alur kerja PixVerse v5 dan v5.5 khusus mode, perintah create voice dan create music khusus, manajemen aset audio, folder tersimpan, peralihan ruang kerja, config defaults, capabilities.json untuk agen, pixverse update, dukungan stdin untuk teks input, --trace-id, dan --idempotency-key untuk percobaan ulang yang lebih aman.

Langkah Selanjutnya

Halaman resmi PixVerse CLI, PixVerse CLI di GitHub, dan npm (npm install -g pixverse) memberi Anda akses langsung ke pembuatan, polling tugas, manajemen aset, templat, folder tersimpan, pemeriksaan akun, penemuan model audio, dan kontrol ruang kerja dari satu antarmuka. Repositori PixVerse Skills menambahkan panduan siap agen sehingga Claude Code, Cursor, Codex, dan alat lainnya dapat menjalankan alur kerja ini dengan keandalan yang lebih kuat.

Kombinasi CLI yang andal dan pustaka keterampilan yang siap digunakan agen berarti pembuatan gambar, video, suara, dan musik dapat berjalan dalam alur kerja yang sama dengan kode Anda — dikelola oleh agen yang sama, di terminal yang sama, tanpa berpindah alat.

Mulailah dengan satu perintah. Bangun dari sana.