USER GUIDE
Üretim hattının her katmanı: proje yapısı, brief ve referans, reçetelerle üretim, versiyon, onay, teslim ve rollere göre yetkiler.
Bu rehberi okumak için teknik konularla ilgilenmeniz gerekmez. "Ekip için" rozetli bölümler size göre; tasarımcı ve yönetici işini anlatan bölümleri geçebilirsiniz. Bir terime takılırsanız altını çizili sözcüğe tıklayın, Terimler sözlüğü açıklıyor.
Erken erişime katılımdan pilota davete ve ilk sahneden önce hazırlığa: Velvet'e nasıl başlanır.
Ana sitedeki formla erken erişim listesine kaydolursunuz; her adres için deneme hızı sınırlıdır. Kaydınız yalnızca organizasyon sahibinin görebileceği listeye düşer. Pilot ekibine alınınca kendi giriş bilgilerinizle hesabınıza erişirsiniz.
Üretim hattınız Organizasyon → Proje → Rol olarak düzenlenir. Her proje kendi üretim bağlamını taşır: geçmiş, kuyruk, görseller ve kayıtlı dosyalar o projenin sınırları içinde yaşar. Yerel kurulumda adlarını Proje ekranından değiştirebilirsiniz.
Giriş yaptığınızda ana sayfa projelerinizi listeler. Projeye girince rolünüzün kullanabileceği tek çalışma alanı açılır: tasarımcı graf düzenleyiciyi, operatör reçete ekranını, inceleyici inceleme kuyruğunu görür. Senaryo ekranında döküm çıkar; onaylı sahnede 'Planları öner' modelden taslak planlar getirir, 'Düzenle' ile düzeltilir, 'Hazır planları üret' hepsini tek seferde motora gönderir.
Bir planın neden ve nasıl üretileceği, hangi kararların değişmemesi gerektiği ve görsel dilin projede nasıl canlı tutulduğu.
Planın anlatı amacı, kadrajı, hareketi ve duygusal tonu üretimden önce projede netleştirilir. Reçete çalıştırılırken bu hedef, yaratıcı yön alanına doğal dille yazılır.
Karakter, ürün, mekân, kamera ve zamanlamada değişmemesi gerekenler reçetede kilitli alanlardır. Operatör bunları değiştiremez; yalnızca reçetenin kendisi, yeni bir sürümle güncellenebilir.
Karakter, stil ve dünya referansları üretim girdisi olarak kullanılır; kullanıcı dosyaları proje başına ayrılır. Hangi referans alanlarının üretime açık olduğunu reçete belirler.
Teknik uzmanlığın kilitlendiği, yaratıcı ekibin güvenle çalıştırdığı üretim yöntemleri.
Bir reçete, üretim grafiğinin sürümlenmiş bir kaydı ve bu grafikte kimin hangi alanları değiştirebileceğini söyleyen bir parametre listesidir. Operatör grafiği hiç görmez; değerleri doldurur, sistem grafiği sunucuda kurar.
Yalnızca reçetenin size açtığı alanları değiştirirsiniz: metin, alt ve üst sınırlı sayı, seçenek listesi veya evet/hayır. Reçetenin tanımlamadığı hiçbir değer üretime karışmaz; model dosyaları, örnekleyiciler ve grafiğin kendisi yayıncı tarafından sabitlenmiştir.
Aynı reçete farklı kalitelerde çalıştırılabilir: hızlı çözüm önizleme, yüksek çözüm final için kullanılır. Hangi alanın hangi rota anlamına geldiğini reçete belirler; operatör yalnızca seçer.
Bir önizleme reçetesi, bir boş görüntü üretici node ile başlar ve bir Save Image adımı ile biter; seed, adım sayısı ve metin alanları operatöre açıktır. Bu yapı hızla küçük bir önizleme üretmek için kullanılır.
Aynı grafiğin EXR çıktısı alan versiyonu, Empty Image generator'dan sonra bir VelvetSaveEXR adımı kullanır; bu adımda dosya öneki ve hassasiyet (yarı hassasiyet/float) ayarları belirlenir, çıktı doğrusal EXR olarak kaydedilir.
Operatör ekranı yalnızca reçetenin açtığı alanları gösterir: metin kutusu, sayı aralığı, açılır liste veya onay kutusu. Model dosyaları, graf düzeni ve iç düğümler operatör ekranında görünmez.
Doğal dille yön vermek, kontrollü varyasyon üretmek ve sonuçları sahne içinde karşılaştırmak.
Üretim başlatırken hedefi anlatırsınız, teknik parametre aramazsınız. Yalnızca üretim rolündeki üyeler (yapımcı, teknik tasarımcı, operatör) üretim başlatabilir; her üretim kimin istediğiyle kayıt altına girer.
Süre, oran, varyasyon sayısı gibi alanlar reçetenin izin verdiği aralıklarla sınırlanır. Tarayıcıdaki sınırlar yalnızca kolaylıktır; asıl kontrol sunucuda, reçete tarafından uygulanır.
Her üretim ilgili projenin geçmişine düşer. 'Son üretimler' listesi hangi reçete, hangi değerler ve kimin istediği bilgisini bir arada gösterir; karar yorumları inceleme aşamasında aynı kayda bağlanır.
Plan kartındaki 'Üret' reçete ekranını planın değerleriyle açar: süre, lens, yükseklik, hareket ve 'Prompt derle' ile hazırlanan İngilizce prompt önceden doludur; göndermeden önce düzenlenebilir. Sahne kartındaki 'Hazır planları üret' aynı yolu bütün hazır planlar için tek tıkla yürütür; reçetesinde doldurulamayan zorunlu alan kalan plan atlanır ve hazır kalır.
Üretim onaylanmadan yayınlanamaz; her teslimat izlenebilir bir kaydı taşır.
Onay bekleyen üretimler inceleme listesinde görünür; inceleyici her iş için 'Onayla' veya 'Reddet' kararı verir ve isterse kısa bir not bırakır. Not iş satırında ve plan kartında görünür; operatör neyin düzeltileceğini oradan okur. Onaylanmayan işler sahneye teslim edilemez.
Üretimi başlatan operatör inceleme kararı veremez; onay ve red yalnızca inceleyici ile yapımcı rollerine açıktır. Karar, işi üreten kişiden ayrı bir gözle verilir.
Teslim, onay sonrası ve açık bir eylemle yapılır: inceleme kuyruğunda onaylı satırın 'Teslim et' düğmesi; yeniden basmak yeni sürüm açar. Yayınlanan dosyalarla birlikte bir manifest yazılır: hangi reçete sürümü, hangi değerler, kimin istediği, kimin onayladığı ve dosya özetleri.
Final çıktılar doğrusal EXR olarak, üretim motorunun 8 bit kaybından önce yazılır; plaka ton aralığıyla sahneye ulaşır. Kuyruktaki küçük resim EXR'ın kendisinden türetilen, ekran için kırpılmış bir önizlemedir: plakaya dokunmaz, plakanın yerine geçmez.
Yaptığınız iş, gördüğünüz ekranı belirler; proje girişinde sunucu sizi rolünüzün çalışma alanına yönlendirir.
| Rol | Yetki alanı |
|---|---|
| Yapımcı / sahipowner | Tüm üretim hattı: graf düzenleyici, reçete yayınlama, üretim, inceleme ve teslim kararları. |
| Teknik tasarımcıworkflow_designer | Graf düzenleyici; üretim grafiği kurma ve reçete yayınlama. |
| Operatöroperator | Reçete ekranı; değer girme, üretim başlatma, önizleme/final. |
| İnceleyicireviewer | İnceleme kuyruğu; onay ve red kararları. Üretim başlatamaz, görselleri inceleyebilir. |
Rol, organizasyon düzeyinde verilir: aynı organizasyonun bütün projelerinde aynı rolü taşırsınız. Graf düzenleyiciye erişimi olmayan bir rol üretime yalnızca yayınlanmış reçeteler üzerinden gider.
Üretim grafiğinin kurulduğu yer: yalnızca teknik tasarımcı ve sahip rollerinin açabildiği graf düzenleyici.
Organizasyonunuzda tasarımcı veya sahip rolüyle projeye girince sunucu sizi graf düzenleyiciye yönlendirir. Üretim motoru arkada, Velvet'in erişebildiği özel bir adreste çalışır; ona doğrudan erişim yoktur.
Arayüz Velvet markasıyla ve Velvet oturumuyla sürdürülür: motor kendi kimlik katmanı sunmaz, Velvet kimseye açmaz. Hesap yönetimi gizlenir, API düğümleri kapalıdır ve üretim izi proje başına ayrılır.
Graf, üretim yönteminin tanımlandığı yerdir; operatör ve inceleyici proje girişinde sunucu tarafından kendi ekranlarına yönlendirilir. Yayınlanmış reçetelerin dışına çıkmaları mümkün değildir.
Üretim grafiği, tek iş gören parçalardan (node) kurulur; reçete grafiği kilitler ve yalnızca seçili alanları açar.
Bir node, grafikteki tek bir işlemdir: girdi alır, işler, çıktı verir. Node'lar bağlantılarla zincirlenir ve ortaya çıkan graf üretim yolunu temsil eder. Velvet bu grafın yayınlanmış hâline reçete der.
Tipik bir üretim grafiği katmanlar kurar: komutun kodlanması, modelin yüklenmesi, örnekleyici adımları ve çıktının yazılması. Demo reçeteler başlangıç karesi üreten (EmptyImage) ve çıktıyı yazan node'larıyla örneklendirilir; yayında olan node'lar kilitli kalır, kullanıcı yalnızca açılan alanlara dokunur.
Velvet'in engine'e eklediği 'Save EXR (Velvet)' node'u, çalışan tensörü 8 bit kaybından önce doğrusal EXR olarak yazar ve hassasiyet seçer (yarım/float). SaveImage'ın 255 ölçeği ve uint8 kırpması web önizlemesi için doğru, sanal sahne duvarı için yanlıştır; EXR değerleri 1.0 üzerinde de saklar.
Önizleme istendiğinde graph SaveImage gibi bir önizleme node'u da taşır; teslim node'uyla ayrı tutulur. Böylece teslim edilen çıktı asla sessizce 8-bit bir kopya olmaz.
Studio'daki graf düzenleyicinin kullandığı motor özellikleri: kuyruk, geçmiş, görsel görüntüleme ve grafiğin korunması.
Studio'dan verilen işler önce kuyruğa girer; bittiğinde projenizin geçmişinde görünür. Kuyruk ve geçmiş görünümü yalnızca sizin projenizin işlerini kapsar; başka organizasyonun işi listelenmez.
Ön izleme görselleri ve ara sonuçlar proje kapsamında açılır; üretilen görsel bağlantısı başka projeye erişim sağlamaz.
Örnekleyiciyi durdurmak istediğinizde kesme işlemi yalnızca kendi projenizin işlerine etki eder.
Grafiğe dışarıdan rastgele tanım (API düğümü) yüklenemez; graf düzenleme ve reçete yayınlama yalnızca tasarımcı/sahip rollerinde, proje kapsamında yürür.
| Eylem | Kısayol |
|---|---|
| Kuyruğa gönder (üretimi başlat) | Cmd+Enter |
| Kuyruğun başına gönder | Cmd+Shift+Enter |
| Süren üretimi durdur | Cmd+Alt+Enter |
| Graf aç | Cmd+O |
| Graf kaydet | Cmd+S |
| Yeni node ekle | Boş yere çift tık |
| Kısayolları düzenle | Ayarlar → tuş eşleme |
| Terim | Anlamı |
|---|---|
| Queue | Kuyruk: bekleyen üretimler |
| Interrupt | Kesme: süren üretimi durdurma |
| History | Geçmiş: biten üretimlerin listesi |
| Load | Yükle: grafı ya da modeli yükler |
| Save | Kaydet |
| Seed | Başlangıç gürültüsü; aynı ayar ve seed, aynı sonucu üretir |
| Keybinds / Keybinding | Kısayol eşleme ayarları |
| Prompt | Üretim komutu / metin isteği |
Bir üretim grafiğini ekibin çalıştırabileceği bir reçeteye çevirmek: hangi alanlar parametre olur, hangi kurallar uygulanır.
Editördeki Velvet rozetinde 'Reçete yayınla' paneli vardır: o anki grafı okur, serbest girdileri listeler, seçtiklerinizi anahtar, tip, sınır ve varsayılanla parametreye çevirir; ad, slug ve tür (kare / video / plaka) girilir, yayın sürüm numarası alır. Plaka türünde sonda 'Save EXR (Velvet)' yoksa uyarır ama yayını engellemez.
Yalnızca grafikte gerçekten var olan ve başka bir node'a bağlanmamış girdiler parametreye açılabilir. Model dosyaları, örnekleyiciler ve grafiğin kendisi sabit kalır; kullanıcı yalnızca açtığınız alanlara dokunur.
Metin (uzunluğu sınırlanır), sayı (alt/üst sınır), seçenek listesi ve evet/hayır. Her parametre varsayılan değer taşıyabilir; yayımlama anında bu varsayılan da aynı kurallarla doğrulanır.
Her yayımlama reçeteye bir üst sürüm numarası ekler (V1 → V2 → …). Sürümler eklenerek (append-only) saklanır; bir iş hangi sürümle üretildiyse o sürüm teslim kaydında görünür.
Reçete adı yalnızca harf, rakam ve tire içerebilir; parametre anahtarları tanımlayıcı ve benzersiz olmalıdır. Bir girdiye iki parametre birden yazamaz; başka bir node'a bağlı girdiler değiştirilemez.
Reçete ekranında, Studio'da ve ekip tartışmalarında karşılaşabileceğiniz üretim motoru terimlerinin Türkçe açıklaması.
| Terim | Açıklama |
|---|---|
| Workflow / Graf | Node'lar ve bağlantılarla kurulmuş üretim grafiği. Velvet'te yayınlanmış hâli 'reçete' olarak adlandırılır. |
| Model / Checkpoint | Eğitilmiş ağırlıklar; görsel ve video üretiminin temeli. Reçete tarafından sabitlenir, operatör seçemez. |
| Sampler | Gürültüden görsele giden denoising adımlarını yöneten matematiksel yöntem. |
| Scheduler | Denoising gücünün adımlar boyunca nasıl dağılacağını belirler. |
| Seed | Başlangıç gürültüsünü tanımlar; aynı ayar ve aynı seed, aynı sonucu üretir. |
| Pozitif / negatif prompt | Üretimde neyin dahil edilmesi ve neyin edilmemesi gerektiğini anlatan metin. |
| CFG | Komutun üretimi ne kadar güçlü yönlendirdiği; yüksek değer daha sadık, bazen daha aşırı sonuç verir. |
| Denoising | Görselden görsele işlerde mevcut görüntünün ne kadarının değiştirileceği. |
| Latent | Modelin üzerinde çalıştığı sıkıştırılmış görsel temsili (piksel değil). |
| Upscale | Üretimi daha yüksek çözünürlüğe çıkarma adımı; genellikle zincirin sonunda kullanılır. |
| Kontrol katmanı | Poz, derinlik, yüz, maske gibi sinyallerle üretimi yapılandırma. |
| EXR / doğrusal | Yüksek dinamik aralıklı görüntü formatı; Velvet plakaları 8 bit kaybından önce EXR olarak yazar. |
| VAE | Gizli uzayı (latent) piksellere çeviren katman; kod çözme aşamasında çıktının görünümünü belirler. |
| Adım sayısı | Üretimin uyguladığı denoising adımı sayısı; daha fazla adım genelde daha oturmuş, ama daha yavaş sonuç verir. |
| LoRA | Ana modelin tamamını eğitmeden belirli bir stil veya karakteri uygulayan küçük ek model. |
| Ön işleme | Poz, derinlik, çizim gibi bir koşul görselini üretimin anlayabileceği kılavuza dönüştürme adımı. |
Üretim başlatıldığında arkada ne olur; kuyruk, model yükleme, kesme ve çıktı beklentileri.
Üretim önce kuyruğa girer. Model ilk kez yükleniyorsa ilk iş daha uzun sürer; kuyruk, proje kapsamında kendi işlerinizle birlikte izlenir.
'Son üretim' bölümü işi başlatıldığı andan bitişe dek izler; tamamlanınca görseller projenin geçmişine ve inceleme listesine düşer.
Kuyruktaki kendi işlerinizi durdurabilirsiniz; kesme yalnızca kendi projenizin işlerine etki eder.
Final çıktılar EXR'dir; listeler EXR'dan türetilen küçük bir önizleme gösterir. Önizleme yalnızca Velvet'in EXR yazıcısının biçimi için üretilir; başka bir düğümün sıkıştırılmış EXR'ında liste 'EXR' yazar.
Vitrindeki örneklerin arkasındaki yaygın üretim desenleri; her biri reçete yoluyla ekiple paylaşılır.
Tek bir kareden hareketli plan elde etmek; referans kare ve hareket yönü reçetenin açtığı alanlardan verilir.
Poz, derinlik, yüz veya maske gibi sinyallerle aynı karakter ve mekânın farklı koşullarda yeniden üretimi; referansla dünya tutarlılığı.
Önce hızlı bir motorla önizleme alınır; yön onaylanınca aynı reçete yüksek kaliteli final rotasında çalıştırılır.
Karakter, mekân ve stil kuralları reçetenin kilitli alanlarında kalır; operatör yalnızca varyasyon üretir, kuralları bozamaz.
OpenPose iskeleti gibi bir koşul görseli, karakterin duruşunu yönlendirir; yüz ve mekân bütünlüğü korunarak aynı karakter başka pozda üretilir.
Gri tonlu derinlik haritası, sahnedeki yakın-uzak ilişkisini korur; portre, mimari ve ürün sahnelerinde mekân ve perspektif dağılmaz.
Model çoğu sahnede önce küçük kare üretir; upscale modeli çıktıyı detay kaybı olmadan büyültür. Gerekirse 2x sonra 4x şeklinde zincirlenir.
Metinle tekrar tekrar üretmek yerine koşul görseli (poz, derinlik, çizim) eklemek sonucu sahiplenmeyi kolaylaştırır ve deneme sayısını düşürür.
Desenlerin referans anlatımları üretim motorunun resmi dokümanlarındaki kontrol ve büyütme bölümlerinden Türkçeye uyarlanmıştır. Ayrıca bakınız: aynı kavramların İngilizce hâlleri için Terimler sözlüğü.
Üretim motorunun nerede durduğu, verinin nasıl kapsamlandığı ve kimin neyi değiştirebildiği.
Üretim motorunun kendi kimlik doğrulaması yoktur; bu yüzden yalnızca Velvet'in ulaşabildiği özel bir adreste çalışır. Her kullanıcı erişimini Velvet oturumu üzerinden alır.
Geçmiş, kuyruk, görsel görüntüleme, silme ve kesme yalnızca çağıranın kendi projesinin işlerine dokunur; başka projenin işiyle etkileşim mümkün değildir.
Reçete üzerinden üretimde operatör yalnızca değer gönderir; grafik sunucuda reçetenin saklı sürümünden kurulur. Reçetenin bilmediği hiçbir girdi değiştirilemez.
Graf düzenleyici ve reçete yayınlama yalnızca tasarımcı/sahip; üretim başlatma yapımcı, tasarımcı ve operatör; onay ve red inceleyici/sahip.
Prototip sınırı: giriş medyası bugün tek paylaşılan dizinde tutulur ve işlem geneli önbellek işler arası paylaşılır. Üretim kurulumunda bu boşluklar kapatılır; per-tenant worker, PostgreSQL RLS ve proje izole depolama hedeflenir.
İlk günden ilk teslime: hazır alınan alana girin, demo reçeteyle üretin, onaylayın ve teslim edin.
Pilota alınan ekip, kurulumda oluşturulan hesapla giriş yapar. Ana panel projelerinizi ve her projedeki rolünüzü gösterir; bir projeye girmek oturumunuzu o çalışma alanına bağlar.
'Üretim' ekranında reçete seçilir; sınırları reçete koyar, siz değerleri girip üretimi başlatırsınız. İş 'Son üretim' listesine - sürümü ve değerleriyle - düşer.
İnceleyici görselleri inceler; onay işe teslim hakkını verir. Red edilen iş düzeltilip yeniden üretilmek üzere geri gelir.
Onaylanan iş, plakaları (EXR) ve manifest ile teslim dizinine yazılır; sahne hattı çıktıyı oradan alır. Hangi sürümün hangi işi ürettiği kayıtta kalır.
Rol ve projeler organizasyona bağlıdır; ekip üyeleri üyelikle gelir.
Her kullanıcı organizasyonun üyesidir ve üyelik bir rol taşır; proje girişinde sunucu sizi rolünüzün çalışma alanına götürür. Aynı organizasyonun bütün projelerinde aynı rolü taşırsınız.
Bir hesap birden çok organizasyonda üye olabilir; organizasyonların projeleri ana panelde ayrı ayrı listelenir. Aktif projeye girmek oturumu o iş alanına bağlar.
Pilot kapsamında üye hesapları kurulum aşamasında oluşturulur; üye daveti ve rol değişikliği için arayüz üretim sürümünde gelecek. Üyelik ve çoklu proje altyapısı bugün hazırdır.
Kimlik doğrulama, oturum ömrü ve hesap davranışları.
E-posta ve parolayla girilir. Güvenlik gereği sistem parolayı saklamaz; hesap veya paroladan biri yanlışsa size tek bir uyarı gösterir: 'E-posta veya parola hatalı.'
Bir giriş 12 saat geçerli kalır ve süresi uzamaz; süre dolunca yeniden parola girilir. Aynı giriş, aynı hesabın birden çok sekmesinde geçerlidir.
Çıkış butonu erişiminizi sıfırlar; sonraki sayfada yeniden parola istenir.
Demo alan, kurulumun tanımladığı yönetici hesabıyla başlar; parola değerleri kurulumda belirlenir ve dışarıya verilmez.
Üretimin ve müşteri materyalinin nerede tutulduğu, neyin dışarı çıktığı.
Veriler kurulumun makinesinde kalır: veritabanı, senaryolar (proje başına ayrı), teslim edilen plakalar. Müşteri materyali çalışma alanını terk etmez.
Dış analitik veya kullanım izleme yoktur; sitede yalnızca bekleme listesi formu veri toplar ve o da yalnızca erişim talebi içindir.
Sitedeki form yalnızca bir erişim talebi kaydıdır; erişim sonradan kurulumda yönetici tarafından açılır.
Üretim motoru özel (yerel) adreste çalışır; işler ve çıktılar o adresin dışına çıkmaz. Tüm erişim Velvet oturumu üzerindendir.
Üretim sonunda ortaya çıkan dosyalar nerede durur, ne içerir ve nasıl doğrulanır.
Teslim edilen plakalar kurulumdaki teslim dizinine yazılır; her teslim, üretim kaydını taşıyan bir manifest ile birlikte düzenlenir.
manifest.json; hangi reçete sürümünün kullanıldığını, girilen değerleri, isteyen ve onaylayan kimliğini ve dosya özetlerini taşır; teslimin doğrulanabilir kaydıdır.
EXR yazıcı adımı varsayılan 'velvet/plate' önekini kullanır; önek ve hassasiyet (yarım hassasiyet / float) reçete tanımında belirlenir, operatör tarafından değiştirilemez.
Final çıktı doğrusal EXR'dir; tarayıcıda gösterilen ise ondan türetilmiş, ekran için kırpılmış bir önizlemedir. İkisini karıştırmamak için 'Sık karıştırılan kavramlar' bölümüne bakın.
Manifestteki dosya özetleri, teslim edilen dosyaların değiştirilmediğini doğrulamak için kullanılır; boru hattı bu doğrulamayı teslimin parçası sayar.
Dosya adları ve klasör düzeni kuruluma göre değişir; yapı, teslimi alan boru hattının beklentileriyle birlikte kurulur. Ayrıca bakınız: onay ve teslim sırası için Onaylar, EXR karışıklığı için Sık karıştırılan kavramlar.
Karşılaşılacak tipik durumlar ve atılacak adımlar.
Reçete sınırları dışındaki bir değer, form üzerinde doğrudan hata gösterir; değeri reçetenin tarif ettiği aralığa çekin.
Onaylanmamış bir iş 'onay gerekiyor' ile teslim edilmez: önce inceleyici onayı, sonra teslim.
Model ilk kez yüklendiğinde ilk iş sonraki işlerden belirgin yavaş olabilir; bu motor için normdur, hata değildir.
Listeler Velvet'in EXR yazıcısından çıkan dosyayı önizler. 'EXR' yazısı kalıyorsa dosya başka bir düğümden (sıkıştırılmış veya döşemeli) gelmiştir; reçetenin sonunda 'Save EXR (Velvet)' olduğundan emin olun.
12 saat sonunda yeniden giriş istenir; girişten sonra projeye tekrar geçince çalışma alanınız geri gelir.
Üretim hiç başlamıyorsa motor yerel adreste çalışmıyor olabilir; bağlantı hatası görüyorsanız yöneticinize bildirin.
'Model bulunamadı' benzeri bir hata, reçetenin aradığı model dosyasının olmadığını gösterir; yönetici modeli motorun model klasörüne ekler ve üretim yeniden denenir.
Kanal ve boyut hataları çoğunlukla farklı mimari ailelerden modelleri (örneğin flux ailesi ile SD1.5 ailesi) aynı grafa bağlamaktan doğar; reçete tasarımcısı aynı ailenin modellerini ve uygun VAE'yi kullanır.
Model dosyaları birkaç gigabyte olabilir; disk ve bellek yetmezse yükleme hatalanır. Yönetici disk alanını, sürücü hızını ve önbellek ayarlarını kontrol eder.
'Error while deserializing header' gibi bir hata çoğunlukla bozuk ya da yarım kalmış bir model dosyasını işaret eder; model yeniden indirilerek sorun giderilir.
Model belirtileri ve çözümleri üretim motorunun resmi dokümanlarındaki sorun giderme bölümünden Türkçeye uyarlanmıştır. Ayrıca bakınız: kopyala-yapıştır eşleşmeleri için Hata iletisi: ne yaparım?.
Ekranda görebileceğiniz tipik hata iletilerini kopyala-yapıştır bölümüyle eşleştirir.
| Error | Ne yapılır |
|---|---|
| Model bulunamadı | Model dosyası eksik ya da yoldan taşınmış; yönetici modeli model klasörüne ekler ve iş yeniden denenir. |
| Error while deserializing header | Bozuk ya da yarım kalmış bir indirme; doğrulanmış dosyayla model yeniden indirilir. |
| Latent/boyut uyuşmazlığı | Farklı mimari ailelerden modeller aynı grafa bağlanmış; aynı ailenin modellerini kullanın ve VAE'yi uyumlu tutun. |
| Bağlantı reddedildi | Üretim motoru çalışmıyor; yöneticiye bildirin. Motor açıkken iş otomatik olarak kuyruğa döner. |
| EXR tarayıcıda açılmıyor | Normaldir: EXR doğrusal format tarayıcıda doğrudan açılmaz. Listeler Velvet yazıcısının EXR'ından küçük resim üretir; 'EXR' yazısı kalıyorsa dosya başka bir düğümden gelmiştir. |
| Değer sınır dışı | Form reçete kuralını uygulayarak reddetti; değeri tarif edilen aralığa çekin. |
Tablo, üretim motorunun resmi dokümanlarındaki model sorunları bölümü ve Velvet belirtileri üzerinden derlenmiştir; ileti metni sürüme göre kısa bir farklılık gösterebilir. Kesin eşleşemediyseniz ekran görüntüsüyle yöneticinize ulaşın. Ayrıca bakınız: Sorun giderme.
Ekip tarafında yalnızca tarayıcı; motor ve veri yerelde çalışır.
Sadece bir tarayıcı gerekir; ek sunucu adresi veya port bilgisi gerekmez. Kimlik ve çalışma alanı tek girişten gelir.
Üretim motorunun sürümü kurulumun sistem durumundan raporlanır; reçeteler motor davranışına sabitlenir. Sürüm güncellemesi yönetici kararıdır ve öncesinde reçetelerin doğrulama çalıştırması yapılır.
Velvet ve üretim motoru kurulumun makinesinde çalışır; motor model dosyaları kullanır ve ilk üretimde yükleme görülür. Motor kapalıyken üretim durur.
Yerel kurulum 127.0.0.1:8788 üzerinde sunulur (VELVET_PORT ile değiştirilebilir); motor 127.0.0.1:8188'de çalışır. Ekip aynı makineyi kullanmıyorsa yönetici alanı güvenli bir proxy ile yayınlar.
Pilot tek makinede çalışır; birden çok organizasyonun aynı anda üretim yaptığı kurulumlarda per-tenant worker ile ayrıştırma üretim hedefidir.
Bir belgesel ekibinin brief'ten teslime kadar adım adım akışı; oyundayken ekranda ne gördüğünüzü önceden tanır.
Örnek, Velvet'in dokümantasyonunda anlatılan rol ayrımını ve onay zincirini gerçek bir akışla birleştirir; adlar kurulumunuza göre değişebilir.
Aynı görünen ama farklı anlama gelen terimleri yan yana ayırır.
| Şunu söylerken | Kastettiğin | Fark |
|---|---|---|
| Önizleme | Final | Önizleme ekran içindir: hızlı rota çıktısı ya da EXR'dan türetilen kırpılmış küçük resim; final, doğrusal EXR plaka olarak teslim edilir. İkisi aynı dosya değildir. |
| Reçete | Üretim | Reçete, bir yayından sürümlenen graf kaydı ve parametre listesidir; üretim, reçeteyi çalıştıran tek iştir. Reçete sabit kalır, üretim yeniden yapılır. |
| Kuyruk | Geçmiş | Kuyruk bekleyen işleri gösterir; geçmiş, biten işlerin listesidir. Üretim önce kuyruğa girer, bitince geçmişe düşer. |
| Organizasyon | Proje | Organizasyon, insanlara ve rollere sahip olan ekibin adresidir; proje, onun içindeki üretim alanlarıdır. Rol, organizasyonda; çalışma, projede yürür. |
| EXR / doğrusal | JPEG önizleme | EXR, plakanın ton aralığını koruyan yüksek dinamik aralıklı dosyadır; JPEG önizleme yalnızca ekranda görülen sıkıştırılmış görseldir. EXR tarayıcıda doğrudan açılmaz; Velvet küçük resmini EXR'dan türetir. |
| Onay | Teslim | Onay, inceleyicinin işi görüp geçtiği karardır; teslim, o onayı izleyen dosya yayınıdır. Onaysız teslim yapılamaz. |
| Versiyon | Üretim | Sürüm, reçete kaydının değişmez bir anlık görüntüsüdür; üretim, o sürümü çalıştırır. Bir üretim her zaman tek sürüme bağlıdır. |
Kavram çiftlerinin tamamı yandaki tabloda açıklanmıştır; sorun giderme bölümüyle birlikte okumanız önerilir.
İlham ve açıklama için güvenilir dış kaynaklar; bu site onları tamamlar ama yerini tutmaz.
Üretim motorunun resmi dokümanları: kavramlar, arayüz kılavuzu, öğreticiler ve sorun giderme. Rehberimizdeki kavramların çoğu oradan Türkçeye uyarlanmıştır; teknik detay için İngilizce kaynak gerekebilir.
Topluluk tarafından paylaşılan örnek üretim grafikleri ve şablonlar; fikir almak için kullanılır. Velvet'e taşımadan önce 'Reçete yayınlama' bölümünü inceleyin.
Dokümanlar kurulum, veri ve model dosyaları konularında ham motor düzenini anlatır; Velvet bu işleri kendisi yönetir. Dış kaynaklardaki adımları kurulumunuza uygulamadan önce yöneticinize danışın.
Dış kaynak materyali bu rehbere Türkçeye uyarlanarak taşınır; alıntı kullanımlarında kaynak gösterilir ve lisanslarına uyulur.
Velvet'in arkasındaki motorun kullanabileceği model seçenekleri: açık kaynak modeller makinenizde (ComfyUI ile) çalışır, kapalı modeller ise bir API üzerinden bağlanır. Aşağıdaki tablolar, seslendirme, video üretimi ve dil modelleri için açık kaynak ve API tabanlı seçenekleri karşılaştırır.
| Model | Tür | Açıklama |
|---|---|---|
| F5-TTS | Açık kaynak (yerel) | Sıfır örnekli ses klonlama; doğallığı yüksek, çok dilli. |
| E2-TTS | Açık kaynak (yerel) | F5-TTS ile aynı ailede, akıcı ve sadık konuşma. |
| Kokoro | Açık kaynak (yerel) | Çok hızlı ve hafif; İngilizce için güçlü kalite. |
| XTTS v2 | Açık kaynak (yerel) | Ses klonlama; 17 dil destekler. |
| OpenVoice v2 | Açık kaynak (yerel) | Ses klonlama ve tarz aktarımı; çok dilli. |
| Fish Speech | Açık kaynak (yerel) | Duygulu konuşma ve duygu etiketleri. |
| GPT-SoVITS | Açık kaynak (yerel) | 5 saniyelik referansla ses klonlama. |
| Chatterbox | Açık kaynak (yerel) | Sıfır örnekli klonlama, doğal ton. |
| CosyVoice | Açık kaynak (yerel) | Sıfır örnekli klonlama; çok dilli. |
| StyleTTS 2 | Açık kaynak (yerel) | Tarz kontrollü, düşük gecikmeli konuşma. |
| Zonos | Açık kaynak (yerel) | Büyük ve çok dilli; yüksek kalite. |
| Bark | Açık kaynak (yerel) | Konuşma dışı sesler ve müzik de üretebilir. |
| Piper | Açık kaynak (yerel) | Hafif, CPU'da çok hızlı çalışır. |
| ChatTTS | Açık kaynak (yerel) | Konuşma amaçlı, doğal sohbet tonu. |
| MeloTTS | Açık kaynak (yerel) | Çok dilli ve güçlü Türkçe/İngilizce desteği. |
| Orpheus | Açık kaynak (yerel) | 3B düzeyinde duygulu ve gerçek zamanlı konuşma; duygu etiketleri. |
| Sesame CSM | Açık kaynak (yerel) | Doğal sohbet ve diyalog; duygulu tonlama. |
| Spark-TTS | Açık kaynak (yerel) | Sıfır örnekli klonlama; çok dilli. |
| MetaVoice | Açık kaynak (yerel) | İngilizce ses klonlama; açık lisans. |
| Dia | Açık kaynak (yerel) | Çoklu konuşmacılı diyalog üretimi (naturl turning). |
| Parler-TTS | Açık kaynak (yerel) | Sesi metinle tanımlayarak kontrol etme. |
| WhisperSpeech | Açık kaynak (yerel) | Araştırma amaçlı, Whisper ekosistemiyle uyumlu. |
| OpenAI TTS | Kapalı API | Ücretli API; gpt-oss tarzı yüksek doğallık, iyi Türkçe. |
| ElevenLabs | Kapalı API | Ücretli API; ticari seslendirmede en popüler, geniş ses yelpazesi. |
| Google Cloud TTS | Kapalı API | Ücretli API; çok sayıda dil ve ses. |
| Azure Neural TTS | Kapalı API | Ücretli API; kurumsal Türkçe sesler. |
| Amazon Polly | Kapalı API | Ücretli API; Türkçe dahil çok dilli. |
| Model | Tür | Açıklama |
|---|---|---|
| Wan 2.1 / 2.2 | Açık kaynak (yerel) | Metinden videoya ve görüntüden videoya; Apache-2.0, 5B sürümü 8 GB VRAM'de çalışır. |
| LTX-Video / LTX 2.3 / 2.5 | Açık kaynak (yerel) | Çok hızlı; LTX 2.3+ yerleşik senkron ses + görüntü (4K'ya kadar). |
| Hunyuan Video 1.0 / 1.5 | Açık kaynak (yerel) | Sinematik hareket kalitesi yüksek. |
| CogVideoX 2B / 5B | Açık kaynak (yerel) | Metne yüksek sadakat. |
| Mochi 1 | Açık kaynak (yerel) | Akıcı hareket; ince ayar temeli. |
| Stable Video Diffusion | Açık kaynak (yerel) | Görüntüden videoya; düşük bellek. |
| Open-Sora / Open-Sora 2.0 | Açık kaynak (yerel) | Tam açık kaynak; uzun ve sinematik videolar. |
| VACE | Açık kaynak (yerel) | Wan tabanlı açık aile; video düzenleme ve kontrol. |
| OpenAI Sora | Kapalı API | Ücretli API; yüksek kalite ve uzun sahneler. |
| Google Veo | Kapalı API | Ücretli API; gerçekçi hareket, iyi kontrol. |
| Runway Gen | Kapalı API | Ücretli API; sinematik video. |
| Pika | Kapalı API | Ücretli API; yaratıcı stil. |
| Kling | Kapalı API | Ücretli API; güçlü fizik ve animasyon. |
| Luma Dream Machine | Kapalı API | Ücretli API; görüntüden videoya güçlü. |
| Hailuo / MiniMax | Kapalı API | Ücretli API; akıcı ve yüksek kalite video. |
| Model | Tür | Açıklama |
|---|---|---|
| Qwen 2.5 / Qwen3 / Qwen3.5 / Qwen3.6 | Açık kaynak (yerel) | GGUF olarak yerel çalışır; güçlü metin, kod ve çok modlu. |
| Qwen3-VL / Qwen2.5-VL | Açık kaynak (yerel) | Çok modlu; görüntü anlayabilir. |
| Gemma 3 / Gemma 4 | Açık kaynak (yerel) | Çok modlu ve metin; yerel GGUF. |
| Llama 3.1 / Llama 4 | Açık kaynak (yerel) | Genel amaçlı güçlü açık aile; çok uzun bağlam. |
| Mistral / Mixtral / Mistral Small 4 | Açık kaynak (yerel) | Hızlı, verimli ve çok dilli; Apache-2.0. |
| DeepSeek V3 / R1 / V4 | Açık kaynak (yerel) | Güçlü mantık ve kod üretimi; MoE. |
| gpt-oss-20b / gpt-oss-120b | Açık kaynak (yerel) | OpenAI'ın açık ağırlıklı modeli; yerel. |
| Phi-3 / Phi-4 | Açık kaynak (yerel) | Hafif ve yetenekli küçük model. |
| Nemotron | Açık kaynak (yerel) | Ticari açık aile; GGUF yerel. |
| Kimi K2 / K3 | Açık kaynak (yerel) | Moonshot'un açık familyası; güçlü mantık ve agent. |
| GLM-5 / GLM-5.2 | Açık kaynak (yerel) | Z.ai'nin açık modeli; kod ve ajanlı işlerde güçlü. |
| OLMo / Tülu 3 | Açık kaynak (yerel) | Tam açık kaynak (ağırlık + veri + kod). |
| Falcon | Açık kaynak (yerel) | Açık aile; metin ve kod. |
| MiniCPM-V / LLaVA | Açık kaynak (yerel) | Yerel çok modlu modeller; metin ve görüntü anlar. |
| OpenAI GPT | Kapalı API | Ücretli API; güçlü genel amaçlı ve çok modlu. |
| Anthropic Claude | Kapalı API | Ücretli API; yaratıcı yazım ve mantıkta güçlü. |
| Google Gemini | Kapalı API | Ücretli API; çok modlu ve uzun bağlam. |
Tablodaki 'Açık kaynak (yerel)' satırları ComfyUI node'larıyla kendi donanımınızda çalışır; 'Kapalı API' satırları ise ücretli bir servise internet üzerinden bağlanır ve bir API anahtarı gerektirir. Modellerin geçerli lisansını ticari kullanımdan önce doğrulayın.
En sık karşılaşılan soruların kısa yanıtları.
Teslim yalnızca onaylanmış işlere açıktır. İncelemede bekleyen veya reddedilen bir iş sahneye çıkmaz; önce inceleyicinin onayı gerekir.
Reçete kuralına aykırı her değer reddedilir ve hata mesajı gösterilir; üretim başlamaz. Sınırlar tarayıcıda değil, sunucuda uygulanır.
Rolünüz reçete ekranını veya inceleme kuyruğunu kullanıyor. Graf düzenleyici yalnızca teknik tasarımcı ve sahip rollerine açıktır.
Üretim başlatıldığında aynı sayfada 'Son üretim' bölümü işi izler; bitince görseller ilgili projenin geçmişine ve inceleme listesine düşer.
Yayınlanan dosyalar, sahnedeki boru hattının baktığı teslim dizinine yazılır; içinde üretim kaydını taşıyan manifest.json bulunur.
Oturumlar 12 saat sonra sona erer; süre dolunca yeniden giriş yapmanız gerekir.
Bitmiş üretimler projenin geçmişine ve inceleme listesine düşer; teslim edilen plakalar ise teslim dizininde manifest ile durur. İkisi de yoksa iş yarım kalmış olabilir; 'Hata iletisi: ne yaparım?' bölümüne bakın.
Graf düzenleyici yalnızca tasarımcı/sahip rolüne açıktır ve reçete sürümleri eklenen kayıtlardır: yanlışlıkla bozulan bir sürüm yayınlanmaz, önceki sürüm kaydı bozulmaz ve geri alınabilir.
Operatör üretimi silemez; üretim kayıtları teslim edilene kadar projede kalır. Silme, varsa kendi aracılığıyla veri yönetimi işlemlerinde yürür.