PixVerse CLI: terminalde AI video ve görsel üretin

PixVerse CLI kurarak terminalde AI video, görsel, ses ve müzik üretin; JSON çıktısıyla ajan iş akışlarını otomatikleştirin.

Product Update • 29 Haziran 2026

PixVerse CLI: terminalde AI video ve görsel üretin

Giriş

Her yaratıcı iş akışında bir darboğaz vardır; kod düzenleyicinizden ayrılmanız, bir tarayıcı açmanız ve bir medya parçası oluşturmak için manuel olarak bir web arayüzüne tıklamanız gerektiği an. Geliştiriciler, yapay zeka aracıları ve otomatik içerik hatları oluşturan herkes için bu bağlam değişikliği, hızla artan bir anlaşmazlıktır.

PixVerse CLIbu darboğazı ortadan kaldırır. PixVerse’nin resmi komut satırı arayüzüdür ve PixVerse oluşturma ve çalışma alanı iş akışlarına doğrudan terminalinizden erişmenizi sağlar. Metinden videoya, görüntüden videoya, metinden görüntüye, görüntüden görüntüye, geçişler, ses oluşturma, müzik oluşturma, referans video, hareket kontrolü, şablonlar, yükseltme ve varlık yönetiminin tümü komut dosyasıyla yazılabilir, aktarılabilir ve bir tarayıcıya dokunmadan kullanılabilir.

PixVerse CLI’yi özellikle kullanışlı kılan tasarım felsefesidir: Yapay zeka aracıları düşünülerek oluşturulmuştur. Komutlar, --json veya -p ile yapılandırılmış JSON’yi döndürebilir, çıkış kodları belirleyicidir ve her işlem hattı adımı birleştirilebilir. Bu, Claude Code, Cursor, Codex veya başka herhangi bir aracıya, daha az hassas aktarımla sizin adınıza görüntü, video, ses ve müzik oluşturmayı öğretebileceğiniz anlamına gelir.

Bu kılavuz, 29 Haziran 2026’da kontrol edilen mevcut PixVerseAI/cli GitHub README ve genel yetenekler bildirimi ile uyumludur. Model kullanılabilirliği, varsayılan modeller ve komut işaretleri, her zaman yenilenen eğitimlerden daha hızlı değişebilir; bu nedenle üretim komut dosyaları, büyük bir toplu çalıştırmadan önce yine de pixverse --version, pixverse create <mode> --help ve pixverse update’yi doğrulamalıdır.

Önkoşullar

Başlamadan önce şunlara ihtiyacınız vardır:

Node.js 20 veya üzeri— node --version ile kontrol edin
Bir PixVerse hesabı— pixverse.ai adresinden kaydolun
Aktif bir PixVerse aboneliği— CLI, web sitesiyle aynı kredi sistemini kullanır; yalnızca abone olan kullanıcılar içerik oluşturabilir

PixVerse CLI, herhangi bir API anahtarının manuel olarak kopyalanmasını gerektirmez. Kimlik doğrulama, belirtecinizi yerel olarak depolayan tarayıcı tabanlı bir OAuth akışı aracılığıyla gerçekleştirilir.

1. Adım: CLI’yi yükleyin

Npm ile global olarak yükleyin:

npm install -g pixverse

Kurulumu doğrulayın:

pixverse --version

Genel olarak yüklememeyi tercih ederseniz komutları npx aracılığıyla da çalıştırabilirsiniz:

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

2. Adım: Kimlik doğrulama

Oturum açma komutunu çalıştırın:

pixverse auth login

CLI, OAuth cihaz yetkilendirmesi için bir tarayıcı açar. Ayrıca URL’yi kopyalayabilir ve yetkilendirmeyi herhangi bir cihazdaki herhangi bir tarayıcıdan tamamlayabilirsiniz; bu, SSH ve başsız ortamlar için kullanışlıdır. Jetonunuz otomatik olarak ~/.pixverse/’de saklanır ve 30 gün boyunca geçerlidir.

Giriş yaptığınızı doğrulamak ve mevcut kredilerinizi kontrol etmek için:

pixverse auth status pixverse account info pixverse account slots

account info komutu abonelik katmanınızı, çalışma alanı kredilerinizi ve kullanım bağlamınızı gösterir. pixverse account usage, kredi tüketimini gözden geçirmenize yardımcı olurken pixverse account slots, görüntü ve video işleri için mevcut eşzamanlı nesil yuvalarını gösterir. CLI oturumları, PixVerse web/uygulama oturumlarından bağımsızdır ve depolanan CLI belirtecini pixverse auth logout ile kaldırabilirsiniz. Toplu işleri çalıştırmadan önce daima bakiyenizi ve kullanılabilir yuvalarınızı kontrol edin.

Hızlı Başlangıç Komutları

Kurulumdan oluşturulan varlığa kadar yalnızca en kısa yola ihtiyacınız varsa şu sırayla başlayın:

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

Aracı ve CI iş akışları için --json veya -p’yi etkin tutun; böylece ilerleme ve hatalar stderr’de kalırken stdout makine tarafından okunabilir kalır. Üretim yeniden denemeleri için, --idempotency-key <key>’yi oluşturma komutlarına ekleyin, böylece tekrarlanan gönderimler yanlışlıkla yinelenen ücretli işler yaratmaz.

3. Adım: İlk Resminizi Oluşturun

Metinden görüntüye dönüştürme, kurulumunuzu test etmenin en hızlı yoludur. Çalıştır:

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

Mevcut GitHub README, GPT Image 2’yi varsayılan görüntü modeli olarak listeliyor. Tekrarlanabilir otomasyonlar için yine de --model’yi açıkça ayarlayın ve toplu çalışmadan önce canlı CLI yardımını veya capabilities.json’yi kontrol edin. --json bayrağı yapılandırılmış çıktıyı döndürür:

{ "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 }

Daha yüksek çözünürlüklü çıktı için onu destekleyen bir model belirtin:

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

PixVerse, her biri farklı çözünürlük tavanlarına ve en boy oranı desteğine sahip çeşitli görüntü modellerini destekler:

Modeli	`--model` value	Kalite	Notlar
GPT Image 2	`gpt-image-2.0`	1080p, 1440p, 2160p	Varsayılan görüntü modeli; geniş ve uzun en boy oranlarını destekler
Nano Banana 2	`gemini-3.1-flash`	512p, 1080p, 1440p, 2160p	Esnek `auto` ve standart en boy oranları
Qwen Image	`qwen-image`	720p, 1080p	Yaygın yaratıcı görevler için hızlı oluşturma
Nano Banana Pro	`gemini-3.0`	1080p, 1440p, 2160p	Daha büyük boyutlarda yüksek kaliteli görüntü oluşturma
Nano Banana	`gemini-2.5-flash`	1080p	Hızlı geri dönüş ile hafif görüntü oluşturma
Seedream 5.0 Lite	`seedream-5.0-lite`	1440p, 1800p, 2160p	Yüksek detaylı yaratıcı görseller
Seedream 4.5	`seedream-4.5`	1440p, 2160p	Yüksek çözünürlüklü görüntü oluşturma
Seedream 4.0	`seedream-4.0`	1080p, 1440p, 2160p	Görüntü iş akışları için ek Seedream seçeneği
Kling Image O3	`kling-image-o3`	1080p, 1440p, 2160p	Esnek çerçevelemeyle stilize görsel çıktılar
Kling Image V3	`kling-image-v3`	1080p, 1440p	Dengeli kalite ve hız

Ayrıca mevcut bir görüntüyü görüntüden görüntüye 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

Oluşturulan görüntüyü indirmek için:

pixverse asset download 789012

4. Adım: İlk Videonuzu Oluşturun

Metinden videoya aynı şekilde çalışır. 5 saniyelik bir klip oluşturun:

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

Tamamen özelleştirilmiş bir nesil için:

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

--audio bayrağı, video içeriğinizle eşleşen yapay zeka tarafından oluşturulan ortam sesini etkinleştirir. --json bayrağı, tamamlandığında doğrudan bir indirme komutuna veya işlem hattındaki bir sonraki adıma iletebileceğiniz bir video_url döndürür.

PixVerse, farklı kalite, süre ve mod desteğine sahip birden fazla video modeli sunar:

Modeli	`--model` value	Maksimum Kalite	Süre	Notlar
PixVerse V6	`v6`	1080p	1–15 saniye	Varsayılan video modeli; geniş en boy oranı desteği
PixVerse C1	`pixverse-c1`	1080p	1–15 saniye	Video, referans ve geçiş iş akışlarında güçlü destek
Seedance 2.0 Standard	`seedance-2.0-standard`	2160p	4–15 saniye	Video, referans ve geçiş modlarını destekler
Seedance 2.0 Fast	`seedance-2.0-fast`	720p	4–15 saniye	Video, referans ve geçiş modları için Daha Hızlı Seedance seçeneği
Seedance 2.0 Mini	`seedance-2.0-mini`	720p	4–15 saniye	Video, referans ve geçiş modları için Hafif Sedance seçeneği
Happy Horse 1.0	`happyhorse-1.0`	1080p	3–15 saniye	`create video` için sese duyarlı video seçeneği mevcuttur
Kling O3 Pro	`kling-o3-pro`	720p	3–15 saniye	Video, referans ve geçiş iş akışlarını destekler
Kling O3 Standard	`kling-o3-standard`	720p	3–15 saniye	Standart Kling O3 seçeneği
Kling 3.0 Pro	`kling-3.0-pro`	720p	3–15 saniye	Video ve geçiş iş akışlarını destekler
Kling 3.0 Standard	`kling-3.0-standard`	720p	3–15 saniye	Standart Kling 3.0 seçeneği
Grok Imagine 1.5	`grok-imagine-1.5`	720p	1–15 saniye	Yalnızca görüntüden videoya; `--image` gerektirir ve giriş görüntüsünün en boy oranını takip eder
Grok Imagine	`grok-imagine`	720p	1–15 saniye	Daha önceki Grok seçeneği; video, genişletme ve referans iş akışlarını destekler
Veo 3.1 Lite	`veo-3.1-lite`	1080p	4, 6 veya 8 saniye	Video ve 2 kare geçiş iş akışlarını destekler
Veo 3.1 Standard	`veo-3.1-standard`	2160p	4, 6 veya 8 saniye	Daha yüksek çözünürlüklü Veo seçeneği
Veo 3.1 Fast	`veo-3.1-fast`	2160p	4, 6 veya 8 saniye	Daha hızlı Veo seçeneği
Sora 2 Pro	`sora-2-pro`	1080p	4, 8 veya 12 saniye	Sabit süreli Sora seçeneği
Sora 2	`sora-2`	720p	4, 8 veya 12 saniye	Standart Sora seçeneği
PixVerse v5.6	`v5.6`	1080p	1–10 saniye	Hala hareket kontrolü ve seçilmiş nesil iş akışları için kullanılıyor
PixVerse v5.5	`v5.5`	1080p	1–10 saniye	`create modify` iş akışları için kullanılır
PixVerse v5	`v5`	1080p	1–10 saniye	3’ten fazla kare geçişi iş akışı için kullanılır

Statik Bir Görüntüyü Canlandırma

Bir fotoğrafı veya oluşturulan görüntüyü videoya dönüştürmek için --image işaretini sağlayın:

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

Yerel bir dosya yolu veya URL iletebilirsiniz. Yerel dosyalar otomatik olarak yüklenir; manuel yükleme adımı gerekmez. 1920x1920 veya 5MB’den büyük yerel görüntü girişleri, yükleme öncesinde otomatik olarak yeniden boyutlandırılır veya sıkıştırılır; uzak resim URL’leri arka uç tarafından olduğu gibi doğrulanır.

Grok Imagine 1.5 için bir görüntü gereklidir ve çıktının en boy oranı bu görüntüyü takip eder:

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ş, Hareket Kontrolü ve Şablonları Kullanın

Mevcut CLI, basit metinden videoya ve görüntüden videoya çok daha fazlasını destekler. Bu oluşturma modları, karakterler, ana kareler, düzenlemeler veya efektler üzerinde daha fazla kontrole ihtiyaç duyduğunuzda kullanışlıdır:

# Create a transition between keyframes pixverse create transition --images ./frame1.png ./frame2.png # Metinden konuşma sesi oluşturun pixverse create voice --text "Welcome to the launch" --voice-id <preset_voice_id> --output ./voiceover.mp3 # İstemden müzik oluşturun 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 # Oluşturulan bir videoyu genişletme pixverse create extend --video <video_id> # Mevcut bir videoyu değiştirme pixverse create modify --video <video_id> --prompt "Change the background to a beach" # Lüks video çözünürlüğü pixverse create upscale --video <video_id> --quality 1080p # Referans görselleriyle video oluşturun pixverse create reference --images ./char1.png ./char2.png --prompt "Two friends walking in a park" # Sedance 2.0 referansı, görüntü ve video girişlerini karıştırabilir pixverse create reference \ --model seedance-2.0-standard \ --images ./character.png \ --videos ./motion.mp4 \ --prompt "@image1 follows the motion in @video1" # Sedance 2.0 modelleri 9'a kadar referans görüntüsünü destekler 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" # Karakter görüntüsü ve hareket referans videosuyla hareket kontrolü pixverse create motion-control --image ./character.png --video ./dance.mp4 # Bir şablondan veya efektten oluşturma pixverse create template --template-id 12345 --image ./photo.png

Her model her oluşturma modunu desteklemez. Mevcut README matrisinde create video, v6, pixverse-c1, Seedance 2.0 Standard/Fast/Mini, Happy Horse 1.0, Kling O3, Kling 3.0, Grok Imagine, Veo 3.1, Sora 2 ve v5.6’yi destekler. grok-imagine-1.5 yalnızca görüntüden videoyadır ve --image gerektirir; create extend, v6 ve grok-imagine’yi destekler; create reference, v6, pixverse-c1, Seedance 2.0 Standard/Fast/Mini, Kling O3, grok-imagine ve v5.6’yi destekler; 2 kareli geçişler daha yeni video ailelerini destekler; 3’ten fazla kare geçişi v5’yi kullanır; create modify, v5.5’yi kullanır; ve create motion-control, v5.6’yi kullanır.

Adım 5: Ses ve Müzik Oluşturun

Mevcut GitHub README, özel oluşturma komutları aracılığıyla bağımsız sesi belgeliyor. Metinden konuşmaya için create voice’yi ve istemden müziğe dönüştürme için create music’yi kullanın. Ses ve müzik çıkışları ses varlıkları olarak kaydedilir; böylece bunları task ile izleyebilir, asset list --type audio ile listeleyebilir ve asset download --type audio ile indirebilirsiniz. Yerel video ortamı için, desteklenen video oluşturma komutlarında --audio veya --no-audio’yi kullanın.

Sesli ses oluştur:

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

Ses modellerine ve önceden ayarlanmış seslere göz atın:

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

Müzik oluştur:

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

Enstrümantal parçalar için --instrumental kullanın. Şarkı sözü özellikli modeller için şarkı sözlerini gerçek metin, yerel dosya yolu veya stdin olarak iletin:

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

Mevcut ses modeli aileleri MiniMax Speech 2.8 ve ElevenLabs modellerini içerir. Mevcut müzik modeli aileleri arasında MiniMax Music, ElevenLabs Music ve Google Lyria 3 Pro bulunmaktadır. Bir üretim iş akışının komut dosyasını yazmadan önce canlı katalog için pixverse voice models ve pixverse music models’yi kullanın.

Adım 6: Etkileşimli Sihirbazı çalıştırın

İlk kez araştırıyorsanız ve mevcut tüm işaretlere henüz aşina değilseniz, kılavuzlu sihirbaza girmek için bağımsız değişkenler olmadan herhangi bir oluşturma komutunu çalıştırın:

pixverse create video pixverse create image

Sihirbaz; bilgi istemi, model seçimi, kalite, en-boy oranı, süre ve diğer seçenekler konusunda size adım adım yol gösterir; bunları komut dosyası oluşturmadan önce hangi parametrelerin mevcut olduğunu keşfetmek için faydalıdır.

Generation Beyond: Varlıklarınızı ve Çalışma Alanınızı Yönetin

Mevcut PixVerse CLI ayrıca uçtan uca terminal iş akışları oluşturmanıza yardımcı olacak yönetim komutlarını da içerir:

Görev yoklaması için pixverse task status <id> ve pixverse task wait <id>
Toplu durum kontrolleri için pixverse task status --ids 123,456,789 --type video --json
Video, görüntü ve ses varlık yaşam döngüsü işlemleri için pixverse asset list, asset upload, asset info, asset download ve asset delete
Kaydedilen 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ı işlemleri 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 varsayılanlar için pixverse config set, config list, config path ve config defaults

Bu, yalnızca oluşturmayı değil, aynı zamanda organizasyonu, şablon keşfini, ses keşfini, indirmeyi, çalışma alanı yönlendirmesini ve dağıtımını da tek bir komut dosyasında otomatikleştirmeyi kolaylaştırır. Bir komutu farklı bir çalışma alanında çalıştırmanız gerekiyorsa genel --workspace-id <id> bayrağını kullanın; 0 kişisel çalışma alanınızı hedefler.

Komut Dosyası Dostu Bayraklar

Çoğu otomasyon öngörülebilir çıktıya ve öngörülebilir çalışma zamanı davranışına bağlıdır. Bu bayraklar özellikle komut dosyalarında ve yapay zeka aracısı iş akışlarında kullanışlıdır:

Bayrak	Bunu Kullan
`--json`	Yapılandırılmış JSON çıkışını döndür
`-p`	`--json` için kısa takma ad
`--count <n>`	Bir istekten 1-4 varyasyon oluşturun
`--seed <number>`	Bir neslin üremesini kolaylaştırın
`--off-peak`	Mevcut olduğunda yoğun olmayan fiyatlandırmayı kullanın
`--audio` / `--no-audio`	Desteklenen oluşturma komutlarında ses oluşturmayı etkinleştirme veya devre dışı bırakma
`--multi-shot` / `--no-multi-shot`	Video için çoklu çekim modunu etkinleştirme veya devre dışı bırakma
`--no-wait`	İşi gönderin ve hemen geri dönün
`--timeout <sec>`	Yoklama zaman aşımını varsayılan olarak 300 saniyeye ayarlayın
`--workspace-id <id>`	Tek bir komut için etkin çalışma alanını geçersiz kıl
`--trace-id <uuid>`	Hata ayıklama ve gözlemlenebilirlik için arayan tarafından sağlanan bir UUIDv4’ü API isteklerine ekleyin
`--idempotency-key <key>`	Yanlışlıkla yinelenen ücretli işler oluşturmadan oluşturma isteklerini güvenli bir şekilde yeniden deneyin

Metin girişi bayraklarının otomatikleştirilmesi artık daha kolay. --prompt, --text ve --lyrics, değişmez bir dizeyi, yerel bir dosya yolunu veya stdin için -’yi kabul edebilir:

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 Temsilcinize Medya Oluşturmayı Öğretme

PixVerse CLI’nin gerçekten dönüştürücü hale geldiği yer burasıdır. Komutlar yapılandırılmış JSON döndürebildiğinden ve deterministik çıkış kodlarını kullanabildiğinden, kabuk komutlarını çalıştırabilen herhangi bir AI aracısına isteğe bağlı olarak görüntü ve video oluşturması öğretilebilir.

PixVerse Skills’yi yükleme

PixVerse Skills, aracılara CLI’yi nasıl doğru kullanacaklarını öğreten yapılandırılmış bir beceri kitaplığıdır: komut bayrakları, model kısıtlamaları, çok adımlı işlem hatları ve güçlü hata yönetimi.

Claude Code ve beceri formatını destekleyen diğer aracılar için PixVerse becerilerini doğrudan ekleyin:

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

Cursor, Claude Code, Codex ve diğer aracı çerçeveleri için bu beceri, aracıyı bunları sıfırdan çıkarmaya zorlamak yerine açık kısıtlamalar vererek güvenilirliği artırır.

PixVerse CLI ayrıca GitHub deposunda capabilities.json olarak mevcut genel kaynakla birlikte dist/capabilities.json’de kompakt, makine tarafından okunabilir bir komut bildirimi gönderir. Bu manifest, komutları, bayrakları, çıkış kodlarını, JSON çıktı beklentilerini ve efekt kategorilerini açıklar; böylece aracılar, yardım metnini kazımadan CLI sözleşmesini inceleyebilir.

Temsilciniz PixVerse becerilerini yükledikten sonra ona aşağıdaki gibi doğal dilde talimatlar verebilirsiniz:

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

Aracı, bu talimatları doğru CLI komutlarına çevirecek, JSON çıktısını ayrıştıracak ve yoklama ve indirme işlemlerini gerçekleştirecek; manuel müdahaleye gerek yok.

Claude Code

Claude Code’de PixVerse CLI, aracının otonom olarak kullandığı yerel bir araç haline gelir. PixVerse becerilerini yükledikten sonra medya oluşturmayı doğrudan herhangi bir göreve dahil edebilirsiniz:

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, doğru CLI komutlarını çağıracak, JSON yanıtından resim URL’sini ayrıştıracak ve dosyayı belirttiğiniz yola indirecektir — tüm bunları aynı oturumda, aynı zamanda kodunuzu da yazacaktır.

Tipik bir Claude Code 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') # Sonra onu canlandırıyor pixverse create video \ --prompt "Slow pan across glowing neural connections" \ --image "$IMG" \ --model v6 \ --quality 1080p \ --duration 6 \ --json

Cursor

Cursor kullanıcıları PixVerse Skills’yi proje bağlam dosyası olarak yükleyebilir. İlgili beceri dosyalarını .cursor/ dizininize yerleştirin veya çalışma alanı kurallarınıza ekleyin. Cursor, yüklendikten sonra her PixVerse CLI komutuna ilişkin tam farkındalığa sahip olur ve herhangi bir kodlama görevinin parçası olarak medya oluşturabilir.

Yaygın bir Cursor iş akışı: Aracıdan, oluşturmakta olduğunuz tasarıma dayalı bir örnek görüntü oluşturmasını isteyin, ardından bunu düzenleyiciden ayrılmadan doğrudan IDE oturumunuzda referans olarak kullanın.

Codex ve Diğer Ajanlar

PixVerse CLI, kabuk komutlarını yürütebilen ve JSON’yi ayrıştırabilen herhangi bir aracıyla uyumludur. Yapılandırılmış çıktı formatı (tutarlı alan adları, öngörülebilir hata kodları ve stderr ile ayrılmış hata mesajları) basit komut dosyası oluşturma aracılarının bile oluşturmayı güvenilir bir şekilde entegre edebilmesini sağlar.

Çıkış kodu sözleşmesi hata yönetimini basitleştirir:

Kod	Anlamı	Temsilci Eylemi
0	Başarı	JSON çıktısını ayrıştır
1	Genel hata	stderr’yi kontrol edin ve doğrulanmış girişlerle yeniden deneyin
2	Zaman aşımı	Daha uzun `--timeout` ile yeniden deneyin
3	Yetkilendirmenin süresi doldu	`pixverse auth login`’yi yeniden çalıştırın
4	Kredi bitti	Bakiyeyi kontrol edin, kullanıcıyı bilgilendirin
5	Oluşturma başarısız oldu	Farklı parametreleri deneyin
6	Doğrulama hatası	Bayrak değerlerini inceleyin

Otomasyon Boru Hatları

Bireysel komutları anladığınızda PixVerse CLI, tamamen kullanıcı etkileşimi olmadan çalışan güçlü, çok adımlı iş akışlarının kilidini açar.

Metinden Görüntüye Videoya

En kullanışlı işlem hatlarından biri: Bir metin isteminden yüksek çözünürlüklü bir görüntü oluşturun, ardından bunu bir videoya dönüştü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') # 2. Adım: Bunu bir videoya dönüştürün 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') # 3. Adım: Son videoyu indirin pixverse asset download "$VIDEO_ID" --json

Tam Video Üretim Hattı

Parlak çıktılar için, işlem sonrası adımlarla zincir oluşturma. Desteklenen video oluşturma komutlarında yerel ses istiyorsanız --audio veya --no-audio kullanın, ardından metinden konuşmaya ses için create voice’yi ve aşağı yönde birleştireceğiniz bağımsız müzik varlıkları için create music’yi kullanın:

# 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') # 2. Adım: Süreyi uzatın EXTENDED=$(pixverse create extend \ --video "$VID" \ --json | jq -r '.video_id') pixverse task wait "$EXTENDED" --json # 3. Adım: 1080p'ye yükseltme FINAL=$(pixverse create upscale \ --video "$EXTENDED" \ --quality 1080p \ --json | jq -r '.video_id') pixverse task wait "$FINAL" --json # 4. Adım: İndirin pixverse asset download "$FINAL" --json # İsteğe bağlı: ayrı bir seslendirme öğesi oluşturun pixverse create voice \ --text "The final reveal starts now." \ --voice-id <preset_voice_id> \ --output ./voiceover.mp3 \ --json

Toplu Üretim

Birden çok varyasyon gerektiren içerik ardışık düzenleri için işleri paralel olarak çalıştırın:

# Check credits and concurrent generation slots first pixverse account info --json pixverse account slots --json # Dört paralel nesil gönderin 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 # Tek bir toplu durum çağrısında döndürülen tüm görev kimliklerini kontrol edin 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 # Her birini bekleyin ve indirin 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 bayrağı işi gönderir ve hemen bir görev kimliğiyle geri döner, böylece yoklamadan önce birden fazla iş göndermenize olanak tanır. --no-wait --json ile, günlüğe kaydetme ve tekrarlanabilirlik için döndürülen görev kimliklerini ve çözümlenen oluşturma parametrelerini kaydedin. Bir istemin birden fazla varyasyonunu istiyorsanız --count <n>’yi kullanın ve birden fazla çalışan iş için tek bir durum yanıtı istiyorsanız toplu task status --ids’yi kullanın. pixverse task wait komutu sizin için uyarlanabilir yoklamayı yönetir.

Varsayılanları Yapılandırma

Sürekli olarak aynı modeli, kaliteyi veya en boy oranını kullanıyorsanız, her seferinde işaretleri tekrarlamak zorunda kalmamak için bunları varsayılan olarak 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ı işaretleri her zaman yapılandırılmış varsayılanlarınızı geçersiz kılar, böylece tekrarlamayı azaltırken tam esnekliği korursunuz. Çalışma alanına özgü otomasyon için, söz konusu tek çalıştırma için etkin çalışma alanını geçersiz kılmak istediğinizde komuta --workspace-id <id> ekleyin.

Neler İnşa Edebilirsiniz?

Temsilci iş akışınıza entegre edilen PixVerse CLI ile otomatikleştirilebilir görevlerin kapsamı önemli ölçüde genişler:

Belgeleme— belge oluşturma sürecinizin bir parçası olarak ürün demo videolarını ve ekran görüntülerini otomatik olarak oluşturun
Pazarlama— tek bir bilgi istemi kitaplığından sosyal medya içeriği çeşitleri üreten her gece toplu işler yürütün
Uygulama geliştirme— Siz kullanıcı arayüzünü oluştururken kodlama aracınızın yer tutucu görseller, model animasyonlar veya yükleme ekranı videoları oluşturmasına izin verin
Ses iş akışları— daha sonra düzenlemek üzere seslendirme taslakları, istemden müzik parçaları veya ses varlıkları oluşturun
İçerik ardışık düzenleri— CLI çağrılarını diğer araçlarla (ffmpeg, ImageMagick, bulut depolama) zincirleyerek tam otomatik medya üretimi iş akışları oluşturun
Prototip oluşturma— tam üretime geçmeden önce fikirleri doğrulamak için saniyeler içinde hızlı hareket konseptleri oluşturun

CLI, her türlü kabuk tabanlı iş akışına doğal bir şekilde uyum sağlayacak şekilde tasarlanmıştır. Mevcut otomasyonunuz bash, Python, Node veya CI/CD hattında çalışıyorsa PixVerse CLI herhangi bir ek entegrasyon yükü olmadan devreye girer.

Başlarken Kontrol Listesi

CLI’yi Güncel Tutmak

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

pixverse update

Npm’yi doğrudan da kullanabilirsiniz:

npm install -g pixverse@latest

Sürüm düzeyindeki değişiklikler ve yeni desteklenen modeller için resmi CLI kaynaklarını kontrol edin:

Mevcut belgeler; varsayılan video modeli olarak PixVerse V6, varsayılan görüntü modeli olarak GPT Image 2, Seedance 2.0 Mini desteği, moda özel PixVerse v5 ve v5.5 iş akışları, özel create voice ve create music komutları, ses varlık yönetimi, kayıtlı klasörler, çalışma alanı değiştirme, ajanlar için config defaults ve capabilities.json, pixverse update, metin girdileri için stdin desteği, daha güvenli yeniden denemeler için --trace-id ve --idempotency-key öğelerini vurgular.

Sonraki Adımlar

GitHub üzerindeki PixVerse CLI ve npm (npm install -g pixverse), tek bir arayüzden oluşturma, görev yoklama, varlık yönetimi, şablonlar, kayıtlı klasörler, hesap kontrolleri, ses modeli keşfi ve çalışma alanı kontrollerine anında erişim sağlar. PixVerse Skills deposu, aracıya hazır rehberlik ekleyerek Claude Code, Cursor, Codex ve diğer araçların bu iş akışlarını daha güçlü bir güvenilirlikle çalıştırabilmesini sağlar.

Güvenilir bir CLI ile aracıya hazır beceri kitaplığının birleşimi, görüntü, video, ses ve müzik oluşturmanın kodunuzla aynı iş akışında yaşayabileceği anlamına gelir; aynı aracı tarafından, aynı terminalde, araç değiştirmeye gerek kalmadan yönetilir.

Tek bir komutla başlayın. Oradan inşa edin.