PixVerse CLI: Terminalden Yapay Zeka Video ve Görsel Üretimi

Giriiş

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 CLI bu darboğazı ortadan kaldırır. PixVerse’in resmi komut satırı arayüzüdür ve PixVerse platformundaki her modele, her özelliğe ve her yeteneğe doğrudan terminalinizden erişmenizi sağlar. Metinden videoya, görüntüden videoya, metinden görüntüye, dudak senkronizasyonu konuşması, ses efektleri, yükseltme; tümü komut dosyasıyla yazılabilir, tümü iletilebilir, tümü bir tarayıcıya dokunmadan kullanılabilir.

PixVerse CLI’yi özellikle güçlü kılan şey, tasarım felsefesidir: AI aracıları göz önünde bulundurularak oluşturulmuştur. Her komut yapılandırılmış JSON çıktısı verir, her çıkış kodu belirleyicidir ve her işlem hattı adımı birleştirilebilir. Bu, Claude Code’a, Cursor’a, Codex’e veya başka herhangi bir aracıya sizin adınıza görüntü ve video oluşturmayı öğretebileceğiniz anlamına gelir; onlar da bunu her zaman doğru şekilde yapacaklardır.

Bu kılavuz size tüm yolculuğunuzda yol gösterir: kurulumdan ilk neslinize, ardından çok adımlı otomasyon ardışık düzenlerine ve aracı tabanlı iş akışlarına kadar.

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

Adım 1: 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"

Adım 2: 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/ içinde 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

account info komutu abonelik seviyenizi, kalan kredilerinizi ve günlük kredi sıfırlama planınızı gösterir. Toplu işleri çalıştırmadan önce daima bakiyenizi kontrol edin.

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

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

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

--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": "qwen-image",
  "width": 1024,
  "height": 1024
}

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

PixVerse, her biri farklı çözünürlük tavanlarına ve güçlerine sahip çeşitli görüntü modellerini destekler:

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 indirme komutuna veya işlem hattındaki bir sonraki adıma iletebileceğiniz bir video_url döndürür.

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

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

Bir fotoğrafı veya oluşturulan görseli 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.

Adım 5: 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.

Neslin Ötesinde: Varlıklarınızı ve Çalışma Alanınızı Yönetin

En yeni PixVerse CLI, 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>
• Varlık yaşam döngüsü işlemleri için pixverse asset list|upload|info|download|delete
• Kayıtlı klasörler için pixverse saved list|items|new|rename|add|remove|delete
• Çoklu çalışma alanı işlemleri için pixverse workspace list|status|switch|manage

Bu, yalnızca oluşturmayı değil, aynı zamanda organizasyonu, indirmeyi ve dağıtımı da tek bir komut dosyasında otomatikleştirmeyi kolaylaştırır.

Yapay Zeka Temsilcinize Medya Oluşturmayı Öğretme

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üğü ve deterministik çıkış kodları kullandığı için, kabuk komutlarını çalıştırabilen herhangi bir yapay zeka aracısına, isteğe bağlı olarak görüntü ve video oluşturması öğretilebilir.

PixVerse Becerilerini 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.

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

Claude Kodu

Claude Code’da 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 1800p 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; bunların tümünü kodunuzu da yazdığı aynı oturumda gerçekleştirecektir.

Tipik bir Claude Kodu 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 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

İmleç

İmleç 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. Cursor, yüklendikten sonra her PixVerse CLI komutu hakkında tam bilgiye sahip olur ve herhangi bir kodlama görevinin parçası olarak medya oluşturabilir.

Yaygın bir İmleç 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 Aracılar

PixVerse CLI, kabuk komutlarını yürütebilen ve JSON’u 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:

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')
 
# 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 Prodüksiyon Hattı

Parlak çıktılar için işlem sonrası adımlarla zincir oluşturma:

# 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

Toplu Üretim

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

# 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

--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. pixverse task wait komutu sizin için uyarlanabilir yoklamayı yönetir; manuel uyku döngülerine gerek yoktur.

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

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.

Neler Oluşturabilirsiniz

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
• İçerik ardışık düzenleri — tam otomatik medya üretimi iş akışları oluşturmak için CLI çağrılarını diğer araçlarla (ffmpeg, ImageMagick, bulut depolama) zincirleyin
• Prototip oluşturma — tam üretime geçmeden önce fikirleri doğrulamak için saniyeler içinde hızlı hareket konseptleri oluşturun

CLI, herhangi bir kabuk tabanlı iş akışına doğal olarak uyacak ş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

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

CLI’yi Güncel Tutmak

Yerel CLI’nizi güncel tutmak için npm’yi kullanın:

npm update -g pixverse

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

• PixVerse CLI Değişiklik Günlüğü

Sonraki Adımlar

Npm’deki (npm install -g pixverse) PixVerse CLI, tek bir arayüzden oluşturma, görev yoklama, varlık yönetimi, kayıtlı klasörler 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 ve aracıya hazır beceri kitaplığının birleşimi, görüntü ve video 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.