PixVerse CLI: Pembuatan Video dan Gambar AI untuk Developer

Pelajari cara menginstal PixVerse CLI, membuat gambar dan video AI pertama Anda, serta mengotomatisasi alur kerja kreatif di dalam Claude Code, Cursor, dan agen AI.

Product Update
PixVerse CLI: Pembuatan Video dan Gambar AI untuk Developer

Pengantar

Setiap alur kerja kreatif memiliki hambatan — saat Anda harus meninggalkan editor kode, membuka browser, dan mengklik antarmuka web secara manual untuk menghasilkan sebuah media. Bagi developer, agen AI, dan siapa pun yang membangun pipeline konten otomatis, pergantian konteks itu adalah gesekan yang cepat menumpuk.

PixVerse CLI menghilangkan hambatan tersebut. Ini adalah antarmuka baris perintah resmi untuk PixVerse, yang memberikan Anda akses ke setiap model, setiap fitur, dan setiap kemampuan dari platform PixVerse — langsung dari terminal Anda. Teks-ke-video, gambar-ke-video, teks-ke-gambar, sinkronisasi bibir, efek suara, peningkatan resolusi — semuanya dapat di-skrip, dapat di-pipe, dan tersedia tanpa menyentuh browser.

Yang membuat PixVerse CLI sangat kuat adalah filosofi desainnya: dibangun dengan agen AI sebagai prioritas. Setiap perintah menghasilkan JSON terstruktur, setiap kode keluar bersifat deterministik, dan setiap langkah pipeline dapat dikomposisikan. Ini berarti Anda dapat mengajarkan Claude Code, Cursor, Codex, atau agen lainnya untuk menghasilkan gambar dan video atas nama Anda — dan mereka akan melakukannya dengan benar, setiap saat.

Panduan ini memandu Anda melalui perjalanan lengkap: dari instalasi hingga generasi pertama Anda, lalu ke pipeline otomasi multi-langkah dan alur kerja yang dirancang untuk agen.

Prasyarat

Sebelum memulai, Anda memerlukan:

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

PixVerse CLI tidak memerlukan kunci API apa pun yang harus disalin secara manual. Autentikasi ditangani melalui alur OAuth berbasis browser yang menyimpan token Anda secara lokal.

Langkah 1: Instal CLI

Instal secara global dengan npm:

npm install -g pixverse

Verifikasi instalasi:

pixverse --version

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

npx pixverse create video --prompt "Seekor kucing berjalan di Mars"

Langkah 2: Autentikasi

Jalankan perintah login:

pixverse auth login

CLI akan mencetak URL singkat dan sebuah kode. Buka URL di browser Anda, masukkan kode tersebut, dan otorisasi dengan akun PixVerse Anda. 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

Perintah account info menampilkan tingkat langganan Anda, kredit yang tersisa, dan jadwal reset kredit harian. Selalu periksa saldo Anda sebelum menjalankan pekerjaan batch.

Langkah 3: Buat Gambar Pertama Anda

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

pixverse create image --prompt "Jalur hutan fotorealistis saat golden hour" --json

Flag --json mengembalikan output terstruktur:

{
  "image_id": 789012,
  "status": "completed",
  "image_url": "https://...",
  "prompt": "Jalur hutan fotorealistis saat golden hour",
  "model": "qwen-image",
  "width": 1024,
  "height": 1024
}

Untuk output resolusi lebih tinggi, tentukan model yang mendukungnya:

pixverse create image \
  --prompt "Jalur hutan fotorealistis saat 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 kekuatan yang berbeda:

ModelResolusi MaksTerbaik Untuk
qwen-image1080pPembuatan cepat, penggunaan umum
seedream-5.0-lite1800pGambar kreatif beresolusi tinggi
seedream-4.52160pResolusi ultra-tinggi
gemini-3.1-flash (Nano Banana 2)2160pRentang resolusi luas, cepat
gemini-3.0 (Nano Banana Pro)2160pKualitas tinggi dalam skala besar
gemini-2.5-flash (Nano Banana)1080pRingan, proses cepat

Untuk mengunduh gambar yang dihasilkan:

pixverse asset download 789012

Langkah 4: Buat Video Pertama Anda

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

pixverse create video --prompt "Matahari terbenam di atas ombak laut" --json

Untuk pembuatan yang sepenuhnya disesuaikan:

pixverse create video \
  --prompt "Pengambilan gambar drone sinematik di atas lembah pegunungan berkabut saat fajar" \
  --model v6 \
  --quality 1080p \
  --aspect-ratio 16:9 \
  --duration 8 \
  --audio \
  --json

Flag --audio mengaktifkan suara ambient yang dihasilkan AI yang sesuai dengan konten video Anda. Flag --json mengembalikan video_url setelah selesai yang dapat langsung Anda teruskan ke perintah unduh atau langkah berikutnya dalam pipeline.

PixVerse menyediakan beberapa model video dengan kemampuan berbeda:

ModelKualitas MaksRentang DurasiCatatan
v61080p1–15 detikAudio native, multi-shot bawaan, 20+ kontrol lensa sinematik
v5.61080p1–8 detikGenerasi sebelumnya; masih tersedia
veo-3.1-standard1080p4, 6, 8 detikMendukung mode Transisi
grok-imagine720p1–15 detikDurasi maksimum terpanjang
sora-2-pro1080p4, 8, 12 detikFidelitas tinggi dengan kepatuhan prompt yang presisi

Animasikan Gambar Statis

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

pixverse create video \
  --prompt "Angin lembut bertiup melalui pemandangan" \
  --image ./product-photo.jpg \
  --model v6 \
  --quality 1080p \
  --json

Anda dapat memberikan jalur file lokal atau URL. File lokal diunggah secara otomatis — tidak diperlukan langkah unggah manual.

Langkah 5: Jalankan Wizard Interaktif

Jika Anda baru menjelajahi dan belum familiar dengan semua flag yang tersedia, jalankan perintah pembuatan apa pun 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 langkah demi langkah — berguna untuk menemukan parameter apa yang tersedia sebelum membuat skrip.

Mengajarkan Agen AI Anda untuk Menghasilkan Media

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

Menginstal PixVerse Skills

PixVerse Skills adalah pustaka file skill terstruktur yang mengajarkan agen cara menggunakan CLI dengan tepat: flag apa yang diterima setiap perintah, model mana yang mendukung parameter mana, cara merangkai perintah menjadi pipeline, dan cara menangani kesalahan.

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

Pustaka skills kini menyertakan Mondo Poster Design (v1.1.0), skill khusus untuk menghasilkan poster film bergaya Mondo, sampul buku, dan sampul album. Skill ini dilengkapi 37 gaya seniman bawaan dalam 7 kategori — termasuk Saul Bass, Olly Moss, dan Kilian Eng — serta 8 teknik komposisi (ruang negatif, siluet, pembingkaian geometris) dan template genre untuk 9 genre film. Dua alur kerja ujung-ke-ujung disertakan: pembuatan poster statis dan video poster-ke-animasi memakai pipeline gambar-ke-video PixVerse. Instal dengan:

npx skills add https://github.com/pixverseai/skills --skill mondo-poster-design

Repositori juga menampilkan skills yang disumbang komunitas seperti character-pipeline dan shotpack, dibuat oleh developer independen dan tersedia di bagian Community Skills pada README. Kontributor dapat mengirimkan skill atau alur kerja baru melalui pull request.

Untuk Cursor, skills berada di skills/ dalam repositori GitHub PixVerse Skills dan dapat dimuat sebagai konteks langsung ke editor Anda. Untuk Codex dan agen berbasis LangChain, setiap file skill adalah markdown yang berdiri sendiri dan dapat disuntikkan ke dalam system prompt agen.

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

  • “Buat video demo produk berdurasi 10 detik dari tangkapan layar ini”
  • “Buat empat variasi gambar sampul blog ini dalam format 16:9”
  • “Animasikan diagram ini menjadi klip penjelasan 5 detik dengan suara ambient”
  • “Rancang poster film horor bergaya Mondo ala Olly Moss, lalu animasikan menjadi video pengungkapan selama 5 detik”

Agen akan menerjemahkan instruksi tersebut menjadi perintah CLI yang tepat, mengurai output JSON, dan menangani polling serta unduhan — tidak diperlukan intervensi manual.

Claude Code

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

Buat gambar sampul untuk posting blog tentang machine learning ini,
gunakan model seedream-5.0-lite pada resolusi 1800p dalam format 16:9,
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 — semua dalam sesi yang sama di mana ia juga menulis kode Anda.

Alur kerja Claude Code yang umum:

# Claude Code menjalankan ini secara otonom berdasarkan instruksi Anda
IMG=$(pixverse create image \
  --prompt "Visualisasi abstrak lapisan jaringan neural, latar belakang gelap, nada biru dan ungu" \
  --model seedream-5.0-lite \
  --quality 1800p \
  --aspect-ratio 16:9 \
  --json | jq -r '.image_url')
 
# Kemudian menganimasikannya
pixverse create video \
  --prompt "Pan lambat melintasi koneksi neural yang bersinar" \
  --image "$IMG" \
  --model v6 \
  --quality 1080p \
  --duration 6 \
  --json

Cursor

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

Alur kerja Cursor yang umum: minta agen untuk menghasilkan gambar mockup berdasarkan desain yang sedang Anda bangun, lalu gunakan sebagai referensi langsung di sesi IDE Anda — tanpa pernah meninggalkan 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 kesalahan yang dapat diprediksi, dan pesan kesalahan yang dipisahkan melalui stderr — memastikan bahwa bahkan agen skrip sederhana pun dapat mengintegrasikan pembuatan secara andal.

Kontrak kode keluar membuat penanganan kesalahan menjadi mudah:

KodeArtiTindakan Agen
0BerhasilUrai output JSON
2Waktu habisCoba ulang dengan --timeout lebih lama
3Autentikasi kedaluwarsaJalankan ulang pixverse auth login
4Kredit habisPeriksa saldo, beri tahu pengguna
5Pembuatan gagalCoba parameter berbeda
6Kesalahan validasiTinjau nilai flag

Pipeline Otomasi

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

Teks ke Gambar ke Video

Salah satu pipeline paling berguna: buat gambar beresolusi tinggi dari prompt teks, lalu animasikan menjadi video.

# Langkah 1: Buat gambar dasar
IMG_RESULT=$(pixverse create image \
  --prompt "Pemandangan kota cyberpunk di malam hari, lampu neon memantul di trotoar basah" \
  --model gemini-3.1-flash \
  --quality 2160p \
  --aspect-ratio 16:9 \
  --json)
 
IMAGE_URL=$(echo "$IMG_RESULT" | jq -r '.image_url')
 
# Langkah 2: Animasikan menjadi video
VID_RESULT=$(pixverse create video \
  --prompt "Kamera perlahan-lahan bergerak melintasi jalanan berlampukan neon" \
  --image "$IMAGE_URL" \
  --model v6 \
  --quality 1080p \
  --duration 8 \
  --json)
 
VIDEO_ID=$(echo "$VID_RESULT" | jq -r '.video_id')
 
# Langkah 3: Unduh video final
pixverse asset download "$VIDEO_ID" --json

Pipeline Produksi Video Lengkap

Untuk output yang lebih halus, rangkai pembuatan dengan langkah-langkah pasca-pemrosesan:

# Langkah 1: Buat video dasar
RESULT=$(pixverse create video \
  --prompt "Sebuah produk sedang dirakit dalam gerakan lambat" \
  --model v6 \
  --quality 720p \
  --duration 5 \
  --json)
 
VID=$(echo "$RESULT" | jq -r '.video_id')
 
# Langkah 2: Perpanjang durasi
EXTENDED=$(pixverse create extend \
  --video "$VID" \
  --prompt "Lanjutkan urutan perakitan" \
  --duration 5 \
  --json | jq -r '.video_id')
 
pixverse task wait "$EXTENDED" --json
 
# Langkah 3: Tambahkan suara ambient
WITH_SOUND=$(pixverse create sound \
  --video "$EXTENDED" \
  --prompt "Suasana bengkel industri, suara mekanik lembut" \
  --json | jq -r '.video_id')
 
pixverse task wait "$WITH_SOUND" --json
 
# Langkah 4: Tingkatkan resolusi ke 1080p
FINAL=$(pixverse create upscale \
  --video "$WITH_SOUND" \
  --quality 1080p \
  --json | jq -r '.video_id')
 
pixverse task wait "$FINAL" --json
 
# Langkah 5: Unduh
pixverse asset download "$FINAL" --json

Pembuatan Batch

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

# Periksa kredit terlebih dahulu
CREDITS=$(pixverse account info --json | jq -r '.credits.total')
echo "Kredit tersedia: $CREDITS"
 
# Kirim empat pembuatan paralel
pixverse create video --prompt "Matahari terbit di atas pegunungan" --no-wait --json > /tmp/v1.json &
pixverse create video --prompt "Matahari terbenam di atas laut" --no-wait --json > /tmp/v2.json &
pixverse create video --prompt "Bintang di atas gurun" --no-wait --json > /tmp/v3.json &
pixverse create video --prompt "Aurora di atas danau beku" --no-wait --json > /tmp/v4.json &
wait
 
# Tunggu masing-masing dan unduh
for f in /tmp/v1.json /tmp/v2.json /tmp/v3.json /tmp/v4.json; do
  ID=$(jq -r '.video_id' "$f")
  pixverse task wait "$ID" --json
  pixverse asset download "$ID" --json
done

Flag --no-wait mengirimkan pekerjaan dan langsung kembali dengan ID tugas, memungkinkan Anda mengirimkan beberapa pekerjaan sebelum melakukan polling. Perintah pixverse task wait menangani polling adaptif untuk Anda — tidak diperlukan loop sleep manual.

Mengonfigurasi Default

Jika Anda secara konsisten menggunakan model, kualitas, atau rasio aspek yang sama, atur sebagai default agar Anda tidak perlu mengulangi flag setiap saat:

pixverse config defaults set --mode video --model v6 --quality 1080p --aspect-ratio 16:9
pixverse config defaults set --mode image --model seedream-5.0-lite --quality 1800p
pixverse config set output-dir ~/Downloads/pixverse

Flag baris perintah selalu menggantikan default yang dikonfigurasi, sehingga Anda tetap memiliki fleksibilitas penuh sambil mengurangi pengulangan.

Apa yang Dapat Anda Bangun

Dengan PixVerse CLI yang terintegrasi ke dalam alur kerja agen Anda, rentang tugas yang dapat diotomatisasi meluas secara signifikan:

  • Dokumentasi — buat video demo produk dan tangkapan layar secara otomatis sebagai bagian dari proses build dokumentasi Anda
  • Pemasaran — jalankan pekerjaan batch setiap malam yang menghasilkan variasi konten media sosial dari satu pustaka prompt
  • Pengembangan aplikasi — biarkan agen pengkodean Anda menghasilkan visual placeholder, animasi mockup, atau video layar pemuatan saat Anda membangun UI
  • Pipeline konten — rangkai panggilan CLI dengan alat lain (ffmpeg, ImageMagick, penyimpanan cloud) untuk membangun alur kerja produksi media yang sepenuhnya otomatis
  • Pembuatan prototipe — buat konsep gerak cepat dalam hitungan detik untuk memvalidasi ide sebelum berkomitmen pada produksi penuh
  • Poster dan seni sampul — gunakan skill Mondo Poster Design untuk menghasilkan poster film bergaya, sampul buku, atau seni album dengan estetika spesifik seniman, lalu animasikan menjadi video pengungkapan dengan satu alur kerja

CLI ini dirancang untuk menyesuaikan diri secara alami dengan alur kerja berbasis shell apa pun. Jika otomasi yang sudah ada berjalan di bash, Python, Node, atau pipeline CI/CD, PixVerse CLI dapat diintegrasikan tanpa overhead tambahan.

Daftar Periksa 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

Repositori skills kini menyertakan manajemen versi bawaan. File VERSION dan CHANGELOG.md melacak setiap rilis; skrip check-update.sh yang disertakan memungkinkan Anda memeriksa apakah versi lebih baru tersedia tanpa meninggalkan terminal. Untuk memperbarui CLI itu sendiri:

npm update -g pixverse

Langkah Selanjutnya

PixVerse CLI di npm (npm install -g pixverse) memberi Anda akses langsung ke semua kemampuan pembuatan. Repositori PixVerse Skills menyediakan file skill terstruktur yang mengajarkan agen AI Anda cara menggunakan kemampuan tersebut dengan benar dalam konteks apa pun — termasuk skill baru Mondo Poster Design, alur kerja yang disumbang komunitas seperti character-pipeline dan shotpack, serta direktori references/ yang terus berkembang berisi konten basis pengetahuan untuk penggunaan lanjutan.

Kombinasi CLI yang andal dan pustaka skill yang siap untuk agen berarti pembuatan gambar dan video kini dapat berada di dalam alur kerja yang sama dengan kode Anda — dikelola oleh agen yang sama, di terminal yang sama, tanpa berpindah alat. Repositori terbuka untuk kontribusi: jika Anda membangun skill atau alur kerja yang bermanfaat, Anda dapat mengirimkannya langsung melalui pull request.

Mulailah dengan satu perintah. Bangun dari sana.