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 semua model, fitur, dan kapabilitas dari platform PixVerse langsung dari terminal. Text-to-video, image-to-video, text-to-image, lip-sync speech, sound effects, upscaling — 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 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

Perintah account info menampilkan level langganan Anda, sisa kredit, dan jadwal reset kredit harian. Selalu cek saldo 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

Flag --json mengembalikan output terstruktur:

{
  "image_id": 789012,
  "status": "completed",
  "image_url": "https://...",
  "prompt": "A photorealistic forest path at golden hour",
  "model": "qwen-image",
  "width": 1024,
  "height": 1024
}

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 1800p \
  --aspect-ratio 16:9 \
  --json

PixVerse mendukung beberapa model gambar, masing-masing dengan batas resolusi dan keunggulan berbeda:

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 kapabilitas 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.

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 asset list|upload|info|download|delete untuk operasi siklus hidup aset
• pixverse saved list|items|new|rename|add|remove|delete untuk folder tersimpan
• pixverse workspace list|status|switch|manage untuk operasi multi-workspace

Ini memudahkan otomatisasi bukan hanya pembuatan, tetapi juga pengorganisasian, pengunduhan, dan distribusi dalam satu skrip.

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 1800p 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 1800p \
  --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:

# Step 1: Create the base video
RESULT=$(pixverse create video \
  --prompt "A product being assembled in slow motion" \
  --model v6 \
  --quality 720p \
  --duration 5 \
  --json)
 
VID=$(echo "$RESULT" | jq -r '.video_id')
 
# Step 2: Extend duration
EXTENDED=$(pixverse create extend \
  --video "$VID" \
  --prompt "Continue the assembly sequence" \
  --duration 5 \
  --json | jq -r '.video_id')
 
pixverse task wait "$EXTENDED" --json
 
# Step 3: Add ambient sound
WITH_SOUND=$(pixverse create sound \
  --video "$EXTENDED" \
  --prompt "Industrial workshop ambience, soft mechanical sounds" \
  --json | jq -r '.video_id')
 
pixverse task wait "$WITH_SOUND" --json
 
# Step 4: Upscale to 1080p
FINAL=$(pixverse create upscale \
  --video "$WITH_SOUND" \
  --quality 1080p \
  --json | jq -r '.video_id')
 
pixverse task wait "$FINAL" --json
 
# Step 5: Download
pixverse asset download "$FINAL" --json

Batch Generation

Untuk pipeline konten yang membutuhkan banyak variasi, jalankan job secara paralel:

# Check credits first
CREDITS=$(pixverse account info --json | jq -r '.credits.total')
echo "Available credits: $CREDITS"
 
# 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
 
# 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. 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

Flag command-line selalu mengesampingkan default yang dikonfigurasi, sehingga Anda tetap fleksibel sambil mengurangi pengulangan.

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
• Buat gambar pertama Anda: pixverse create image --prompt "..." --json
• Buat video pertama Anda: pixverse create video --prompt "..." --json
• 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

Langkah Selanjutnya

PixVerse CLI di npm (npm install -g pixverse) memberi Anda akses langsung ke generasi konten, polling task, manajemen aset, folder tersimpan, 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.