Sorun giderme

Önce belirtiler, sonra çözüm. Buradakilerden hiçbiri uymuyorsa günlük dosyası (kurulum klasörünün altındaki logs/maystroai.log) ve sürümünüzle (ayarlar menüsü, Hakkında) birlikte support@maystro.ai adresine yazın.

Kurulum ve başlatma

Kurulum başarısız oluyor ya da yarıda kalıyor

Repair mode (onarım modu; Review adımı) ile yeniden deneyin. Sonra: launcher geliştirici konsolu, uv cache clean, yeniden deneyin. Sonra farklı bir kurulum konumu.

Veritabanı bağlantısı başarısız

PostgreSQL hizmeti çalışmıyor ya da sunucu, port, veritabanı, kullanıcı veya parola oluşturduklarınızdan farklı. Aynı değerlerle başka bir PostgreSQL istemcisinden bağlanmayı deneyin; hizmeti ya da değerleri düzeltin, sonra bağlantı testini yeniden çalıştırın.

Etkinleştirme başarısız

Anahtarda yazım hatası olup olmadığını (biçim MAY-XXXX-XXXX), sistem saatini ve bir proxy ya da güvenlik duvarının api.maystro.ai adresini engellemediğini kontrol edin. Başka bir makinede zaten etkinleştirilmiş bir anahtarın önce orada devre dışı bırakılması gerekir.

Uygulama açılıyor ama "warming up" (ısınıyor) gösteriyor ya da bağlanmıyor

Arka uç (backend) hâlâ başlıyor; kurulum veya güncelleme sonrasındaki ilk başlatma daha uzun sürer. Birkaç dakika içinde düzelmezse launcher günlüğünde traceback arayın.

Üretim

Üretim beklenenden çok daha yavaş

Başka bir süreç GPU belleğini tutuyor. Bir işi başlatmadan önce Görev Yöneticisi, Performans, GPU'yu açıp ayrılmış bellek kullanımına bakın; sesli asistanlar, yerel LLM sunucuları ve konuşma araçları sık rastlanan suçlulardır. Bunları kapatın. Paylaşılan belleğe taşan bir GPU her adımı üç ila dört kat daha yavaş çalıştırır.

Bellek yetersizliği (out of memory)

Görseller: boyutu küçültün, yüksek çözünürlük kürünü (HRF) kapatın, fazladan kontrol katmanlarını kaldırın. Video: daha kısa take, 768×768 preset'i, tek referans görsel, GPU'da başka hiçbir şey olmasın. Eğitim: diğer her şeyi kapatın; 32 GB sistem belleğine sahip bir makine daha yavaş çalışır ama bitirir.

Görüntü prompt'u dikkate almıyor ya da tuhaf biçimde kırpılıyor (video)

Referans görsel, preset'in en-boy oranıyla eşleşmiyor. Önce preset oranına göre kırpın. Bkz. Referans görseller ve sesler.

Yüz take'ler arasında değişiyor

Yalnızca referansla yapılan üretimde normaldir. Prompt'u koruyup yeni bir tohumla (seed) yeniden take alın; tekrar eden bir karakter için bir karakter LoRA'sı eğitin.

Konuşma bozuk, yanlış dilde ya da harfler tek tek okunuyor

Replik düz ASCII ile yazılmış ya da take cümle için fazla kısa. Dilin doğru karakterlerini kullanın ve uzunluğu eşleştirin. Bkz. Prompt yazımı.

LTX klibinin ikinci yarısında ses kesik kesik geliyor

Klip, modelin ses zarfından (yaklaşık 10 saniye) daha uzun. Kısaltın ya da iki çekime bölün.

Video ağır çekimde oynuyor

Bir upsample preset'i kullanılmış. Aynı uzunluk için standart preset'i seçin.

Model içe aktarma, modelin tanımlanamadığını söylüyor

İçe aktarma iletişim kutusunda türü ve taban modeli elle ayarlayın. Yine de yüklenmiyorsa mimari desteklenmiyordur; hata gerekçeyi belirtir.

Eğitim

Eğitim başlamıyor

Başka bir koşu etkin (aynı anda yalnızca bir tane) ya da GPU bir üretimle meşgul. Bitmesini bekleyin veya iptal edin.

LoRA her take'in ışığını ya da hareketini değiştiriyor

Strength 1.0 ile kullanılıyor. Sahne LoRA listesinde 0.5'e geri alın ve karakter setini yeniden derleyin.

LoRA yüz yerine veri seti karelerini kopyalıyor

Aşırı öğrenme (overfitting). Daha erken bir checkpoint kullanın ya da daha az epoch veya daha çeşitli karelerle yeniden eğitin. Bkz. Checkpoint'ler ve çıktılar.