PixVerse CLI: Terminalden Yapay Zeka Video, Görsel, Ses ve Müzik Oluşturun

2026-10-13 tarihinde doğrulandı: Node.js >=22.12 gereklidir. Varsayılan görsel modeli GPT Image 2.5 Flare, video modeli PixVerse V6’dır. Model ve ayarlar üretim moduna göre değişir. Üretimden önce kurulu capabilities ve resmi README’yi kontrol edin. README · capabilities.json

pixverse --version
pixverse capabilities create --json
pixverse canvas --help

Giriş

Tarayıcı tabanlı oluşturma arayüzleri keşif ve tek seferlik projeler için iyi çalışır. Ancak birkaç senaryo farklı bir yaklaşım gerektirir:

PixVerse CLI, yapay zeka video, görsel, ses ve müzik oluşturmayı doğrudan terminal tabanlı iş akışlarına taşır. Bir tarayıcı arayüzü ile geliştirme ortamınız arasında gidip gelmek yerine, kod yazdığınız, build çalıştırdığınız ve dağıtımları yönettiğiniz aynı komut satırından yapay zeka içeriği oluşturabilir, yönetebilir ve indirebilirsiniz. PixVerse CLI

PixVerse CLI tam olarak bu liste etrafında inşa edilmiştir ve özellikle agent odaklı kullanım durumuna ağırlık verir: komutlar yapılandırılmış JSON döndürür, çıkış kodları öngörülebilirdir ve her adım, bir arayüze tıklayan bir insan yerine bir betik veya özerk bir agent tarafından birleştirilecek şekilde tasarlanmıştır.

Ön koşullar

Başlamadan önce şunlara ihtiyacınız var:

Node.js 22.12 veya üzeri —— node --version ile kontrol edin
Bir PixVerse hesabı —— pixverse.ai üzerinden kaydolun
Aktif bir PixVerse aboneliği —— CLI, web sitesiyle aynı kredi sistemini kullanır, bu nedenle içerik oluşturmak için abone bir hesap gerekir

Manuel olarak kopyalayıp yapıştıracağınız bir API anahtarı yoktur. Kimlik doğrulama, jetonunuzu yerel olarak saklayan tarayıcı tabanlı bir akış üzerinden yapılır.

Kurulum

CLI’yi npm ile global olarak yükleyin:

npm install -g pixverse

Kurulumun doğru şekilde tamamlandığını doğrulayın:

pixverse --version

Global olarak hiçbir şey yüklemek istemiyorsanız, npx ile komutları ihtiyaç anında da çalıştırabilirsiniz:

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

Kimlik doğrulama

Şununla giriş yapın:

pixverse auth login

Bu, OAuth yetkilendirmesi için bir tarayıcı penceresi açar. SSH üzerinden çalışıyorsanız veya arayüzsüz bir makinedeyseniz, giriş akışı ayrıca yetkilendirmeyi tamamlamak için başka bir cihazdaki tarayıcıya yapıştırabileceğiniz bir URL de verir. Yetkilendirildikten sonra jetonunuz ~/.pixverse/ içine kaydedilir ve 30 gün boyunca geçerli kalır.

Giriş durumunuzu ve kullanılabilir kredilerinizi kontrol edin:

pixverse auth status
pixverse account info
pixverse account slots
pixverse capabilities canvas --json

account info abonelik seviyenizi ve çalışma alanı kredilerinizi gösterir. account usage bu kredilerin nasıl harcandığını ayrıntılandırır, account slots ise kaç üretimi eşzamanlı olarak çalıştırabileceğinizi belirtir —— toplu bir işe başlamadan önce kontrol etmeye değer. CLI oturumları tarayıcı veya uygulama oturumunuzla durum paylaşmaz, bu yüzden CLI’den çıkış yapmak (pixverse auth logout) diğer oturumlarınızı etkilemez.

Hızlı başlangıç

Kurulumdan bitmiş bir varlığa mümkün olduğunca hızlı geçmek istiyorsanız, bu sıra sizi oraya götürür:

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

Betikler ve agent’lar için, standart çıktının temiz ve ayrıştırılabilir kalması, ilerleme mesajları ve hataların ise stderr’e gitmesi için --json’ı (veya kısaltması -p’yi) açık tutun. Bir iş birden fazla kez gönderilme riski taşıyorsa — dengesiz bir ağ, tekrarlanan bir CI adımı — yanlışlıkla tekrarlanan ücretli işler oluşturmamak için --idempotency-key <key> ekleyin.

Görsel oluşturma

Metinden görsele, her şeyin çalıştığını doğrulamanın en hızlı yoludur:

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

Mevcut varsayılan görsel modeli GPT Image 2.5 Flare’dir, ancak tekrar tekrar çalıştırmayı planladığınız her şey için varsayılana güvenmek yerine --model’i açıkça belirleyin —— yeni modeller çıktıkça varsayılanlar değişir. --json, doğrudan bir sonraki adıma aktarabileceğiniz bir yanıt verir:

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

Daha yüksek çözünürlükler için, bunu destekleyen bir modele yönelin:

pixverse create image \
  --prompt "A photorealistic forest path at golden hour" \
  --model seedream-5.0-lite \
  --quality 2160p \
  --aspect-ratio 16:9 \
  --json

Görsel modeli yelpazesi çeşitli farklı kullanım durumlarını kapsar:

pixverse capabilities create image --json
pixverse capabilities create image --model gpt-image-2.5-flare --json

Mevcut bir görseli de geri besleyip dönüştürebilirsiniz:

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

Ardından dosyayı yerel olarak indirin:

pixverse asset download 789012 --type image

Video oluşturma

Metinden videoya aynı şemayı takip eder. Hızlı bir 5 saniyelik klip:

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

Veya tam olarak belirtilmiş bir üretim:

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

Yerel ses üretimini destekleyen modellerde: --audio, sahneye uyan yapay zeka tarafından üretilmiş ortam sesi ekler. Tamamlandığında, JSON yanıtı bir indirme adımına veya bir hattın sonraki aşamasına doğrudan aktarabileceğiniz bir video_url içerir.

Video modelleri çözünürlük tavanı, süre aralığı ve desteklenen oluşturma modları açısından büyük ölçüde farklılık gösterir:

pixverse capabilities create video --json
pixverse capabilities create reference --model seedance-2.5 --json

Seedance, Kling, Veo, Sora, Gemini Omni, Grok Imagine ve HappyHorse gibi ortak modeller de PixVerse üzerinde kullanılabilir. Aynı CLI ile PixVerse V6 ve C1 karşısında değerlendirin.

Statik bir görseli canlandırma

Bir fotoğrafı veya üretilmiş bir görseli harekete dönüştürmek için --image geçin:

pixverse create video \
  --prompt "Gentle wind moves through the scene" \
  --image ./product-photo.jpg \
  --model v6 \
  --quality 1080p \
  --json

--image’ı yerel bir dosya yoluna veya uzak bir URL’ye işaret ettirebilirsiniz —— yerel dosyalar otomatik olarak yüklenir, ayrı bir yükleme adımı gerekmez. 1920×1920 veya 5MB’den büyük her şey, yüklemeden önce otomatik olarak yeniden boyutlandırılır veya sıkıştırılır; uzak URL’ler backend tarafından oldukları gibi doğrulanır.

Grok Imagine 1.5 özel bir durumdur: --image gerektirir ve çıktı en-boy oranını kaynak görselin kullandığı orana kilitler:

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

Referans, geçişler, hareket kontrolü ve şablonlar

Basit metinden videoya ve görselden videoya ek olarak, CLI karakterler, anahtar kareler veya efektler üzerinde daha ince kontrole ihtiyaç duyduğunuzda kullanışlı olan birkaç daha özel oluşturma modu sunar:

# 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 to 2160p
pixverse create upscale --video <video_id> --quality 2160p

# 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

Ses ve müzik oluşturma

Bağımsız ses üretimi iki özel komutun arkasında yaşar: metinden konuşmaya için create voice ve prompt odaklı müzik için create music. İkisi de çıktısını ses varlıkları olarak kaydeder, böylece task ile takip edebilir, asset list --type audio ile listeleyebilir ve asset download ile indirebilirsiniz. Sadece bir videoya gömülü ortam sesi istiyorsanız, desteklenen bir video oluşturma komutunda --audio / --no-audio kullanın —— bu, bu bağımsız ses komutlarından ayrı bir yoldur.

Bir ses klibi üretin:

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

Bir modele karar vermeden önce mevcut ses modellerini ve hazır ayarlanmış sesleri listeleyin:

pixverse voice models --json
pixverse voice presets --model speech-2.8-hd --json

Bir müzik parçası üretin:

pixverse create music \
  --prompt "A bright cinematic synth-pop track for a 30-second product reveal" \
  --auto-lyrics \
  --duration-seconds 30 \
  --json

Vokalsiz bir parça için --instrumental ekleyin. Şarkı sözleri istediğinizde, --lyrics gerçek metni, yerel bir dosya yolunu veya boru üzerinden standart girdiyi kabul eder:

pixverse create music \
  --prompt "Uplifting electronic pop with a confident chorus" \
  --lyrics ./lyrics.txt \
  --json

Mevcut ses seçenekleri MiniMax Speech 2.8 ve ElevenLabs ailelerini kapsar, müzik üretimi ise şu anda MiniMax Music, ElevenLabs Music ve Google Lyria 3 Pro’dan gelir. Bu ürün yelpazeleri zamanla değiştiği için, yeniden kullanmayı planladığınız bir betik yazmadan önce nelerin mevcut olduğunu görmek için pixverse voice models ve pixverse music models çalıştırın.

Etkileşimli sihirbaz

Hangi bayrakların mevcut olduğunu hâlâ öğreniyorsanız, hiç argüman vermeden bir oluşturma komutu çalıştırın:

pixverse create video
pixverse create image

Bu sizi prompt, model, kalite, en-boy oranı, süre ve diğer ilgili seçenekleri adım adım gezdiren rehberli bir sihirbaza götürür —— bir betiğe sabitlemeden önce bayrakları keşfetmek için iyi bir yol.

Varlıkları ve çalışma alanınızı yönetme

Üretim, resmin sadece bir parçasıdır. CLI ayrıca onun etrafındaki her şey için yönetim komutları içerir:

Tek bir işi yoklamak için pixverse task status <id> ve pixverse task wait <id>
Birden fazla işi tek bir çağrıda kontrol etmek için pixverse task status --ids 123,456,789 --type video --json
Video, görsel ve ses varlıklarının tüm yaşam döngüsü işlemleri için pixverse asset list, asset upload, asset info, asset download ve asset delete
Kaydedilmiş klasörler için pixverse saved list, saved items, saved new, saved rename, saved add, saved remove ve saved delete
Efektleri ve şablonları keşfetmek için pixverse template categories, template list, template search ve template info
Canlı ses modeli keşfi için pixverse voice models, voice presets ve music models
Çoklu çalışma alanı kurulumları için pixverse workspace list, workspace status, workspace switch ve workspace manage
Kredi, kullanım ve eşzamanlılık kontrolleri için pixverse account info, account usage ve account slots
Tekrarlanabilir yerel ayarlar için pixverse config set, config list, config path ve config defaults

Birlikte, bunlar tek bir betiğin terminalden ayrılmadan oluşturma, düzenleme, şablon keşfi, indirme ve çalışma alanı yönlendirmesiyle ilgilenmesini sağlar. Belirli bir komut için varsayılan olmayan bir çalışma alanını hedeflemek üzere --workspace-id <id> ekleyin (kişisel çalışma alanınız için 0 kullanın).

Canvas projeleri ve güncel model desteği

CLI artık Canvas projeleri, grafikler, düğümler, yamalar ve görev başlatma akışlarını içeriyor. Otomasyondan önce pixverse canvas --help ve pixverse capabilities canvas --json komutlarını inceleyin. Canvas yetenekleri oturum açıldıktan sonra hizmetten alınır; üretim yetenekleri kurulu CLI’yi tanımlar. Bir model eksikse CLI’yi güncelleyin.

Güncel katalog Seedance 2.5, MiniMax H3/H3 Max, FLUX 3, Wan 3.0, Kling 4K, GPT Image 2.5 Flare/Sunburst ve Nano Banana 2.1 içerir. Başka bir modelin süre, ses, referans veya çözünürlük ayarlarını kullanmak yerine seçtiğiniz modelin ve modun yeteneklerini sorgulayın.

Betikler için bilinmesi gereken bayraklar

Otomasyon yaparken öngörülebilir çıktı her şeyden daha önemlidir. Bu bayraklar betiklerde ve agent iş akışlarında sürekli karşınıza çıkar:

Bayrak	Ne için kullanılır
`--json`	Yapılandırılmış JSON çıktısı döndürür
`-p`	`--json` için kısa takma ad
`--count <n>`	Tek bir istekten 1–4 varyasyon üretir
`--seed <number>`	Bir üretimi tekrarlamayı kolaylaştırır
`--off-peak`	Mevcut olduğunda düşük yoğunluk saatleri fiyatlandırmasını kullanır
`--audio` / `--no-audio`	Desteklenen video oluşturma komutlarında sesi açar veya kapatır
`--multi-shot` / `--no-multi-shot`	Video için çoklu çekim modunu açar veya kapatır
`--no-wait`	İşi gönderir ve bloke etmeden hemen döner
`--timeout <sec>`	Yoklama zaman aşımını ayarlar (varsayılan 300 saniye)
`--workspace-id <id>`	Tek bir komut için aktif çalışma alanını geçersiz kılar
`--trace-id <uuid>`	Hata ayıklama için çağıran tarafından sağlanan bir UUIDv4’ü isteğe ekler
`--idempotency-key <key>`	Bir oluşturma isteğini yinelenen ücretlendirme olmadan güvenle yeniden dener

Metin girişi bayrakları artık satır içi dizelerden daha fazlasını kabul ediyor. --prompt, --text ve --lyrics’in hepsi gerçek bir dizeyi, yerel bir dosya yolunu veya stdin’den okumak için -’ı kabul eder:

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

Yapay zeka agent’ınıza medya üretmeyi öğretme

Komut satırı otomasyonundan önce uygulamada agent destekli üretimi denemek için PixVerse Agent ile başlayın.

CLI’nin bir kolaylık olmaktan çıkıp bir yetenek çarpanı olmaya başladığı yer burasıdır. Her komut yapılandırılmış JSON döndürdüğü ve deterministik bir kodla çıktığı için, shell komutları çalıştırabilen herhangi bir agent’a sizin adınıza görsel, video, ses ve müzik üretmesi öğretilebilir.

PixVerse Skills’i yükleme

PixVerse Skills, agent’a yardım metninden tahmin ettirmek yerine, CLI’nin bayraklarını, model kısıtlamalarını, çok adımlı hatları ve hata işleme kalıplarını öğretmek için özel olarak oluşturulmuş bir beceri kitaplığıdır.

Claude Code ve skills formatını destekleyen diğer araçlar için:

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

Yüklendikten sonra, bir agent, davranışı deneme yanılma yoluyla çıkarmak yerine üzerinde çalışabileceği açık kısıtlamalara sahip olur —— bu, Cursor, Claude Code, Codex ve benzeri çerçevelerde güvenilirlik için çok önemlidir.

PixVerse Skills yüklendiğinde, bir agent’a şöyle doğal dil talimatları verebilirsiniz:

“Bu ekran görüntüsünden 10 saniyelik bir ürün demo videosu oluştur”
“Bu blog kapak görselinin 16:9 formatında dört varyasyonunu oluştur”
“Bu diyagramı ortam sesiyle 5 saniyelik bir açıklama klibine dönüştür”
“Farklı kamera hareketleriyle üç adet 8 saniyelik 16:9 tanıtım klibi oluştur”

Agent bunu doğru CLI çağrılarına çevirir, JSON yanıtlarını ayrıştırır, yoklamayı yönetir ve sonucu indirir —— arada herhangi bir manuel adım olmadan.

Claude Code

Claude Code içinde, CLI agent’ın kendi başına başvurduğu bir araç haline gelir. PixVerse Skills yüklendikten sonra, medya üretimini herhangi bir göreve dahil edebilirsiniz:

Makine öğrenimi hakkındaki bu blog yazısı için seedream-5.0-lite ile 2160p ve 16:9 kapak görseli oluşturup ./assets/cover.webp konumuna indirin.

Claude Code doğru komutları çalıştıracak, JSON’dan görsel URL’sini çıkaracak ve dosyayı belirttiğiniz yola kaydedecektir —— tüm bunlar aynı zamanda kodunuzu da düzenlediği aynı oturum içinde gerçekleşir.

Temsili bir iş akışı:

# 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

Cursor kullanıcıları ilgili PixVerse Skills dosyalarını .cursor/ dizinine veya çalışma alanı kurallarına ekleyebilir. Yüklendikten sonra bu kılavuzlar kodlama sırasında medya üretimine yardımcı olur.

Örneğin Cursor’dan tasarımınız için bir mockup görseli isteyip aynı editör oturumunda doğrudan referans olarak kullanabilirsiniz.

Codex ve diğer agent’lar

Shell komutları çalıştırabilen ve JSON ayrıştırabilen herhangi bir agent bu CLI’yi kullanabilir. Tutarlı alan adları, öngörülebilir hata kodları ve stderr’de ayrı tutulan hata mesajları, basit bir betikleme agent’ının bile özel işleme gerektirmeden üretimi entegre edebileceği anlamına gelir.

Çıkış kodları bir agent’a net bir karar ağacı verir:

Kod	Anlam	Agent Eylemi
0	Başarılı	JSON çıktısını ayrıştır
1	Genel hata	stderr’i kontrol et ve doğrulanmış girdilerle yeniden dene
2	Zaman aşımı	Daha uzun bir `--timeout` ile yeniden dene
3	Kimlik doğrulama süresi doldu	`pixverse auth login`’i yeniden çalıştır
4	Kredi yetersiz	Bakiyeyi kontrol et, kullanıcıyı bilgilendir
5	Üretim başarısız oldu	Farklı parametreler dene
6	Doğrulama hatası	Bayrak değerlerini gözden geçir
7	Eşzamanlılık sınırı	Boş bir yuva bekleyip yeniden deneyin

Otomasyon hatları

Tek tek komutlarla rahatlaştıktan sonra, gerçek değer kimse izlemiyorken çalışan çok adımlı hatlarda ortaya çıkar.

Metinden görsele, görselden videoya

Bir prompt’tan yüksek çözünürlüklü bir görsel üretin, ardından onu canlandırın:

# 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

Tam video üretim hattı

Daha cilalı bir sonuç için, üretimi son işlemeyle zincirleyin. Desteklenen bir video modelinin doğal sesi yeterli olduğunda --audio veya --no-audio kullanın ve daha sonra birleştirmek için ayrı bir ses varlığına ihtiyacınız olduğunda create voice veya create music’e başvurun:

# 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 2160p
FINAL=$(pixverse create upscale \
  --video "$EXTENDED" \
  --quality 2160p \
  --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

Toplu üretim

Aynı anda birden fazla varyasyona ihtiyaç duyan içerik hatları için, işleri birer birer yerine eşzamanlı olarak çalıştırın:

# 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

--no-wait, bir işi gönderir ve hemen bir görev kimliği döndürür, bu da herhangi birini yoklamaya başlamadan önce birden fazla işi kuyruğa almanıza olanak tanır. Her --no-wait --json yanıtından görev kimliklerini ve çözülmüş parametreleri kaydedin —— bu kayıt, bir toplu çalışmayı daha sonra tekrarlanabilir kılan şeydir. Tek bir prompt’tan birden fazla varyasyon istediğinizde --count <n> kullanın ve her birini ayrı ayrı yoklamak yerine birden fazla çalışan işi kapsayan tek bir durum yanıtı tercih ettiğinizde toplu task status --ids’e güvenin. pixverse task wait, uyarlanabilir yoklamayı sizin için halleder.

Varsayılanları yapılandırma

Her çağrıda aynı modeli, kaliteyi veya en-boy oranını tekrarladığınızı fark ederseniz, bunları bir kez ayarlayın:

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

Komut satırındaki bayraklar her zaman yapılandırılmış varsayılanlara göre öncelikli olduğundan, varsayılanları ayarlamak size hiçbir esneklik kaybettirmez. Varsayılan olmayan bir çalışma alanına karşı tek seferlik bir çalıştırma için, olağan varsayılanlarınızın üzerine --workspace-id <id> ekleyin.

Ne inşa edebilirsiniz

CLI’yi bir agent’a veya betiğe bağlamak, otomatikleştirilebilir görevlerin yelpazesini oldukça genişletir:

Dokümantasyon —— doküman derleme sürecinizin bir parçası olarak ürün demo videoları ve ekran görüntüleri otomatik olarak oluşturmak
Pazarlama —— tek bir prompt kütüphanesinden sosyal içerik varyasyonları üreten gece boyu toplu işler çalıştırmak
Uygulama geliştirme —— gerçek arayüzü inşa ederken bir kodlama agent’ının yer tutucu görseller, maket animasyonları veya yükleme ekranı videoları üretmesine izin vermek
Ses iş akışları —— seslendirme taslakları, prompt’tan müziğe parçalar veya sonraki düzenleme için bağımsız ses varlıkları üretmek
İçerik hatları —— tamamen otomatikleştirilmiş bir üretim hattı oluşturmak için CLI çağrılarını ffmpeg, ImageMagick veya bulut depolama araçlarıyla zincirlemek
Prototipleme —— tam üretime geçmeden önce fikirleri doğrulamak için saniyeler içinde hızlı hareket konseptleri üretmek

Sadece shell komutları olduğundan, CLI özel bir entegrasyon çabası olmadan bash, Python, Node veya CI/CD’ye uyar.

Başlangıç kontrol listesi

CLI’yi güncel tutma

Yerel CLI’nizi güncel tutmak için yerleşik güncelleyiciyi kullanın:

pixverse update

Ayrıca doğrudan npm üzerinden de güncelleyebilirsiniz:

npm install -g pixverse@latest

Modeller ve bayraklar çoğu dokümantasyondan daha hızlı değişir, bu yüzden sürüm düzeyindeki değişiklikler için doğrudan birincil kaynakları kontrol edin:

Bu güncelleme itibarıyla, PixVerse V6 varsayılan video modeli, GPT Image 2.5 Flare ise varsayılan görsel modeli olmaya devam ediyor; Seedance 2.0 Mini, özel create voice/create music komutları, ses varlığı yönetimi, kaydedilmiş klasörler, çalışma alanı değiştirme, config defaults, capabilities.json manifestosu, pixverse update, metin girdileri için stdin desteği, --trace-id ve --idempotency-key’in hepsi mevcut araç setinin parçası. PixVerse CLI

CLI’nin mümkün kıldığı şeyler

PixVerse CLI, GitHub ve npm (npm install -g pixverse) üretim, görev sorgulama, varlık, şablon, ses, müzik ve çalışma alanı yönetimi sunar. PixVerse Skills agent kılavuzlarını sağlar.

CLI ve agent becerileri sayesinde görsel, video, konuşma ve müzik aynı agent ve terminalde yönetilerek kod iş akışınıza katılır.

Tek bir komutla başlayıp iş akışını adım adım geliştirin.

İlgili kaynaklar

→ PixVerse CLI ile Başlayın