PixVerse CLI: Pembuatan Video dan Gambar AI untuk Pengembang

Pengantar

Setiap alur kerja kreatif memiliki hambatan — momen saat Anda harus keluar dari editor kode, membuka browser, dan mengklik antarmuka web secara manual untuk menghasilkan satu aset media. Bagi pengembang, agen AI, dan tim yang membangun pipeline konten otomatis, perpindahan konteks seperti ini menciptakan friksi yang cepat menumpuk.

PixVerse CLI dirancang untuk menghilangkan hambatan tersebut. Ini adalah command-line interface resmi PixVerse yang memberi akses ke workflow generasi dan workspace PixVerse langsung dari terminal. Text-to-video, image-to-video, text-to-image, image-to-image, transition, lip-sync speech, reference video, motion control, template, upscaling, dan manajemen aset — semuanya bisa di-script, di-pipe, dan dijalankan tanpa membuka browser.

Kekuatan utama PixVerse CLI ada pada filosofi desainnya: dibangun dengan mempertimbangkan agen AI sejak awal. Setiap perintah menghasilkan JSON terstruktur, setiap exit code bersifat deterministic, dan setiap langkah pipeline dapat dikomposisikan. Artinya, Anda dapat mengajari Claude Code, Cursor, Codex, atau agen lain untuk menghasilkan gambar dan video atas nama Anda dengan konsisten.

Panduan ini mencerminkan PixVerse CLI v1.1.9 dan membawa Anda melalui alur lengkap: dari instalasi, generasi pertama, hingga pipeline otomatisasi multi-langkah dan workflow yang dirancang untuk agen.

Prasyarat

Sebelum memulai, Anda memerlukan:

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

PixVerse CLI tidak mengharuskan Anda menyalin API key secara manual. Autentikasi ditangani melalui alur OAuth berbasis browser yang menyimpan token secara lokal.

Langkah 1: Instal CLI

Instal secara global dengan npm:

npm install -g pixverse

Verifikasi instalasi:

pixverse --version

Jika Anda tidak ingin memasang secara global, Anda juga bisa menjalankan perintah melalui npx:

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

Langkah 2: Autentikasi

Jalankan perintah login:

pixverse auth login

CLI akan membuka browser untuk OAuth device authorization. Anda juga bisa menyalin URL dan menyelesaikan otorisasi dari browser mana pun di perangkat apa pun, yang berguna untuk lingkungan SSH dan headless. Token disimpan otomatis di ~/.pixverse/ dan berlaku selama 30 hari.

Untuk memverifikasi bahwa Anda sudah login dan mengecek kredit yang tersedia:

pixverse auth status
pixverse account info
pixverse account slots

Perintah account info menampilkan level langganan, kredit workspace, dan konteks penggunaan. pixverse account usage membantu meninjau konsumsi kredit, sementara pixverse account slots menampilkan slots generasi paralel saat ini untuk job gambar dan video. Selalu cek saldo dan slots sebelum menjalankan batch job.

Langkah 3: Buat Gambar Pertama Anda

Pembuatan text-to-image adalah cara tercepat untuk menguji setup Anda. Jalankan:

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

Di v1.1.9, create image menggunakan GPT Image 2 sebagai default. Flag --json mengembalikan output 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 output 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 dukungan resolusi dan rasio aspek berbeda:

Anda juga dapat mengubah gambar yang sudah ada dengan image-to-image:

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

Untuk mengunduh gambar yang dihasilkan:

pixverse asset download 789012

Langkah 4: Buat Video Pertama Anda

Text-to-video bekerja dengan cara yang sama. Buat klip 5 detik:

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

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

Flag --audio mengaktifkan ambient sound buatan AI yang sesuai dengan konten video Anda. Flag --json mengembalikan video_url setelah selesai yang bisa langsung diteruskan ke perintah unduh atau langkah berikutnya dalam pipeline.

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

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

Anda dapat memberikan path file lokal atau URL. File lokal diunggah otomatis, jadi tidak perlu langkah unggah manual. Input gambar lokal yang lebih besar dari 1920x1920 atau 5MB otomatis di-resize atau dikompresi sebelum upload; URL gambar remote divalidasi oleh backend apa adanya.

Gunakan reference, transition, motion control, dan template

CLI saat ini mendukung lebih dari text-to-video dan image-to-video. Mode pembuatan ini berguna saat Anda membutuhkan kontrol lebih atas karakter, keyframe, edit, atau efek:

# Buat transition di antara keyframe
pixverse create transition --images ./frame1.png ./frame2.png
 
# Tambahkan lip-sync speech dengan TTS atau file audio
pixverse create speech --video <video_id> --tts-text "Welcome to the launch"
pixverse create speech --video <video_id> --audio ./voiceover.mp3
 
# Perpanjang video yang sudah dibuat
pixverse create extend --video <video_id>
 
# Ubah video yang sudah ada
pixverse create modify --video <video_id> --prompt "Change the background to a beach"
 
# Upscale resolusi video
pixverse create upscale --video <video_id> --quality 1080p
 
# Buat video dengan gambar reference
pixverse create reference --images ./char1.png ./char2.png --prompt "Two friends walking in a park"
 
# Seedance 2.0 reference dapat mencampur gambar dan video
pixverse create reference \
  --model seedance-2.0-standard \
  --images ./character.png \
  --videos ./motion.mp4 \
  --prompt "@image1 follows the motion in @video1"
 
# Motion control dengan gambar karakter dan video gerakan
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 semua mode pembuatan. Misalnya, create reference kini mendukung v6, pixverse-c1, Seedance 2.0, Kling O3, grok-imagine, dan v5.6; create modify terkait dengan v5.5; create motion-control memakai v5.6; dan lip-sync speech memakai v5.

Langkah 5: Jalankan Interactive Wizard

Jika Anda baru mulai dan belum familiar dengan semua flag yang tersedia, jalankan perintah pembuatan tanpa argumen untuk masuk ke wizard terpandu:

pixverse create video
pixverse create image

Wizard memandu Anda melalui prompt, pemilihan model, kualitas, rasio aspek, durasi, dan opsi lainnya secara bertahap — berguna untuk memahami parameter sebelum menuliskannya ke skrip.

Lebih dari sekadar generasi: Kelola aset dan workspace

PixVerse CLI terbaru juga menyertakan perintah manajemen yang membantu Anda membangun workflow terminal end-to-end:

• pixverse task status <id> dan pixverse task wait <id> untuk polling task
• pixverse task status --ids 123,456,789 --type video --json untuk cek status batch
• pixverse asset list, asset upload, asset info, asset download, dan asset delete untuk operasi siklus hidup aset
• pixverse saved list, saved items, saved new, saved rename, saved add, saved remove, dan saved delete untuk folder tersimpan
• pixverse template categories, template list, template search, dan template info untuk menemukan efek dan template
• pixverse workspace list, workspace status, workspace switch, dan workspace manage untuk operasi multi-workspace
• pixverse account info, account usage, dan account slots untuk cek kredit, penggunaan, dan concurrency
• pixverse config set, config list, config path, dan config defaults untuk default lokal yang dapat digunakan ulang

Ini memudahkan otomatisasi bukan hanya pembuatan, tetapi juga pengorganisasian, penemuan template, pengunduhan, routing workspace, dan distribusi dalam satu skrip. Jika perlu menjalankan satu perintah pada workspace lain, gunakan flag global --workspace-id <id>; 0 menargetkan workspace personal Anda.

Flag ramah skrip

Sebagian besar otomatisasi bergantung pada output dan perilaku runtime yang dapat diprediksi. Flag berikut sangat berguna dalam skrip dan workflow agen AI:

Mengajari Agen AI Anda Menghasilkan Media

Di sinilah PixVerse CLI menjadi benar-benar transformatif. Karena setiap perintah mengembalikan JSON terstruktur dan menggunakan exit code deterministic, agen AI apa pun yang dapat menjalankan perintah shell dapat diajarkan menghasilkan gambar dan video sesuai permintaan.

Menginstal PixVerse Skills

PixVerse Skills adalah pustaka skill terstruktur yang mengajarkan agen cara menggunakan CLI secara benar: flag perintah, batasan model, pipeline multi-langkah, dan penanganan error yang andal.

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

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

Untuk Cursor, Claude Code, Codex, dan framework agen lainnya, skill ini meningkatkan reliabilitas karena agen menerima batasan eksplisit, bukan menebak dari nol.

Setelah agen Anda memuat PixVerse skills, Anda bisa memberikan instruksi bahasa natural seperti:

• “Generate a 10-second product demo video from this screenshot”
• “Create four variations of this blog cover image in 16:9 format”
• “Animate this diagram into a 5-second explainer clip with ambient sound”
• “Generate three 8-second 16:9 promo clips with different camera motions”

Agen akan menerjemahkan instruksi tersebut menjadi perintah CLI yang tepat, mem-parse output JSON, dan menangani polling serta unduhan tanpa intervensi manual.

Claude Code

Di Claude Code, PixVerse CLI menjadi alat native yang digunakan agen secara otonom. Setelah memuat PixVerse skills, Anda bisa menyertakan pembuatan media 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 memanggil perintah CLI yang benar, mem-parse image URL dari respons JSON, dan mengunduh file ke path yang Anda tentukan — semua dalam sesi yang sama saat ia juga menulis kode Anda.

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

Cursor

Pengguna Cursor dapat memuat PixVerse Skills sebagai file konteks proyek. Tempatkan file skill terkait di direktori .cursor/ atau tambahkan ke workspace rules. Setelah dimuat, Cursor memiliki pemahaman penuh atas perintah PixVerse CLI dan dapat menghasilkan media sebagai bagian dari tugas coding apa pun.

Workflow Cursor yang umum: minta agen membuat gambar mockup berdasarkan desain yang sedang Anda bangun, lalu gunakan langsung sebagai referensi di sesi IDE tanpa keluar dari editor.

Codex dan Agen Lainnya

PixVerse CLI kompatibel dengan agen apa pun yang dapat mengeksekusi perintah shell dan mem-parse JSON. Format output terstruktur — nama field konsisten, error code terprediksi, dan pesan error yang dipisah melalui stderr — memastikan bahkan agen skrip sederhana dapat terintegrasi secara andal.

Kontrak exit code membuat penanganan error lebih jelas:

Automation Pipelines

Setelah Anda memahami perintah individual, PixVerse CLI membuka workflow multi-langkah yang kuat dan dapat berjalan tanpa interaksi pengguna.

Text to Image to Video

Salah satu pipeline paling berguna: hasilkan gambar resolusi tinggi dari text prompt, 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" --json

Full Video Production Pipeline

Untuk output yang lebih polished, rangkai proses pembuatan dengan langkah post-processing. create sound telah dihapus di v1.1.8, jadi gunakan --audio atau --no-audio pada perintah pembuatan yang mendukung, bukan menambahkan suara sebagai perintah terpisah:

# 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

Batch Generation

Untuk pipeline konten yang membutuhkan banyak variasi, jalankan job 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
done

Flag --no-wait mengirim job dan langsung mengembalikan task ID, sehingga Anda dapat submit beberapa job sebelum polling. Pada versi terbaru, --no-wait --json juga mengembalikan parameter pembuatan yang sudah diselesaikan, berguna untuk logging dan reproduksibilitas. Gunakan --count <n> saat Anda ingin beberapa variasi dari satu prompt, dan task status --ids saat ingin satu respons status untuk beberapa job yang berjalan. Perintah pixverse task wait menangani adaptive polling secara otomatis tanpa sleep loop manual.

Mengonfigurasi Defaults

Jika Anda konsisten menggunakan model, quality, atau aspect ratio yang sama, atur sebagai default agar 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 path

Flag command-line selalu mengesampingkan default yang dikonfigurasi, sehingga Anda tetap fleksibel sambil mengurangi pengulangan. Untuk otomatisasi khusus workspace, tambahkan --workspace-id <id> saat ingin mengganti workspace aktif hanya untuk satu run.

Apa yang Bisa Anda Bangun

Dengan PixVerse CLI yang terintegrasi ke workflow agen Anda, cakupan tugas yang dapat diotomatisasi meningkat secara signifikan:

• Dokumentasi — buat video demo produk dan screenshot secara otomatis sebagai bagian dari proses build dokumentasi
• Marketing — jalankan batch job malam hari untuk menghasilkan variasi konten media sosial dari satu pustaka prompt
• Pengembangan aplikasi — biarkan coding agent membuat placeholder visuals, mockup animations, atau loading screen videos saat Anda membangun UI
• Pipeline konten — rangkai panggilan CLI dengan tool lain (ffmpeg, ImageMagick, cloud storage) untuk membangun workflow produksi media sepenuhnya otomatis
• Prototyping — hasilkan konsep gerak cepat dalam hitungan detik untuk memvalidasi ide sebelum masuk produksi penuh

CLI ini dirancang agar menyatu secara alami dengan workflow berbasis shell apa pun. Jika otomatisasi Anda berjalan di bash, Python, Node, atau pipeline CI/CD, PixVerse CLI dapat masuk tanpa overhead integrasi tambahan.

Checklist Memulai

• Instal Node.js 20 atau lebih tinggi
• Jalankan npm install -g pixverse
• Jalankan pixverse auth login dan otorisasi di browser
• Jalankan pixverse account info untuk memverifikasi kredit
• Jalankan pixverse account slots sebelum batch concurrent
• Buat gambar pertama Anda: pixverse create image --prompt "..." --json
• Buat video pertama Anda: pixverse create video --prompt "..." --json
• Eksplor template dengan pixverse template list
• Instal PixVerse Skills untuk agen Anda (Claude Code, Cursor, atau Codex)
• Atur default yang Anda inginkan dengan pixverse config defaults set
• Bangun pipeline otomasi pertama Anda

Menjaga CLI Tetap Mutakhir

Gunakan npm untuk menjaga CLI lokal tetap diperbarui:

npm update -g pixverse

Untuk perubahan level rilis dan model baru yang didukung, lihat changelog resmi:

• PixVerse CLI Changelog

Per v1.1.9, perubahan terbaru mencakup GPT Image 2 sebagai model gambar default, dukungan v6 untuk create reference, dukungan 2160p untuk Seedream 5.0 Lite, reference campuran gambar dan video di Seedance 2.0, serta penghapusan perintah lama create sound.

Langkah Selanjutnya

PixVerse CLI di npm (npm install -g pixverse) memberi Anda akses langsung ke generasi konten, polling task, manajemen aset, template, folder tersimpan, cek akun, dan kontrol workspace dari satu antarmuka. Repositori PixVerse Skills menambahkan panduan siap-agen agar Claude Code, Cursor, Codex, dan tool lain dapat menjalankan workflow ini dengan reliabilitas lebih tinggi.

Kombinasi CLI yang andal dan pustaka skill yang siap untuk agen berarti pembuatan gambar dan video kini dapat berada dalam workflow yang sama dengan kode Anda — dikelola oleh agen yang sama, di terminal yang sama, tanpa berpindah tool.

Mulailah dari satu perintah. Kembangkan dari sana.