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>danpixverse task wait <id>untuk peninjauan tugaspixverse task status --ids 123,456,789 --type video --jsonuntuk semakan status kelompokpixverse asset list,asset upload,asset info,asset download, danasset deleteuntuk operasi kitaran hayat aset video, imej, dan audiopixverse saved list,saved items,saved new,saved rename,saved add,saved remove, dansaved deleteuntuk folder yang disimpanpixverse template categories,template list,template search, dantemplate infountuk menemui kesan dan templatpixverse voice models,voice presets, danmusic modelsuntuk penemuan model audio langsungpixverse workspace list,workspace status,workspace switch, danworkspace manageuntuk operasi berbilang ruang kerjapixverse account info,account usage, danaccount slotsuntuk semakan kredit, penggunaan, dan serentakanpixverse config set,config list,config path, danconfig defaultsuntuk 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 logindan benarkan dalam pelayar - Jalankan
pixverse account infountuk mengesahkan kredit - Jalankan
pixverse account slotssebelum 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
- Ulasan Penjana 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
Jana video, imej, suara, dan muzik daripada terminal anda dengan PixVerse.