Bu sayfa paketin ilk sürümünü anlatır. Tüm stüdyoları, API anahtarlarını ve fiyat onayını getiren 0.3 sürümü için yeni kurulum rehberine bakın.

yesilcam-studios npm paketi size iki komut verir. yesilcam komut satırı arayüzüdür: uygulamada tıkladığınız her şeyi, zincirdeki bir sonraki araç için JSON çıktısıyla birlikte kabuktan çalıştırabilirsiniz. yesilcam-mcp ise Claude'un stüdyoları araç olarak kullanmasını sağlayan bir Model Context Protocol sunucusudur. İkisi de normal hesabınızı ve normal kredi cüzdanınızı kullanır; böylece bir betik ile uygulamadaki bir iş arkadaşınız asla çakışmaz: aynı kuyruğu ve aynı bakiyeyi paylaşırlar. Bu rehber kurulumu, girişi, temel komutları, MCP kurulumunu ve otomasyonu güvenli tutan alışkanlıkları anlatır.

Kurulum ve giriş

  1. Genel olarak kurun: npm install -g yesilcam-studios.
  2. Bir kez giriş yapın: yesilcam login. Hesap bilgilerinizi sorar ve bir erişim token'ı saklar.
  3. Çalıştığını kontrol edin: yesilcam balance kredi bakiyenizi yazdırır.

Token, yalnızca sahibinin okuyabildiği dosya izinleriyle ~/.config/yesilcam/config.json dosyasına kaydedilir. Onu kaldırmak için, örneğin bir makineyi devretmeden önce, yesilcam logout çalıştırın. Token, kredi harcamak dahil hesaba tam erişim verir; bu yüzden ona bir parola gibi davranın: commit etmeyin, paylaşılan sohbetlere yapıştırmayın ve sızmış olabileceğini düşünüyorsanız çıkış yapıp yeniden giriş yaparak yenileyin.

Terminalden üretim

  • yesilcam image "a lighthouse at dusk, 35mm film" --tier standard --out lighthouse.png Standard kademede bir görsel üretir ve kaydeder.
  • yesilcam video --from 1234 --duration 5 --wait 1234 numaralı görselden beş saniyelik bir klip başlatır ve bitmesini bekler.
  • yesilcam tryon --garment 88 --person 77 --out look.png bir kıyafet varlığı ve bir modelle deneme çalıştırır.
  • yesilcam maket analyze plan.dxf bir kat planını okur ve duvarları, kapıları, pencereleri ve mahalleri raporlar.
  • yesilcam maket create "Villa", yesilcam maket save ground.dxf --project 12 --floor 0 ve yesilcam maket plans 12 uygulamadaki proje ve plan yapısının birebir karşılığıdır.

Makine tarafından okunabilir çıktı için herhangi bir komuta --json ekleyin; döndürdüğü kimlikler, bir sonraki komuta verdiğiniz değerlerdir. --wait, bir iş kimliğiyle hemen dönmek yerine iş bitene kadar bekler. Her iş, plan çarpanınız uygulanmış olarak tam da uygulamada tutacağı kadar tutar ve başarısız işler aynı şekilde iade edilir.

Betik kalıpları

  • Gece çalışan bir katalog. Kıyafet fotoğraflarının bulunduğu bir klasörde döngü kurun: her birini yesilcam --json assets upload ile yükleyin, varlık kimliğini okuyun, ardından --wait ve --out ile yesilcam --json tryon çalıştırın. Siz uyurken kırk kıyafet kırk görünüme dönüşür.
  • Senaryodan storyboard. Bir senaryoyu sahne promptlarına bölün ve Draft kademede yesilcam image komutunu bir klasöre döngüyle çalıştırın. Klasörü gözden geçirin, ardından yalnızca tuttuklarınızı Standard'da yeniden çalıştırın.
  • CI'da plan kontrolleri. yesilcam maket analyze plan.dxf --json algılanan duvarları, kapıları, pencereleri ve mahalleri döndürür. Bir planda hiç mahal yoksa ya da birimlerinin tahmin edilmesi gerektiyse derlemeyi başarısız sayın.

Tek bir kural: kimliklerine sırayla ihtiyaç duyduğunuz işleri paralel değil, art arda çalıştırın. Bağımsız işler için paralel çalıştırma sorun değildir; ama 2. işin 1. işten sonra oluşturulduğunu varsayan bir betik, işleri sırayla göndermelidir.

Claude'u bağlayın

MCP sunucusu stüdyoları araç olarak sunar: görsel ve video oluşturma, deneme çalıştırma, iş durumunu kontrol etme, kütüphane varlıklarını listeleme, karakterleri listeleme, bakiyeyi okuma, fiyat teklif etme ve Maket planlarını analiz etme ya da kaydetme. Kurulum iki komut sürer.

  1. Token'ınızı yazdırın: yesilcam login --json çalıştırın ve token alanını kopyalayın.
  2. Sunucuyu Claude Code'a kaydedin: claude mcp add yesilcam -e YESILCAM_TOKEN=<token> -- yesilcam-mcp.

Claude Desktop aynı sunucuyu kendi yapılandırma dosyasından okur; yesilcam mcp oraya yapıştırmanız gereken parçacığı yazdırır. Bağlandıktan sonra siz sonucu tarif edersiniz, Claude çağrıları sıraya koyar: "Bu altı sahnenin storyboard'unu Draft'ta çıkar, kareleri bana göster, sonra seçtiğim ikisini Standard'da üret." Claude işleri oluşturur, bekler, URL'leri döndürür ve fiyatlandırma aracı kullanılabilir olduğu için işe girişmeden önce bir maliyet teklifi verebilir.

Kararı insanda tutmak

Draft işler otonom olabilir. Standard ve Cinema üretimi ise sizin açık onayınızı beklemelidir, çünkü kredilerin gittiği yer orasıdır. Bunu talimatlarınızda belirtin ("taslağın üstündeki her iş için önce sor") ve Claude soracaktır. Aynısı betikler için de geçerlidir: kademeyi bir değişkene koyun, varsayılanını Draft yapın ve üst kademeleri açık bir bayrağa bağlayın. Uzun bir toplu işten önce bakiyeyi kontrol edin ve cüzdanın uygulamayla paylaşıldığını unutmayın; aynı anda film üreten bir iş arkadaşınız da aynı kredilerden harcar.

Sorun giderme

  • Komut bulunamadı. npm'in genel çalıştırılabilir dosyaları koyduğu dizin PATH'inizde değil. Onu ekleyin ve yeni bir kabuk açın.
  • Yetkisiz. Saklanan token kaldırılmış ya da yapılandırma dosyası silinmiş. yesilcam login komutunu yeniden çalıştırın.
  • MCP sunucusu görünmüyor. Ortam değişkeninin adı YESILCAM_TOKEN olmalı ve değeri parolanız değil, yesilcam login --json çıktısındaki token olmalıdır. Sunucuyu ekledikten sonra istemciyi yeniden başlatın.
  • Bir iş çıktı döndürmüyor. Durumunu kontrol edin; başarısız bir iş iade edilir ve yeniden gönderilebilir.

Sık sorulanlar

CLI ek ücretli mi? Hayır. Uygulamayla aynı kredi cüzdanını ve aynı fiyatları kullanır.

Token nerede saklanıyor? Yalnızca kullanıcınızın okuyabildiği ~/.config/yesilcam/config.json dosyasında. yesilcam logout onu siler.

Claude sormadan kredi harcayabilir mi? Yalnızca siz izin verirseniz. Her araç işi ve durumunu raporlar, fiyatlandırma aracı önce teklif vermesini sağlar ve Draft dışı kademelerden önce sormasını isteyen bir talimata uyulur.

CLI'ı ve uygulamayı aynı anda kullanabilir miyim? Evet. İkisinden gelen işler aynı kuyrukta ve aynı Kütüphane'de görünür.