PixVerse CLI: Geliştiriciler için Yapay Zeka Video ve Görsel Üretimi

Giriş

Her yaratıcı iş akışının bir darboğazı vardır — kod düzenleyicinizi terk etmeniz, bir tarayıcı açmanız ve bir medya parçası oluşturmak için web arayüzünde manuel olarak tıklamanız gereken an. Geliştiriciler, yapay zeka ajanları ve otomatik içerik hattı kuranlar için bu bağlam geçişi, hızla birikerek ciddi bir sürtünme kaynağına dönüşür.

PixVerse CLI bu darboğazı ortadan kaldırır. PixVerse için resmi komut satırı arayüzüdür; PixVerse platformundaki her modele, her özelliğe ve her kapasiteye doğrudan terminalinizden erişmenizi sağlar. Metinden videoya, görselden videoya, metinden görsele, dudak senkronizasyonlu konuşma, ses efektleri, ölçek artırma — hepsi betiklenebilir, hepsi borulara aktarılabilir, hepsi tarayıcıya dokunmadan kullanılabilir.

PixVerse CLI’yi özellikle güçlü kılan şey tasarım felsefesidir: yapay zeka ajanları gözetilerek geliştirilmiştir. Her komut yapılandırılmış JSON çıktısı verir, her çıkış kodu deterministiktir ve her hattın adımı birleştirilebilir. Bu, Claude Code, Cursor, Codex veya başka herhangi bir ajana sizin adınıza görsel ve video üretmesini öğretebileceğiniz anlamına gelir — ve her seferinde doğru şekilde yapacaklardır.

Bu kılavuz, kurulumdan ilk üretime, ardından çok adımlı otomasyon hatlarına ve ajana özgü iş akışlarına uzanan tam yolculuğu anlatır.

Ön Koşullar

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

• Node.js 20 veya üzeri — node --version ile kontrol edin
• Bir PixVerse hesabı — pixverse.ai adresinden kayıt olun
• Aktif bir PixVerse aboneliği — CLI, web sitesiyle aynı kredi sistemini kullanır; yalnızca aboneler içerik üretebilir

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

Adım 1: CLI’yi Kurun

npm ile global olarak kurun:

npm install -g pixverse

Kurulumu doğrulayın:

pixverse --version

Global olarak kurmak istemiyorsanız npx üzerinden de çalıştırabilirsiniz:

npx pixverse create video --prompt "Mars'ta yürüyen bir kedi"

Adım 2: Kimlik Doğrulama

Giriş komutunu çalıştırın:

pixverse auth login

CLI kısa bir URL ve bir kod yazdıracaktır. URL’yi tarayıcınızda açın, kodu girin ve PixVerse hesabınızla yetkilendirin. Tokenınız ~/.pixverse/ konumuna otomatik olarak kaydedilir ve 30 gün geçerlidir.

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

pixverse auth status
pixverse account info

account info komutu abonelik katmanınızı, kalan kredilerinizi ve günlük kredi sıfırlama programını gösterir. Toplu işler çalıştırmadan önce her zaman bakiyenizi kontrol edin.

Adım 3: İlk Görselinizi Üretin

Metinden görsel üretimi, kurulumunuzu test etmenin en hızlı yoludur. Şunu çalıştırın:

pixverse create image --prompt "Altın saatte fotorealistik bir orman yolu" --json

--json bayrağı yapılandırılmış çıktı döndürür:

{
  "image_id": 789012,
  "status": "completed",
  "image_url": "https://...",
  "prompt": "Altın saatte fotorealistik bir orman yolu",
  "model": "qwen-image",
  "width": 1024,
  "height": 1024
}

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

pixverse create image \
  --prompt "Altın saatte fotorealistik bir orman yolu" \
  --model seedream-5.0-lite \
  --quality 1800p \
  --aspect-ratio 16:9 \
  --json

PixVerse, farklı çözünürlük tavanlarına ve güçlü yönlere sahip birçok görsel modeli destekler:

Üretilen görseli indirmek için:

pixverse asset download 789012

Adım 4: İlk Videonuzu Üretin

Metinden videoya aynı şekilde çalışır. 5 saniyelik bir klip üretin:

pixverse create video --prompt "Okyanus dalgaları üzerinde gün batımı" --json

Tam özelleştirilmiş bir üretim için:

pixverse create video \
  --prompt "Şafakta sisli bir dağ vadisi üzerinde sinematik insansız hava aracı çekimi" \
  --model v5.6 \
  --quality 1080p \
  --aspect-ratio 16:9 \
  --duration 8 \
  --audio \
  --json

--audio bayrağı, video içeriğinizle eşleşen yapay zeka tarafından üretilmiş ortam sesi etkinleştirir. --json bayrağı, tamamlandığında doğrudan bir indirme komutuna veya hattın bir sonraki adımına iletebileceğiniz bir video_url döndürür.

PixVerse, farklı yeteneklere sahip birden fazla video modeli sunar:

Statik Bir Görseli Canlandırın

Bir fotoğrafı veya üretilmiş görseli videoya dönüştürmek için --image bayrağını kullanın:

pixverse create video \
  --prompt "Sahnenin içinden nazikçe geçen bir rüzgar" \
  --image ./product-photo.jpg \
  --model v5.6 \
  --quality 1080p \
  --json

Yerel bir dosya yolu veya URL iletebilirsiniz. Yerel dosyalar otomatik olarak yüklenir — manuel yükleme adımı gerekmez.

Adım 5: Etkileşimli Sihirbazı Çalıştırın

İlk kez keşfediyorsanız ve mevcut tüm bayraklara henüz aşina değilseniz, rehberli sihirbaza girmek için herhangi bir oluşturma komutunu bağımsız değişken olmadan çalıştırın:

pixverse create video
pixverse create image

Sihirbaz sizi istem, model seçimi, kalite, en boy oranı, süre ve diğer seçenekler arasında adım adım yönlendirir — betiklemeden önce hangi parametrelerin mevcut olduğunu keşfetmek için kullanışlıdır.

Yapay Zeka Ajanınıza Medya Üretmeyi Öğretin

PixVerse CLI’nin gerçekten dönüştürücü hale geldiği yer burasıdır. Her komut yapılandırılmış JSON döndürdüğünden ve deterministik çıkış kodları kullandığından, kabuk komutları çalıştırabilen herhangi bir yapay zeka ajanı talep üzerine görsel ve video üretmesi için öğretilebilir.

PixVerse Skills Kurulumu

PixVerse Skills, ajanlara CLI’yi tam olarak nasıl kullanacaklarını öğreten yapılandırılmış beceri dosyalarından oluşan bir kütüphanedir: her komutun hangi bayrakları kabul ettiğini, hangi modellerin hangi parametreleri desteklediğini, komutları hatlara nasıl zincirleyeceğini ve hataları nasıl işleyeceğini içerir.

Claude Code ve skills biçimini destekleyen diğer ajanlar için PixVerse skills’i doğrudan ekleyin:

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

Cursor için beceriler, PixVerse Skills GitHub deposundaki skills/ dizininde bulunur ve doğrudan düzenleyicinize bağlam olarak yüklenebilir. Codex ve LangChain tabanlı ajanlar için her beceri dosyası, ajanın sistem istemine enjekte edilebilecek bağımsız bir markdown dosyasıdır.

Ajanınıza PixVerse skills yüklendikten sonra şunun gibi doğal dil talimatları verebilirsiniz:

• “Bu ekran görüntüsünden 10 saniyelik bir ürün tanıtım videosu oluştur”
• “Bu blog kapak görselinin 16:9 biçiminde dört varyasyonunu oluştur”
• “Bu diyagramı ortam sesiyle 5 saniyelik bir açıklayıcı klibe dönüştür”

Ajan bu talimatları doğru CLI komutlarına çevirecek, JSON çıktısını işleyecek ve yoklama ile indirmeleri yönetecektir — manuel müdahale gerekmez.

Claude Code

Claude Code’da PixVerse CLI, ajanın özerk olarak kullandığı yerel bir araca dönüşür. PixVerse skills yüklendikten sonra herhangi bir göreve doğrudan medya üretimi ekleyebilirsiniz:

Bu makine öğrenmesi blog gönderisi için bir kapak görseli oluştur,
seedream-5.0-lite modelini 1800p çözünürlükte 16:9 biçiminde kullan,
./assets/cover.webp konumuna indir

Claude Code doğru CLI komutlarını çalıştıracak, JSON yanıtından görsel URL’sini işleyecek ve dosyayı belirttiğiniz yola indirecektir — hepsi kodunuzu yazdığı oturumun içinde.

Tipik bir Claude Code iş akışı:

# Claude Code bunu talimatınıza göre özerk olarak çalıştırır
IMG=$(pixverse create image \
  --prompt "Sinir ağı katmanlarının soyut görselleştirmesi, koyu arka plan, mavi ve mor tonlar" \
  --model seedream-5.0-lite \
  --quality 1800p \
  --aspect-ratio 16:9 \
  --json | jq -r '.image_url')
 
# Ardından canlandırır
pixverse create video \
  --prompt "Parlayan sinir bağlantıları arasında yavaş kaydırma" \
  --image "$IMG" \
  --model v5.6 \
  --quality 1080p \
  --duration 6 \
  --json

Cursor

Cursor kullanıcıları PixVerse Skills’i proje bağlam dosyası olarak yükleyebilir. İlgili beceri dosyalarını .cursor/ dizininize yerleştirin veya çalışma alanı kurallarınıza ekleyin. Yüklendikten sonra Cursor her PixVerse CLI komutundan tam olarak haberdar olur ve herhangi bir kodlama görevinin parçası olarak medya üretebilir.

Yaygın bir Cursor iş akışı: ajanın üzerinde çalıştığınız bir tasarıma dayalı bir mockup görseli oluşturmasını isteyin, ardından düzenleyiciyi terk etmeden IDE oturumunuzda doğrudan referans olarak kullanın.

Codex ve Diğer Ajanlar

PixVerse CLI, kabuk komutları çalıştırabilen ve JSON işleyebilen herhangi bir ajanla uyumludur. Yapılandırılmış çıktı biçimi — tutarlı alan adları, öngörülebilir hata kodları ve stderr’de ayrılmış hata mesajları — basit betik ajanların bile üretimi güvenilir şekilde entegre etmesini sağlar.

Çıkış kodu sözleşmesi hata işlemeyi basit kılar:

Otomasyon Hatları

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

Metinden Görsele, Görselden Videoya

En kullanışlı hatlardan biri: bir metin isteminden yüksek çözünürlüklü bir görsel oluşturun, ardından onu bir videoya canlandırın.

# Adım 1: Temel görsel oluştur
IMG_RESULT=$(pixverse create image \
  --prompt "Geceleri bir siberpunk şehir manzarası, neon ışıklar ıslak kaldırımda yansıyor" \
  --model gemini-3.1-flash \
  --quality 2160p \
  --aspect-ratio 16:9 \
  --json)
 
IMAGE_URL=$(echo "$IMG_RESULT" | jq -r '.image_url')
 
# Adım 2: Videoya canlandır
VID_RESULT=$(pixverse create video \
  --prompt "Kamera neon aydınlatmalı sokaklar boyunca yavaşça kaydırır" \
  --image "$IMAGE_URL" \
  --model v5.6 \
  --quality 1080p \
  --duration 8 \
  --json)
 
VIDEO_ID=$(echo "$VID_RESULT" | jq -r '.video_id')
 
# Adım 3: Son videoyu indir
pixverse asset download "$VIDEO_ID" --json

Tam Video Prodüksiyon Hattı

Cilalı çıktı için oluşturmayı son işlem adımlarıyla zincirleme yapın:

# Adım 1: Temel videoyu oluştur
RESULT=$(pixverse create video \
  --prompt "Ağır çekimde monte edilen bir ürün" \
  --model v5.6 \
  --quality 720p \
  --duration 5 \
  --json)
 
VID=$(echo "$RESULT" | jq -r '.video_id')
 
# Adım 2: Süreyi uzat
EXTENDED=$(pixverse create extend \
  --video "$VID" \
  --prompt "Montaj sekansına devam et" \
  --duration 5 \
  --json | jq -r '.video_id')
 
pixverse task wait "$EXTENDED" --json
 
# Adım 3: Ortam sesi ekle
WITH_SOUND=$(pixverse create sound \
  --video "$EXTENDED" \
  --prompt "Endüstriyel atölye ambiyansı, yumuşak mekanik sesler" \
  --json | jq -r '.video_id')
 
pixverse task wait "$WITH_SOUND" --json
 
# Adım 4: 1080p'ye ölçek artır
FINAL=$(pixverse create upscale \
  --video "$WITH_SOUND" \
  --quality 1080p \
  --json | jq -r '.video_id')
 
pixverse task wait "$FINAL" --json
 
# Adım 5: İndir
pixverse asset download "$FINAL" --json

Toplu Üretim

Birden fazla varyasyon gerektiren içerik hatları için işleri paralel olarak çalıştırın:

# Önce kredileri kontrol et
CREDITS=$(pixverse account info --json | jq -r '.credits.total')
echo "Mevcut krediler: $CREDITS"
 
# Dört paralel üretim gönder
pixverse create video --prompt "Dağlar üzerinde gün doğumu" --no-wait --json > /tmp/v1.json &
pixverse create video --prompt "Okyanus üzerinde gün batımı" --no-wait --json > /tmp/v2.json &
pixverse create video --prompt "Çöl üzerinde yıldızlar" --no-wait --json > /tmp/v3.json &
pixverse create video --prompt "Donmuş bir göl üzerinde kuzey ışıkları" --no-wait --json > /tmp/v4.json &
wait
 
# Her birini bekle ve indir
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 döner; yoklama yapmadan önce birden fazla iş göndermenizi sağlar. pixverse task wait komutu uyarlamalı yoklamayı sizin yerinize yönetir — manuel uyku döngüsü gerekmez.

Varsayılanları Yapılandırın

Sürekli aynı modeli, kaliteyi veya en boy oranını kullanıyorsanız, her seferinde bayrakları tekrarlamak zorunda kalmamak için bunları varsayılan olarak ayarlayın:

pixverse config defaults set --mode video --model v5.6 --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

Komut satırı bayrakları her zaman yapılandırılmış varsayılanları geçersiz kılar; bu nedenle tekrarı azaltırken tam esnekliği korursunuz.

Neler İnşa Edebilirsiniz

PixVerse CLI ajan iş akışınıza entegre edildiğinde, otomatikleştirilebilir görevlerin kapsamı önemli ölçüde genişler:

• Dokümantasyon — dokümantasyon oluşturma sürecinizin bir parçası olarak ürün tanıtım videoları ve ekran görüntülerini otomatik oluşturun
• Pazarlama — tek bir istem kitaplığından sosyal medya içerik varyasyonları üreten gece toplu işleri çalıştırın
• Uygulama geliştirme — kullanıcı arayüzü oluştururken kodlama ajanınızın yer tutucu görseller, mockup animasyonlar veya yükleme ekranı videoları üretmesine izin verin
• İçerik hatları — tam otomatik medya prodüksiyon iş akışları oluşturmak için CLI çağrılarını diğer araçlarla (ffmpeg, ImageMagick, bulut depolama) zincirleme yapın
• Prototipleme — tam üretime geçmeden önce fikirleri doğrulamak için saniyeler içinde hızlı hareket konseptleri oluşturun

CLI, kabuk tabanlı herhangi bir iş akışına doğal biçimde oturacak şekilde tasarlanmıştır. Mevcut otomasyonunuz bash, Python, Node veya bir CI/CD hattında çalışıyorsa PixVerse CLI ek entegrasyon yükü olmadan yerleşir.

Başlangıç Kontrol Listesi

• Node.js 20 veya üzerini kurun
• npm install -g pixverse çalıştırın
• pixverse auth login çalıştırın ve tarayıcıda yetkilendirin
• Kredileri doğrulamak için pixverse account info çalıştırın
• İlk görselinizi üretin: pixverse create image --prompt "..." --json
• İlk videonuzu üretin: pixverse create video --prompt "..." --json
• Ajanınız için PixVerse Skills kurun (Claude Code, Cursor veya Codex)
• pixverse config defaults set ile tercih ettiğiniz varsayılanları ayarlayın
• İlk otomasyon hattınızı oluşturun

Sonraki Adımlar

npm’deki PixVerse CLI (npm install -g pixverse) tüm üretim kapasitelerine anında erişim sağlar. PixVerse Skills deposu, yapay zeka ajanınıza bu kapasiteleri her bağlamda doğru şekilde kullanmayı öğreten yapılandırılmış beceri dosyalarını sunar.

Güvenilir bir CLI ile ajana hazır bir beceri kütüphanesinin birleşimi, görsel ve video üretiminin artık kodunuzla aynı iş akışında yaşayabileceği anlamına gelir — aynı ajan tarafından, aynı terminalde, araç değiştirmeye gerek kalmadan.

Tek bir komutla başlayın. Oradan ilerleyin.