PixVerse CLI: Hasilkan Video dan Gambar AI di Terminal
Pendahuluan
Setiap alur kerja kreatif memiliki hambatan — momen ketika Anda harus meninggalkan editor kode, membuka peramban, dan mengeklik secara manual melalui antarmuka web untuk menghasilkan satu bagian media. Bagi pengembang, agen AI, dan siapa pun yang membangun pipeline konten otomatis, perpindahan konteks itu adalah gesekan yang cepat menumpuk.
PixVerse CLI menghilangkan hambatan itu. Ini adalah antarmuka baris perintah resmi untuk PixVerse, yang memberi Anda akses ke pembuatan PixVerse dan alur kerja ruang kerja langsung dari terminal. Teks-ke-video, gambar-ke-video, teks-ke-gambar, gambar-ke-gambar, transisi, pembuatan suara, pembuatan musik, video referensi, kontrol gerak, templat, upscaling, dan pengelolaan aset semuanya dapat diskrip, dapat dialirkan lewat pipe, dan tersedia tanpa menyentuh peramban. Untuk jalur instalasi terpendek dan ikhtisar penyiapan agen, mulai dari halaman resmi PixVerse CLI.
Yang membuat PixVerse CLI sangat berguna adalah filosofi desainnya: CLI ini dibangun dengan mempertimbangkan agen AI. Perintah dapat mengembalikan JSON terstruktur dengan --json atau -p, kode keluar bersifat deterministik, dan setiap langkah pipeline dapat disusun. Artinya, Anda dapat mengajari Claude Code, Cursor, Codex, atau agen lain mana pun untuk menghasilkan gambar, video, suara, dan musik atas nama Anda dengan lebih sedikit serah terima yang rapuh.
Panduan ini selaras dengan README GitHub PixVerseAI/cli saat ini, manifes kapabilitas publiknya, dan halaman produk PixVerse CLI, diperiksa pada 13 Juli 2026. PixVerse CLI diperbarui secara berkelanjutan melalui repositori GitHub, jadi skrip produksi tetap harus memverifikasi pixverse --version, pixverse create <mode> --help, dan pixverse update sebelum menjalankan batch besar.
Prasyarat
Sebelum memulai, Anda memerlukan:
- Node.js 20 atau lebih tinggi — periksa dengan
node --version - Akun PixVerse — daftar di pixverse.ai
- Langganan PixVerse yang aktif — CLI menggunakan sistem kredit yang sama dengan situs web; hanya pengguna berlangganan yang dapat menghasilkan konten
PixVerse CLI tidak mengharuskan kunci API disalin secara manual. Autentikasi ditangani melalui alur OAuth berbasis peramban yang menyimpan token Anda secara lokal.
Langkah 1: Instal CLI
Instal secara global dengan npm:
npm install -g pixverseVerifikasi instalasi:
pixverse --versionJika Anda lebih suka tidak menginstal secara global, Anda juga dapat menjalankan perintah melalui npx:
npx pixverse create video --prompt "A cat walking on Mars"Langkah 2: Autentikasi
Jalankan perintah login:
pixverse auth loginCLI membuka peramban untuk otorisasi perangkat OAuth. Anda juga dapat menyalin URL dan menyelesaikan otorisasi dari peramban mana pun di perangkat mana pun, yang berguna untuk SSH dan lingkungan headless. Token Anda disimpan secara otomatis di ~/.pixverse/ dan berlaku selama 30 hari.
Untuk memverifikasi bahwa Anda sudah masuk dan memeriksa kredit yang tersedia:
pixverse auth status
pixverse account info
pixverse account slotsPerintah account info menampilkan tingkat langganan, kredit ruang kerja, dan konteks penggunaan Anda. pixverse account usage membantu Anda meninjau konsumsi kredit, sementara pixverse account slots menampilkan slot pembuatan bersamaan saat ini untuk pekerjaan gambar dan video. Sesi CLI terpisah dari sesi web/aplikasi PixVerse, dan Anda dapat menghapus token CLI yang tersimpan dengan pixverse auth logout. Selalu periksa saldo dan slot yang tersedia sebelum menjalankan pekerjaan batch.
Perintah Mulai Cepat
Jika Anda hanya memerlukan jalur terpendek dari instalasi ke aset yang dihasilkan, mulai 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 --jsonUntuk alur kerja agen dan CI, biarkan --json atau -p aktif agar stdout tetap dapat dibaca mesin sementara progres dan kesalahan tetap di stderr. Untuk percobaan ulang produksi, tambahkan --idempotency-key <key> ke perintah pembuatan agar pengiriman berulang tidak secara tidak sengaja membuat pekerjaan berbayar yang duplikat.
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" --jsonREADME GitHub 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. Flag --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 beresolusi 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 \
--jsonPixVerse mendukung beberapa model gambar, masing-masing dengan batas resolusi dan dukungan rasio aspek yang berbeda:
| Model | Nilai --model |
Kualitas | Catatan |
|---|---|---|---|
| GPT Image 2 | gpt-image-2.0 |
1080p, 1440p, 2160p | Model gambar default; mendukung rasio aspek lebar dan tinggi |
| Nano Banana 2 | gemini-3.1-flash |
512p, 1080p, 1440p, 2160p | auto yang fleksibel dan rasio aspek standar |
| Nano Banana 2 Lite | gemini-3.1-flash-lite |
1080p | Opsi Nano Banana 2 yang ringan untuk alur kerja gambar yang cepat |
| Qwen Image | qwen-image |
720p, 1080p | Pembuatan cepat untuk tugas kreatif yang umum |
| Nano Banana Pro | gemini-3.0 |
1080p, 1440p, 2160p | Pembuatan gambar berkualitas tinggi pada ukuran yang lebih besar |
| Nano Banana | gemini-2.5-flash |
1080p | Pembuatan gambar ringan dengan penyelesaian yang cepat |
| Seedream 5.0 Pro | seedream-5.0-pro |
1080p, 1440p | Mendukung rasio aspek standar dan alur kerja gambar multi-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 beresolusi 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 | Keluaran visual bergaya dengan pembingkaian yang fleksibel |
| Kling Image V3 | kling-image-v3 |
1080p, 1440p | Kualitas dan kecepatan yang seimbang |
Anda juga dapat mengubah gambar yang sudah 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 \
--jsonUntuk mengunduh gambar yang dihasilkan:
pixverse asset download 789012Langkah 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" --jsonUntuk pembuatan 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 \
--jsonFlag --audio mengaktifkan suara ambien yang dihasilkan AI yang sesuai dengan konten video Anda. Flag --json mengembalikan video_url saat selesai yang dapat Anda teruskan langsung ke perintah unduh atau langkah berikutnya dalam pipeline.
PixVerse menyediakan beberapa model video dengan dukungan kualitas, durasi, dan mode yang berbeda:
| Model | Nilai --model |
Kualitas Maks. | Durasi | Catatan |
|---|---|---|---|---|
| PixVerse V6 | v6 |
1080p | 1–15 dtk | Model video default; dukungan rasio aspek yang luas |
| PixVerse C1 | pixverse-c1 |
1080p | 1–15 dtk | Dukungan kuat di seluruh alur kerja video, referensi, dan transisi |
| Seedance 2.0 Standard | seedance-2.0-standard |
2160p | 4–15 dtk | Mendukung mode video, referensi, dan transisi |
| Seedance 2.0 Fast | seedance-2.0-fast |
720p | 4–15 dtk | Opsi Seedance yang lebih cepat untuk mode video, referensi, dan transisi |
| Seedance 2.0 Mini | seedance-2.0-mini |
720p | 4–15 dtk | Opsi Seedance yang ringan untuk mode video, referensi, dan transisi |
| Google Gemini Omni | gemini-omni-flash |
720p | 3–10 dtk | Mendukung alur kerja video dan referensi dalam 16:9 atau 9:16 |
| Happy Horse 1.0 | happyhorse-1.0 |
1080p | 3–15 dtk | Opsi video yang sadar audio tersedia untuk create video |
| Kling O3 Pro | kling-o3-pro |
720p | 3–15 dtk | Mendukung alur kerja video, referensi, dan transisi |
| Kling O3 Standard | kling-o3-standard |
720p | 3–15 dtk | Opsi Kling O3 standar |
| Kling 3.0 Pro | kling-3.0-pro |
720p | 3–15 dtk | Mendukung alur kerja video dan transisi |
| Kling 3.0 Standard | kling-3.0-standard |
720p | 3–15 dtk | Opsi Kling 3.0 standar |
| Grok Imagine 1.5 | grok-imagine-1.5 |
720p | 1–15 dtk | Hanya gambar-ke-video; memerlukan --image dan mengikuti rasio aspek gambar masukan |
| Grok Imagine | grok-imagine |
720p | 1–15 dtk | Opsi Grok yang lebih awal; mendukung alur kerja video, perpanjangan, dan referensi |
| Veo 3.1 Lite | veo-3.1-lite |
1080p | 4, 6, atau 8 dtk | Mendukung alur kerja video dan transisi 2 bingkai |
| Veo 3.1 Standard | veo-3.1-standard |
2160p | 4, 6, atau 8 dtk | Opsi Veo beresolusi lebih tinggi |
| Veo 3.1 Fast | veo-3.1-fast |
2160p | 4, 6, atau 8 dtk | Opsi Veo yang lebih cepat |
| Sora 2 Pro | sora-2-pro |
1080p | 4, 8, atau 12 dtk | Opsi Sora dengan durasi tetap |
| Sora 2 | sora-2 |
720p | 4, 8, atau 12 dtk | Opsi Sora standar |
| PixVerse v5.6 | v5.6 |
1080p | 1–10 dtk | Masih digunakan untuk kontrol gerak dan alur kerja pembuatan tertentu |
| PixVerse v5.5 | v5.5 |
1080p | 1–10 dtk | Digunakan untuk alur kerja create modify |
| PixVerse v5 | v5 |
1080p | 1–10 dtk | Digunakan untuk alur kerja transisi 3+ bingkai |
Model mitra seperti Seedance, Kling, Veo, Sora, Gemini Omni, Grok Imagine, dan HappyHorse adalah opsi di PixVerse. Gunakan permukaan CLI yang sama untuk membandingkannya dengan PixVerse V6 dan C1.
Animasikan Gambar Statis
Untuk mengubah foto atau gambar yang dihasilkan menjadi video, berikan flag --image:
pixverse create video \
--prompt "Gentle wind moves through the scene" \
--image ./product-photo.jpg \
--model v6 \
--quality 1080p \
--jsonAnda dapat meneruskan jalur file lokal atau URL. File lokal diunggah secara otomatis — tidak diperlukan langkah unggah manual. Masukan 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 wajib ada 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 \
--jsonGunakan Referensi, Transisi, Kontrol Gerak, dan Templat
CLI saat ini mendukung lebih dari sekadar teks-ke-video dan gambar-ke-video yang sederhana. Mode pembuatan ini berguna ketika Anda memerlukan lebih banyak kontrol atas karakter, bingkai kunci, suntingan, atau efek:
# 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.pngTidak setiap 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 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 keluarga video yang lebih baru; transisi 3+ bingkai menggunakan v5; create modify menggunakan v5.5; dan create motion-control menggunakan v5.6.
Langkah 5: Hasilkan Suara dan Musik
README GitHub saat ini mendokumentasikan audio mandiri melalui perintah pembuatan khusus. Gunakan create voice untuk teks-ke-ucapan dan create music untuk pembuatan prompt-ke-musik. Keluaran suara dan musik disimpan sebagai aset audio, jadi Anda dapat melacaknya dengan task, mencantumkannya dengan asset list --type audio, dan mengunduhnya dengan asset download --type audio. Untuk ambiens video bawaan, 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 \
--jsonTelusuri model suara dan suara prasetel:
pixverse voice models --json
pixverse voice presets --model speech-2.8-hd --jsonHasilkan musik:
pixverse create music \
--prompt "A bright cinematic synth-pop track for a 30-second product reveal" \
--auto-lyrics \
--duration-seconds 30 \
--jsonUntuk 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 \
--jsonKeluarga model suara saat ini mencakup MiniMax Speech 2.8 dan model ElevenLabs. Keluarga model musik saat ini mencakup MiniMax Music, ElevenLabs Music, dan Google Lyria 3 Pro. Gunakan pixverse voice models dan pixverse music models untuk katalog langsung sebelum menulis skrip alur kerja produksi.
Langkah 6: Jalankan Wizard Interaktif
Jika Anda menjelajah untuk pertama kali dan belum familier dengan semua flag yang tersedia, jalankan perintah pembuatan apa pun tanpa argumen untuk masuk ke wizard terpandu:
pixverse create video
pixverse create imageWizard memandu Anda melalui prompt, pemilihan model, kualitas, rasio aspek, durasi, dan opsi lain langkah demi langkah — berguna untuk menemukan parameter apa yang tersedia sebelum menuliskannya dalam skrip.
Melampaui Pembuatan: Kelola Aset dan Ruang Kerja Anda
PixVerse CLI saat ini juga menyertakan perintah pengelolaan yang membantu Anda membangun alur kerja terminal dari ujung ke ujung:
pixverse task status <id>danpixverse task wait <id>untuk polling tugaspixverse task status --ids 123,456,789 --type video --jsonuntuk pemeriksaan status batchpixverse asset list,asset upload,asset info,asset download, danasset deleteuntuk operasi siklus hidup aset video, gambar, dan audiopixverse saved list,saved items,saved new,saved rename,saved add,saved remove, dansaved deleteuntuk folder tersimpanpixverse template categories,template list,template search, dantemplate infountuk menemukan efek dan templatpixverse voice models,voice presets, danmusic modelsuntuk penemuan model audio langsungpixverse workspace list,workspace status,workspace switch, danworkspace manageuntuk operasi multi-ruang kerjapixverse account info,account usage, danaccount slotsuntuk pemeriksaan kredit, penggunaan, dan konkurensipixverse config set,config list,config path, danconfig defaultsuntuk default lokal yang dapat diulang
Ini memudahkan otomatisasi tidak hanya pembuatan, tetapi juga pengorganisasian, penemuan templat, penemuan audio, unduhan, pengarahan ruang kerja, dan pengiriman dalam satu skrip. Jika Anda perlu menjalankan satu perintah terhadap ruang kerja yang berbeda, gunakan flag global --workspace-id <id>; 0 menargetkan ruang kerja pribadi Anda.
Flag yang Ramah Skrip
Sebagian besar otomatisasi bergantung pada keluaran yang dapat diprediksi dan perilaku runtime yang dapat diprediksi. Flag ini sangat berguna dalam skrip dan alur kerja agen AI:
| Flag | Gunakan Untuk |
|---|---|
--json |
Mengembalikan keluaran JSON terstruktur |
-p |
Alias pendek untuk --json |
--count <n> |
Menghasilkan 1–4 variasi dari satu permintaan |
--seed <number> |
Membuat pembuatan lebih mudah direproduksi |
--off-peak |
Menggunakan 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 |
Mengirim pekerjaan dan segera kembali |
--timeout <sec> |
Mengatur batas waktu polling, default 300 detik |
--workspace-id <id> |
Mengganti ruang kerja aktif untuk satu perintah |
--trace-id <uuid> |
Melampirkan UUIDv4 yang diberikan pemanggil ke permintaan API untuk debugging dan observabilitas |
--idempotency-key <key> |
Mencoba ulang permintaan pembuatan dengan aman tanpa secara tidak sengaja membuat pekerjaan berbayar yang duplikat |
Flag masukan teks kini lebih mudah diotomatiskan. --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 --jsonMengajari Agen AI Anda untuk Menghasilkan Media
Bagi tim yang lebih suka titik awal terpandu berbasis aplikasi sebelum beralih ke otomatisasi baris perintah, Agen PixVerse menyediakan alur kerja pembuatan berorientasi agen di aplikasi PixVerse.
Di sinilah PixVerse CLI menjadi benar-benar transformatif. Karena perintah dapat mengembalikan JSON terstruktur dan menggunakan kode keluar yang deterministik, agen AI mana pun yang dapat menjalankan perintah shell dapat diajari untuk menghasilkan gambar dan video sesuai permintaan.
Menginstal PixVerse Skills
PixVerse Skills adalah pustaka skill terstruktur yang mengajari agen cara menggunakan CLI dengan benar: flag perintah, batasan model, pipeline multi-langkah, dan penanganan kesalahan yang andal.
Untuk Claude Code dan agen lain yang mendukung format skill, tambahkan skill PixVerse secara langsung:
npx skills add https://github.com/pixverseai/skills --skill pixverse-ai-image-and-video-generatorUntuk Cursor, Claude Code, Codex, dan kerangka agen lainnya, skill ini meningkatkan keandalan dengan memberi agen batasan yang eksplisit alih-alih memaksanya menyimpulkan batasan itu dari awal.
PixVerse CLI juga menyertakan 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, flag, kode keluar, ekspektasi keluaran JSON, dan kategori efek, sehingga agen dapat memeriksa kontrak CLI tanpa mengikis teks bantuan.
Setelah agen Anda memuat skill PixVerse, Anda dapat memberinya instruksi bahasa alami seperti:
- “Hasilkan video demo produk berdurasi 10 detik dari tangkapan layar ini”
- “Buat empat variasi gambar sampul blog ini dalam format 16:9”
- “Animasikan diagram ini menjadi klip penjelasan 5 detik dengan suara ambien”
- “Hasilkan tiga klip promo 8 detik 16:9 dengan gerakan kamera yang berbeda”
Agen akan menerjemahkan instruksi tersebut menjadi perintah CLI yang benar, mengurai keluaran JSON, serta menangani polling dan unduhan — tanpa intervensi manual.
Claude Code
Di Claude Code, PixVerse CLI menjadi alat bawaan yang digunakan agen secara mandiri. Setelah memuat skill PixVerse, Anda dapat menyertakan pembuatan media secara langsung dalam tugas apa pun:
Buat gambar sampul untuk artikel blog tentang machine learning ini, gunakan model seedream-5.0-lite pada 2160p dalam format 16:9, lalu unduh ke ./assets/cover.webp
Claude Code akan memanggil perintah CLI yang tepat, mengurai URL gambar dari respons JSON, dan mengunduh file ke jalur yang Anda tentukan — semuanya dalam sesi yang sama tempat ia juga menulis kode Anda.
Alur kerja Claude Code yang umum:
# Claude Code runs this autonomously based on your instruction
IMG=$(pixverse create image \
--prompt "Abstract visualization of neural network layers, dark background, blue and purple tones" \
--model seedream-5.0-lite \
--quality 2160p \
--aspect-ratio 16:9 \
--json | jq -r '.image_url')
# Then animates it
pixverse create video \
--prompt "Slow pan across glowing neural connections" \
--image "$IMG" \
--model v6 \
--quality 1080p \
--duration 6 \
--jsonCursor
Pengguna Cursor dapat memuat PixVerse Skills sebagai file konteks proyek. Letakkan file skill yang relevan di direktori .cursor/ Anda atau tambahkan ke aturan workspace. Setelah dimuat, Cursor sepenuhnya memahami setiap perintah PixVerse CLI dan dapat menghasilkan media sebagai bagian dari tugas pengodean apa pun.
Alur kerja Cursor yang umum: minta agen membuat gambar mockup berdasarkan desain yang sedang Anda bangun, lalu gunakan langsung sebagai referensi dalam sesi IDE — tanpa pernah keluar dari editor.
Codex dan Agen Lainnya
PixVerse CLI kompatibel dengan agen apa pun yang dapat menjalankan perintah shell dan mengurai JSON. Format output terstruktur — nama field yang konsisten, kode error yang dapat diprediksi, dan pesan error yang dipisahkan di stderr — memastikan bahkan agen skrip sederhana dapat mengintegrasikan pembuatan secara andal.
Kontrak kode keluar membuat penanganan error menjadi mudah:
| Kode | Arti | Tindakan Agen |
|---|---|---|
| 0 | Berhasil | Urai output JSON |
| 1 | Error umum | Periksa stderr dan coba lagi dengan input yang sudah divalidasi |
| 2 | Timeout | Coba lagi dengan --timeout yang lebih lama |
| 3 | Autentikasi kedaluwarsa | Jalankan ulang pixverse auth login |
| 4 | Kredit habis | Periksa saldo, beri tahu pengguna |
| 5 | Pembuatan gagal | Coba parameter yang berbeda |
| 6 | Error validasi | Tinjau nilai flag |
Pipeline Otomatisasi
Setelah Anda memahami perintah individual, PixVerse CLI membuka alur kerja multi-langkah yang kuat dan berjalan sepenuhnya tanpa interaksi pengguna.
Teks ke Gambar ke Video
Salah satu pipeline yang paling berguna: buat gambar beresolusi tinggi dari prompt teks, lalu animasikan 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" --jsonPipeline Produksi Video Lengkap
Untuk hasil yang lebih rapi, rangkaikan pembuatan dengan langkah pascaproses. Gunakan --audio atau --no-audio saat 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 tahap berikutnya:
# 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 \
--jsonPembuatan Batch
Untuk pipeline konten yang membutuhkan banyak variasi, jalankan pekerjaan secara paralel:
# 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
doneFlag --no-wait mengirimkan pekerjaan dan langsung mengembalikan ID tugas, sehingga Anda dapat mengirim beberapa pekerjaan sebelum melakukan polling. Dengan --no-wait --json, catat ID tugas yang dikembalikan beserta parameter pembuatan yang terpakai untuk pencatatan dan reproduksibilitas. Gunakan --count <n> saat Anda menginginkan beberapa variasi dari satu prompt, dan gunakan batch task status --ids saat Anda menginginkan satu respons status untuk beberapa pekerjaan yang sedang berjalan. Perintah pixverse task wait menangani polling adaptif untuk Anda.
Mengatur Default
Jika Anda selalu memakai model, kualitas, atau rasio aspek yang sama, tetapkan sebagai default agar Anda tidak perlu mengulang flag 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 pathFlag baris perintah selalu menimpa default yang Anda atur, sehingga Anda tetap memiliki fleksibilitas penuh sekaligus mengurangi pengulangan. Untuk otomatisasi khusus workspace, tambahkan --workspace-id <id> ke sebuah perintah saat Anda ingin menimpa workspace aktif hanya untuk satu kali jalankan itu.
Apa yang Bisa Anda Bangun
Dengan PixVerse CLI yang terintegrasi ke alur kerja agen Anda, jangkauan tugas yang dapat diotomatisasi bertambah secara signifikan:
- Dokumentasi — buat otomatis video demo produk dan tangkapan layar sebagai bagian dari proses build dokumentasi
- Pemasaran — jalankan pekerjaan batch setiap malam yang menghasilkan variasi konten media sosial dari satu pustaka prompt
- Pengembangan aplikasi — biarkan agen pengodean Anda membuat visual placeholder, animasi mockup, atau video layar pemuatan saat Anda membangun UI
- Alur kerja audio — buat draf voiceover, trek prompt-to-music, atau aset audio untuk pengeditan nanti
- Pipeline konten — rangkaikan panggilan CLI dengan alat lain (ffmpeg, ImageMagick, penyimpanan cloud) untuk membangun alur produksi media yang sepenuhnya otomatis
- Prototipe — buat konsep gerak cepat dalam hitungan detik untuk memvalidasi ide sebelum berkomitmen pada produksi penuh
CLI ini dirancang agar menyatu secara alami dengan alur kerja berbasis shell apa pun. Jika otomatisasi Anda sudah berjalan di bash, Python, Node, atau pipeline CI/CD, PixVerse CLI dapat langsung masuk tanpa beban integrasi tambahan.
Daftar Periksa Memulai
- Instal Node.js 20 atau lebih tinggi
- Jalankan
npm install -g pixverse - Jalankan
pixverse auth logindan otorisasi di browser - Jalankan
pixverse account infountuk memverifikasi kredit - Jalankan
pixverse account slotssebelum pekerjaan batch bersamaan - Buat gambar pertama Anda:
pixverse create image --prompt "..." --json - Buat video pertama Anda:
pixverse create video --prompt "..." --json - Buat aset suara pertama Anda:
pixverse create voice --text "..." --json - Buat aset musik pertama Anda:
pixverse create music --prompt "..." --json - Jelajahi templat dengan
pixverse template list - Instal PixVerse Skills untuk agen Anda (Claude Code, Cursor, atau Codex)
- Atur default pilihan Anda dengan
pixverse config defaults set - Bangun pipeline otomatisasi pertama Anda
Menjaga CLI Tetap Terbaru
Gunakan pembaru bawaan untuk menjaga CLI lokal Anda tetap mutakhir:
pixverse updateAnda juga dapat menggunakan npm secara langsung:
npm install -g pixverse@latestKarena PixVerse CLI adalah alat yang terus diperbarui, bukan peluncuran sekali saja, perlakukan artikel ini sebagai panduan praktis di lapangan dan sumber resmi sebagai lapisan referensi yang selalu hidup. Halaman resmi PixVerse CLI adalah jalur instalasi dan onboarding agen yang paling singkat, sementara GitHub tetap menjadi tempat untuk memantau perubahan tingkat rilis dan model yang baru didukung:
Dokumentasi 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 yang spesifik menurut mode, perintah khusus create voice dan create music, pengelolaan aset audio, folder tersimpan, pergantian workspace, config defaults, capabilities.json untuk agen, pixverse update, dukungan stdin untuk input teks, --trace-id, dan --idempotency-key untuk percobaan ulang yang lebih aman.
Langkah Berikutnya
Halaman resmi PixVerse CLI, PixVerse CLI di GitHub, dan npm (npm install -g pixverse) memberi Anda akses langsung ke pembuatan, polling tugas, pengelolaan aset, templat, folder tersimpan, pemeriksaan akun, penemuan model audio, dan kontrol workspace dari satu antarmuka. Repositori PixVerse Skills menambahkan panduan siap-agen agar Claude Code, Cursor, Codex, dan alat lain dapat menjalankan alur kerja ini dengan keandalan yang lebih kuat.
Kombinasi CLI yang andal dan pustaka skill siap-agen berarti pembuatan gambar, video, suara, dan musik dapat berada 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.
Sumber Terkait
- Ulasan Generator Video AI PixVerse V6
- Model Video AI Terbaik dalam Satu Platform
- Seedance 2.0 Kini Tersedia di PixVerse
- Grok Imagine Kini Tersedia di PixVerse
- Panduan Platform AI PixVerse
Buat video, gambar, suara, dan musik dari terminal Anda dengan PixVerse.