Safetensors vs .ckpt ve .pt: AI modellerini güvenli indirme ve SHA-256 ile doğrulama

Q: Hash model sayfasıyla uyuşmuyor

Eksik indirme, farklı sürüm veya değiştirilmiş dosya. Boyutu karşılaştır, yazardan tekrar indir, sürümü kontrol et; eski listeyi topluluk linkinden bildir.

Q: Arayüz .ckpt yüklemeyi reddediyor

Pickle güvenlik ayarı. Safetensors versiyonu bul veya oluştur; güvenlik ayarını kapatma.

Q: Pickle taraması şüpheli import raporladı

Pickle içindeki kod, kötü amaçlı veya alışılmadık. Yükleme. Safetensors sürümünü bul.

Q: Dosya açılıyor ama saçma görüntüler veriyor

Yanlış aile veya bozuk ama tam boyutlu dosya. Hash’i doğrula; doğru aileden checkpoint ile yükle.

Konu: Hatalar ve çözümler

Quartermaster tarafından

1 Nis 2026 tarihinde yayımlandı

Genel bakış

Model dosyaları eskiden Python pickle formatındaydı (.ckpt, .pt, .pth, .bin). Pickle, seri hale getirilmiş bir Python nesnesidir ve yüklenirken içine gömülü rastgele kod çalıştırabilir; 2023 ve 2024’te paylaşım sitelerinde birkaç kötü amaçlı checkpoint bulundu. Hugging Face tarafından oluşturulan .safetensors formatı sadece tensörler ve JSON başlığı içerir, bu yüzden yüklenirken kod çalıştırmaz. Güncel tüm arayüzler bunu tercih eder ve çoğu pickle dosyalarını varsayılan olarak reddeder veya tarar. Model sadece .ckpt olarak varsa, güvenilir bir kaynaktan dönüştürülmüş safetensors versiyonunu tercih et ya da kendin bir sandbox ortamında dönüştür.

Güvenlik sadece kodla ilgili değil. Yeniden adlandırılmış, eksik veya değiştirilmiş bir dosya yanlış sonuç verir ve saatlerce zaman kaybettirir. Çözüm hash: yayınlanan dosyanın SHA-256’sı, bu sitedeki her model sayfasında dosya listesi altında gösterilir, ayrıca A1111 ve Civitai’nin gösterdiği daha kısa AutoV2 hash (ilk on karakter) da vardır. İndirdiğin dosyanın hash’ini hesapla ve karşılaştır; eşleşirse yazarın yayınladığı tam dosyaya sahipsin, uyuşmazsa dosya seninle yazar arasında değişmiş demektir.

İndirme kaynakları da önemli. Dosyayı yazarın kendi sayfasından indir (Hugging Face deposu veya buradaki model sayfasından bağlantılı Civitai modeli) re-upload sitelerinden değil; aynalar ve torrentler için hash ile doğrula. Ya da hiç indirme: her model sayfasından bağlantılı bulut ortakları doğrulanmış dosyaları zaten barındırıyor.

Başvuru

Ad	Tür	Ne olduğu
.safetensors	format	Tensörler ve JSON başlığı içerir; kod çalıştırma imkanı yoktur; belleğe eşlenebilir, hızlı yüklenir. 2023’ten beri standart.
.ckpt / .pt / .pth / .bin	format	Python pickle; yüklenirken kod çalıştırabilir. Bilinmeyen kaynaklardan kaçın; modern arayüzler uyarır veya engeller.
.gguf	format	Meta verili kuantize tensörler (llama.cpp kökenli); kod çalıştırmaz. GGUF Flux, Qwen ve LLM’lerde kullanılır.
SHA-256	hash	Tam dosyayı tanımlayan 64 karakterli onaltılık kod. Bu sitedeki model sayfasında dosya listesi altında.
AutoV2	hash	SHA-256’nın ilk 10 karakteri, A1111, Forge ve Civitai’de böyle gösterilir.
certutil -hashfile FILE SHA256	Windows	Yerleşik hash komutu; PowerShell’de: Get-FileHash FILE.
shasum -a 256 FILE	Mac / Linux	Yerleşik; Linux’ta sha256sum FILE.
Pickle scanner	tool	picklescan veya arayüzün yerleşik tarayıcısı .ckpt dosyalarında şüpheli importları raporlar; temiz tarama garanti değildir.

Adım adım

Bu sitedeki model sayfasını aç ve dosya listesinden SHA-256 (veya AutoV2) değerini kopyala; dosya boyutunu not et.
Kaynak bağlantısına tıkla, yazarın sayfasına git ve .safetensors versiyonunu indir. Sadece .ckpt varsa, aynı sayfada veya bilinen dönüştürücü hesaplarda safetensors versiyonu ara.
Önce boyutu kontrol et: listelenenden çok küçükse dosya eksik indirilmiş demektir.
Hash’i hesapla: Windows PowerShell’de Get-FileHash .\model.safetensors; Mac/Linux’ta shasum -a 256 model.safetensors. İlk 10 karakteri model sayfasındaki AutoV2 ile veya tümünü SHA-256 ile karşılaştır.
Eşleşirse: dosyayı doğru klasöre taşı (checkpoints, loras, controlnet, vae) ve arayüzü yenile. A1111 ve Forge model adının yanında AutoV2’yi gösterir; onun da eşleşmesi gerekir.
Eşleşmezse: dosyayı sil ve yazarın sayfasından tekrar indir; eğer yazarın dosyası bizim listemizden farklıysa, yazar dosyayı güncellemiş (versiyonu kontrol et) ya da kaydımız eski; bunu topluluk linkinden Telegram’da bildir.
.ckpt için: pickle taraması yap, sadece yeniden oluşturabileceğin bir ortamda yükle ve hemen safetensors’a dönüştür (ComfyUI ve A1111’de dönüştürücüler var) böylece pickle’ı bir daha yüklemezsin.
Bütün bunları atlamak için model sayfasındaki PirateDiffusion veya BitVector butonuna bas; barındırılan dosya doğrulanmış olan.

Örnekler

Windows’ta hash hesaplama

Get-FileHash "C:\ComfyUI\models\checkpoints\juggernautXL_v9.safetensors"

certutil -hashfile "C:\ComfyUI\models\checkpoints\juggernautXL_v9.safetensors" SHA256

Mac veya Linux’ta hash hesaplama

shasum -a 256 ~/ComfyUI/models/checkpoints/juggernautXL_v9.safetensors

Python’da .ckpt dosyasını bir kere dönüştürmek

from safetensors.torch import save_file; import torch

sd = torch.load("model.ckpt", map_location="cpu", weights_only=True)["state_dict"]; save_file(sd, "model.safetensors")

İpuçları

Hugging Face her dosyanın SHA-256’sını gösterir (dosyaya tıkla, "Copy SHA256"); Civitai dosya detaylarında AutoV2 ve SHA-256 gösterir. İkisi de bu sitedeki model sayfasındakiyle aynı olmalı.
Antivirüs indirme sırasında dosyayı karantinaya alırsa dosya eksik olur ve hash tutmaz; taramaları kapatmak yerine modeller klasörünü beyaz listeye ekle.
Hash kontrolü, torrent veya aynaların aynı isimle eski sürüm vermesini de yakalar.
Safetensors kötü bir modeli korumaz, sadece kod çalıştırmayı engeller; model sayfasındaki örnekler ve heat skoru dosyanın değerini gösterir.
Eğitmenlerden gelen LoRA dosyaları hep safetensors olur; .pt olarak sunulan LoRA şüphelidir, 2022 dönemi embedding değilse.
Modeller klasörünün yanında hash’lerin olduğu bir metin dosyası tut; bir yıl sonra hangi "v3" olduğunu unutursun.

Hash’i doğrula; doğru aileden checkpoint ile yükle.

Sorular

Safetensors her zaman güvenli mi?

Kod çalıştırmaya karşı evet. Modelin kalitesi veya lisansı hakkında bilgi vermez; bunlar model sayfasından gelir.

Neden bazı depolar hala .bin veya .pt gönderiyor?

Eski sürümler ve bazı araştırma kodları. Çoğunda safetensors da var; onu kullan.

Dosyanın adını değiştirince hash değişir mi?

Hayır. Hash dosya içeriğinin özeti; isim önemli değil.

GGUF dosyaları ne durumda?

Kod çalıştırmayan bir tensör formatı; aynı şekilde hash’le.

Bu sitedeki hash’ler nereden geliyor?

Yazarların yayınladığı dosyalardan, listeleme anında; indirmeyi doğrulaman için gösterilir, düzeltmeler topluluk sohbetiyle yapılır.

Bağlantılar ve kaynaklar

Bu rehberdeki modeller

Stable Diffusion XL 1.0 Modelleri

Flux Modelleri

Stable Diffusion 1.5 Modelleri

Yazan

Quartermaster

Envanteri tutar: her LoRA, her quant, birisi final_v2_REAL.safetensors olarak yeniden adlandırmış her dosya. Donanımı, akşam yemeğinden önce kaç Wan render sığdığına göre ölçer. Size VRAM miktarını verir, sonra Chrome açık olduğu için yanlış olduğunu söyler. Açık ağırlıklar yoksa gönderilmemiştir.

Quartermaster tarafından tüm rehberler

Bir LoRA nasıl kurulur: klasörler, dosya kontrolleri ve ComfyUI, Forge, Automatic1111 ve Draw Things'de ilk kullanım

24 Eyl 2025

Checkpoint, LoRA, embedding ve ControlNet: hangi dosya ne işe yarar

8 Eki 2025

The Hugging Bay Nedir? Açık modeller için bir ayna dizini ve indirmeyi hash’leriyle nasıl doğrularsın

5 Eki 2026

LoRA nedir ve ComfyUI, Forge, Automatic1111 ve bulutta nasıl kullanılır?

20 May 2026

Açık ağırlıklar vs açık kaynak vs sadece API: aslında ne yapmana izin veriliyor

29 Tem 2026

GGUF dosyası nedir? Kuantize modellerin açıklaması (Q4, Q8, fp8, NF4)

26 Ağu 2026

Civitai alternatifleri: 2026'da AI modellerini nereden bulup indirebilirsin

16 Eyl 2026

Diğer rehberler

ComfyUI hataları ve nasıl düzeltilir: kırmızı düğümler, eksik modeller, CUDA bellek yetersizliği

12 May 2026

CUDA bellek yetersizliği: Her AI modelinin ne kadar VRAM ihtiyacı var ve nasıl sığdırılır

18 May 2026

Stable Diffusion WebUI Forge hataları ve çözümleri (Flux, SDXL, düşük VRAM)

16 May 2026

Her Popüler AI Görüntü ve Video Modeli için VRAM Gereksinimleri (2026): Tam Hassasiyet, FP8 ve GGUF

6 Eki 2026

Üretken AI görüntü modelleri nasıl çalışır: difüzyon, latentler ve metin kodlayıcıları basitçe açıklandı

28 Ağu 2025