SUPIR

SUPIR, SDXL ve görsel açıklamaları çevresinde kurulan difüzyon tabanlı bir görsel restorasyon araştırma sistemidir. İnandırıcı dokular üretebilir; ancak inandırıcı ayrıntı, o ayrıntının kaynakta bulunduğunun kanıtı değildir. Yalnız işleme izniniz olan görsellerle değerlendirin, değiştirilmemiş girdiyi koruyun ve her adayı hedeflenen kullanıma göre inceleyin. Bu metin resmi depo ve makaleye dayalı kaynak incelemesidir. Model ağırlığı indirilmedi, görsel işlenmedi, hız veya kalite kıyası yeniden üretilmedi. Sabitlenmiş kaynak dosyaları 20 Eylül 2026’da yeniden kontrol edildi; ağırlıkların kullanım izni hâlâ açıklığa kavuşmuş değil.

SUPIR’i çalıştırmadan restorasyon kararını tanımlayın

Sınırları belirli bir soruyla başlayın: SUPIR, kullanımı izinli ve bozulmuş tek bir fotoğraftan, okuyucu için önemli gerçekleri değiştirmeden yararlı bir gösterim kopyası üretebiliyor mu? Kaynakta görülenleri, belirsiz kalanları ve sabit kalması gereken özellikleri kaydedin. Daha keskin görünen göz, harf veya yüzey makul olabilir; yine de uydurulmuş olabilir.

Makale, ölçeklendirilmiş üretken önseli, metin açıklamalı büyük eğitim koleksiyonunu, olumsuz kalite komutlarını ve restorasyon yönlendirmeli örneklemeyi anlatır. Bunlar önerilen yöntem hakkındaki araştırma iddialarıdır; bu incelemenin ölçümleri değildir. Yazarlar Shenzhen Institute of Advanced Technology, Shanghai AI Laboratory, University of Sydney, Hong Kong Polytechnic University, Tencent PCG ARC Lab ve Chinese University of Hong Kong dahil birden çok kuruma bağlıdır. Projeyi tek bir şirketin ürünü olarak göstermek doğru değildir. Yazarların kurumları; resmî makale.

Restorasyonu kanıt niteliğinde ayrıntı geri kazanmak, bilinmeyen bir kişiyi tanımak, okunamayan plakayı okumak veya özgünlüğü doğrulamak için kullanmayın. Doğal görünen yeniden üretim, belirsizliği gizleyerek bu kararları daha az güvenilir hâle getirebilir. Hasarlı kaynağı korumak, kullanabileceğiniz başka bir referans görsel edinmek veya kayıp gerçekleri geri getirdiğini öne sürmeyen üretken olmayan bir düzeltme seçmek doğru sonuç olabilir.

Resmi bileşenleri ve model ağırlıklarını ayırın

Resmi kurulum tek ve bağımsız bir model dosyasından oluşmaz. README; SDXL CLIP kodlayıcılarını, SDXL temel ağırlığını, LLaVA CLIP'i ve LLaVA v1.5 13B'yi listeler. Ayrıca SUPIR-v0Q ve SUPIR-v0F proje ağırlıklarını Baidu Netdisk ile Google Drive üzerinden bağlar. İsteğe bağlı Juggernaut ağırlıkları ayrı gösterilir. Resmi depo.

Her bileşeni ayrı edinme ve lisans kararı olarak ele alın. Bağlantılı ikili dosyalar indirilmedi veya sağlama toplamı çıkarılmadı; GitHub sürüm dosyaları da doğrulanmadı. README bağlantısı bir edinme yolunu destekler; ikili dosya bütünlüğünü, hizmet sürekliliğini, uyumluluğu veya belirli kullanım iznini kanıtlamaz.

İncelenen CKPT_PTH.py, bakımcının yerel mutlak dosya yollarını içerir. Bu yolları ve YAML içindeki ağırlık konumlarını yapılandırın. README, Hugging Face erişilebildiğinde yalnız belirttiği CLIP yollarını None yaparak otomatik indirmeyi kullanmayı söyler; bütün model yollarını temizleme yönergesi değildir. Sonuçları karşılaştırmadan önce tam depo commit'ini, her kaynak URL'sini, yerel sağlama toplamını ve bağımlılık sürümünü kaydedin. Benzer adlı bir ayna dosya, hedeflenen dosyanın yerini sessizce almamalıdır.

Q veya F seçimini aynı izinli girdiyle yapın

Referans komut satırı varsayılan olarak --SUPIR_sign Q kullanır ve Q ya da F kabul eder. README, Q'yu makaledeki varsayılan eğitim ayarı ve geniş genelleme seçeneği; F'yi ise hafif bozulmalarda birinci aşama kodlayıcısı daha fazla ayrıntı koruyan eğitim seçeneği olarak tanımlar. Bu, bakımcıların yönlendirmesidir; bağımsız doğrulanmış sıralama değildir. Q/F açıklaması; CLI seçimi

Q ve F'yi yalnız kaynak, kırpım, çıktı ölçeği, seed, komutlar ve örnekleme ayarları aynı olduğunda karşılaştırın. Birkaç değişken birlikte değişirse çekici bir çıktı, farkın hangi seçimden kaynaklandığını göstermez. Reddedilenler dahil tüm adayları saklayın ve kabul ya da ret nedenini yazın.

Zor görselin yanında hafif bozulmuş bir kontrol görüntüsü kullanın. Kontrol, ağır hasarda yararlı görünen iş akışının zaten görülebilen dokuyu gereksiz yere değiştirip değiştirmediğini gösterir. Herhangi bir ağırlık kaynakla desteklenen metni, yüz yapısını veya ürün geometrisini belirlenen toleransın ötesinde değiştiriyorsa o iş için reddedin. Q ve F farklı otomatik açıklamalar üretirse çifti yalnız ağırlıkların değil, bütün iş akışının karşılaştırması olarak yorumlayın.

Açıklamaları, komutları ve işleme boyutlarını denetleyin

Referans betik, açıklama üretimi için gürültüsü azaltılmış bir görsel hazırlar ve kısa kenarda 512 pikseli hedefler. Varsayılan durumda LLaVA bu görseli açıklar; çıkan metin difüzyon örneklemesine katılır. --no_llava ile LLaVA yüklenmez ve açıklama boş kalır, fakat ön gürültü azaltma adımı yine çalışır. Olumlu ve olumsuz komutlar da etkin kalır. Bu seçenek bütün ön işlemeyi veya CUDA gereksinimini kaldırmaz. Açıklama yolu

Betik, argümanları ve açıklamaları terminale yazar, son görüntü örneklerini PNG olarak kaydeder. Açıklama için kullanılan ara görüntüyü kaydetmez. Onu incelemek için betiğe açık bir dışa aktarma işlemi eklemek gerekir; bu incelemede böyle bir değişiklik uygulanmadı veya denenmedi. Dışa aktarma olmadan özgün girdiyi, kaydedilen açıklamayı ve son PNG’yi karşılaştırın. Ara görüntü teşhisinin yapılamadığını belirtin. Terminal günlüğü, ara görüntünün dışa aktarımı değildir.

Olumlu ve olumsuz komutların tamamını her çalışmayla saklayın. İçerik uydurma riski varsa otomatik açıklamayı boş açıklamalı çalışmayla karşılaştırın. Kaynağın desteklemediği bir gerçeği istemeyin: “net mavi yazı” gibi bir komut, eski harfleri geri getirmek yerine okunur görünen yeni harfler üretebilir.

CLI varsayılanları seed 1234, 50 EDM adımı, 4,0 yönlendirme ölçeği, 1,0 ikinci aşama kontrolü, min_size 1024 ve upscale 1’dir. Görsel yardımcısı önce girdi boyutları ile büyütme çarpanını kullanarak hedef boyutları kaydeder. Ardından kısa kenara iç işleme alt sınırını uygular ve işleme boyutlarını 64’ün katlarına yuvarlar. Kayıt sırasında sonuç hedef boyutlara döner. Varsayılanlarla 512 × 512 girdi, büyütme 1 olduğunda içeride 1024 × 1024 işlenir ve 512 × 512 kaydedilir. Bu, koddan çıkarılan boyuttur; çalıştırılarak gözlenmiş sonuç değildir. CLI varsayılanları; Boyutlandırma ve kayıt

README’nin kalite ve aslına bağlılık ayarları belgelenmiş başlangıç noktalarıdır, her görsel için en iyi seçenek değildir. Her seferinde tek etkeni değiştirin; hedef çıktı boyutu ile iç işlemeye dair varsayımları ayrı kaydedin. Son PNG’nin boyutunu ölçmek iç tensörün boyutunu göstermez. Bakımcıların ayarları

Çalıştırmadan önce ağırlık iznini açıklığa kavuşturun

Sabitlenmiş SUPIR Software License Agreement, koşulsuz biçimde “ticari olmayan kullanıma izin veriliyor” etiketiyle özetlenemez. Bölüm 2(b), açık yazılı izin olmadan tescilli sinir ağı bileşenlerini kullanma, kopyalama, değiştirme veya dağıtma hakkı tanımaz. Bölüm 3(a) ise tescilli ağırlık, bias ve mimarinin yalnız ticari olmayan amaçlarla kullanılabileceğini belirtir; 3(b) ayrı bir ticari sözleşme ister. Yazılı izin koşuluyla ticari olmayan kullanım ifadesi arasındaki ilişki burada çözümlenmiş değildir. LICENSE bölüm 2 ve 3

Bu inceleme hangi hükmün öncelikli olduğuna karar vermez veya Q/F ağırlıklarının kullanımına izin vermez. Değerlendirme planına başlamadan, tam ağırlık dosyası ve amaçlanan faaliyet için lisans verenden açıklama alın. Herkese açık kod ve indirme bağlantıları izin kanıtı değildir. SDXL, LLaVA, isteğe bağlı Juggernaut modelleri, girdi görselleri ve çıktılar için geçerli koşullar ayrıca incelenmelidir. Ücretli veya herkese açık bir arayüz bu hakları çözmez.

README, SupPixel çevrimiçi uygulamasına bağlantı verir. Görsel gönderilmedi; güncel koşullar, gizlilik davranışı, fiyat ve çalışma durumu denenmedi. Göndermeden önce işletmeciyi belirleyin ve o gün geçerli kullanım koşullarını, veri işleme yaklaşımını ve çıktı izinlerini saklayın. Burada gözlenen erişilebilirlik, okunabilir kaynak metni ve README’de belgelenen bağlantılarla sınırlıdır; ikili dosyaların başarıyla edinildiğini veya servisin çalıştığını göstermez. Belgelenen uygulama

Aynı girdiye dayalı küçük bir değerlendirme planlayın

Önce ağırlıkların kullanım iznini netleştirin. Ardından işleyebileceğiniz bir fotoğraf ve daha az bozulmuş bir kontrol görseli hazırlayın. Özgün dosyaları koruyun; gerekiyorsa hassas metadatayı çalışma kopyasından çıkarın ve değişmemesi gereken ayrıntıları listeleyin. Yalıtılmış ortam kullanıp gerçekten kurulu bağımlılık ve sürücü sürümlerini kaydedin. README, Python 3.8 önerir; bu tarif her güncel işletim sistemiyle uyumluluk garantisi değildir. Kurulum yönergesi

Bu komutlar çalıştırılmamış karşılaştırma planıdır; yapılandırılmış ağırlıklar ve CUDA varsayar. Kabuk yönlendirmeleri, yazdırılan argüman ve açıklamalar dahil her çalışmanın standart çıktısını ve hatalarını ayrı günlükte tutar. Sonraki çalışmaya geçmeden günlüğü inceleyin; burada başarıyla tamamlanmış bir koşu iddiası yoktur. Betik CUDA yoksa hata verir. Cihaz ve argüman işlemleri

mkdir -p logs
python test.py --img_dir inputs/control --save_dir results/q --SUPIR_sign Q --seed 1234 > logs/q.log 2>&1
python test.py --img_dir inputs/control --save_dir results/f --SUPIR_sign F --seed 1234 > logs/f.log 2>&1
python test.py --img_dir inputs/control --save_dir results/no-caption --SUPIR_sign Q --seed 1234 --no_llava > logs/no-caption.log 2>&1

Girdi klasöründe yalnız hedef test görüntüsünü bulundurun ve farklı dosya gövdeleri kullanın. Son örnekler <input-stem>_<sample-index>.png biçiminde kaydedilir. control.png ve tek örnek için Q çıktısı results/q/control_0.png olur. Yazdırılan açıklama girdi dosyasının adını içermez; her koşuda tek görüntü bu ilişkiyi açık tutar. Girdi döngüsü ve çıktı adları

Özgün girdiyi, günlükteki açıklamayı ve PNG’yi hedef gösterim boyutunda ve önemli kırpımlarda karşılaştırın. Biçimi, renk profilini, girdi ve çıktı boyutlarını ve örtük varsayılanları kaydedin. İç boyutlar ve kaynak kullanımı için ayrıca ölçüm veya kayıt işlemi gerekir; günlük bunları kendiliğinden içermez. Kontrol, kabul çizelgesini karşıladıktan sonra aynı matrisi zor görüntüde tekrarlayın. Ayrı ve burada denenmemiş dışa aktarma olmadan ara görüntü teşhisi yapılamaz.

Türetilmiş kopyayı kanıt çizelgesiyle kabul edin

Aşağıdaki çizelge özgün bir değerlendirme yardımıdır, kıyas sonucu değildir. Toplu işi büyütmeden önce gözlenen kanıtla doldurun.

Görsel açıdan etkileyici aday kişiyi ayırt ettiren özelliği değiştiriyor, girdinin desteklemediği okunabilir yazı oluşturuyor veya önemli kenarı kaydırıyorsa reddedin. Bir miktar yumuşaklık daha sadık sonuç olabilir. Toleransı genel keskinlik puanından değil, gerçek gösterim amacından belirleyin.

Eldeki kanıtın gösterebildiği hatayı teşhis edin

Kalite ayarlarını artırmadan önce özgün girdiyi, günlüğü, Q/F seçimini, komut metinlerini, örneklemeyi, renk düzeltmeyi ve son PNG’yi inceleyin. Standart CLI, açıklama görüntüsünü kaydetmediği için onun ilk nerede saptığını göstermez. Elle düzeltilmiş açıklama girme argümanı da yoktur. Özel açıklama veya ara görüntü dışa aktarımı için ayrı inceleme ve testten geçen betik değişikliği gerekir. CLI ve açıklama davranışı

Bunlar ölçülmüş hata oranları değil, tanı varsayımlarıdır. Hatanın elde edilebilen ilk kanıtını ve tam komutunu saklayın. Günlükler ve kayıtlı dosyalar nedeni ayırmıyorsa bilinmiyor diye kaydedin; görünmeyen bir iç aşamayı kontrol ettiğinizi söylemeyin.

İşin tamamı için kaynak ve gizlilik ölçümü yapın

Referans betik CUDA odaklıdır. Görünür en az iki GPU olduğunda SUPIR ile LLaVA'yı ayrı cihazlara, tek GPU olduğunda aynı cihaza yerleştirir; CUDA yoksa çıkar. Cihaz yerleşimi README, Gradio için daha az bellek kullanan ve daha yavaş bir örneği difüzyon için 12 GB, LLaVA için 16 GB notuyla verir. Bu yorum evrensel asgari değildir ve tam iş yükünün tek 12 GB cihazda çalıştığını kanıtlamaz. Gradio örnekleri

Model dosyalarını indirmeyi, başlatmayı, açıklama üretimini, örneklemeyi, kaydı ve insan incelemesini ayrı ölçün. Girdi ve çıktı boyutlarını, Q/F seçimini, adım ile örnek sayısını, veri tiplerini, döşeme seçeneklerini, cihaz modelini, tepe belleği ve geçen süreyi kaydedin. İncelenen otomatik kodlayıcı fp32 veya bf16 kabul eder ve NaN hata yolu nedeniyle fp16’yı reddeder. Difüzyon hassasiyeti ayrı ayarlanır. Bu, her veri tipi birleşimini veya donanımı doğrulamaz. Modelin veri tipi işlemleri

Özel veya lisanslı görseller için yerel işlemenin gerekip gerekmediğine karar verin. Kendi sunucunuzda çalışan depo, girdi haklarını, portre iznini veya bağımlılık telemetrisini çözmez. Resmi Gradio örneği geçmiş günlüğünü açabilir; hassas içerikte etkin günlükleri inceleyin. Geçmiş kaydı seçeneği Barındırılan hizmetlerin gizlilik ve saklama koşulları ayrıca kontrol edilmelidir.

Sonraki adımı kaydedilmiş kanıttan seçin

Yalnız kontrollü bir aday hedeflenen gösterimi iyileştiriyor, kaynakla desteklenen yapıyı koruyor, ağırlık ve kullanım izni netleşmiş ve düzeltme ile inceleme maliyeti kabul edilebiliyorsa ilerleyin. Kaynağı, yapılandırmayı, açıklamaları, komutları, günlükleri, kabul edilen ve reddedilen çıktıları ve açıklama notunu birlikte saklayın.

Sonuç kritik ayrıntı uyduruyor, ağırlık veya diğer gerekli haklar belirsiz kalıyor, kaynak sınırını aşıyor veya sürekli elle düzeltme istiyorsa durun. Geleneksel yeniden örnekleme, gürültü giderme, elle rötuş, daha iyi tarama veya hiç restorasyon yapmamak daha iyi olabilir. Bu inceleme SUPIR'i diğer modellerle sıralamaz ve makaledeki deneyleri yeniden üretmez.

Eksik yeteneği açıkça belirttikten sonra model dizinini kullanın. Alternatifleri aynı izinli girdi ve kabul çizelgesiyle karşılaştırın. Herkese açık depo, keskin görsel veya tamamlanan komut, işe uygunluğu tek başına kanıtlamaz.