Safetensors vs .ckpt at .pt: paano ligtas na mag-download ng AI models at i-verify gamit ang SHA-256
Pangkalahatang-ideya
Dati, ang mga model files ay Python pickles (.ckpt, .pt, .pth, .bin). Ang pickle ay isang serialized Python object, at kapag na-load ito, pwedeng magpatakbo ng kahit anong code na nakapaloob dito; may ilang malisyosong checkpoints na nakita sa mga sharing sites noong 2023 at 2024. Ang .safetensors format, na ginawa ng Hugging Face, ay naglalaman lang ng tensors at isang JSON header, kaya hindi ito pwedeng magpatakbo ng code kapag na-load. Mas gusto ng mga kasalukuyang UI ang format na ito at karamihan ay hindi tumatanggap ng pickles o sinusuri ito. Kung ang modelo ay available lang bilang .ckpt, mas mainam na kumuha ng converted safetensors mula sa pinagkakatiwalaang source, o i-convert ito sa sarili mo sa isang sandbox.
Hindi lang tungkol sa code ang kaligtasan. Ang pinalitan ng pangalan, naputol, o pinalit na file ay magbibigay ng maling resulta at masasayang ang oras mo. Ang solusyon dito ay ang hash: ang SHA-256 ng inilathalang file, na makikita sa bawat pahina ng modelo dito kasama ang mas maikling AutoV2 hash (unang sampung karakter) na ipinapakita ng A1111 at Civitai. I-compute ang hash ng na-download mo at i-compare; kapag tugma, ibig sabihin ay eksaktong bytes ang nakuha mo mula sa author, kapag hindi, may nagbago sa pagitan nila at sa iyo.
Mahalaga rin ang mga site. Mag-download mula sa sariling pahina ng author (Hugging Face repository o Civitai model page na naka-link mula dito) kaysa sa mga re-upload sites; gamitin ang hash para i-verify ang mga mirror at torrent. O kaya ay iwasan na lang ang pag-download: ang mga cloud partners na naka-link sa bawat pahina ng modelo ay naka-host na ng verified files.
Sanggunian
Pangalan | Uri | Ano ito |
|---|---|---|
.safetensors | format | Tensors kasama ang JSON header; walang pwedeng patakbuhin na code; memory-mappable, mabilis mag-load. Standard mula 2023. |
.ckpt / .pt / .pth / .bin | format | Python pickle; pwedeng magpatakbo ng code kapag na-load. Iwasan mula sa hindi kilalang sources; ang mga modernong UI ay nagbabala o nagba-block. |
.gguf | format | |
SHA-256 | hash | 64 hex characters na nag-iidentify ng eksaktong file. Makikita sa pahina ng modelo dito sa ilalim ng listahan ng file. |
AutoV2 | hash | |
certutil -hashfile FILE SHA256 | Windows | Built-in na hashing command; sa PowerShell: Get-FileHash FILE. |
shasum -a 256 FILE | Mac / Linux | Built-in; sha256sum FILE sa Linux. |
Pickle scanner | tool | picklescan o built-in scan ng UI na nag-uulat ng kahina-hinalang imports sa .ckpt files; hindi garantisadong malinis kapag walang nakita. |
Hakbang-hakbang
- Buksan ang modelo dito sa site at kopyahin ang SHA-256 (o AutoV2) mula sa listahan ng file; tandaan ang laki ng file.
- Sundan ang source link papunta sa pahina ng author at i-download ang .safetensors na variant. Kung .ckpt lang ang meron, hanapin ang safetensors conversion sa parehong pahina o mula sa kilalang converter account.
- Suriin muna ang laki: kapag mas maliit ng malaki kaysa sa nakalista, putol ang file.
- I-hash ito: sa Windows PowerShell, gamitin ang Get-FileHash .\model.safetensors; sa Mac/Linux, shasum -a 256 model.safetensors. I-compare ang unang 10 characters sa AutoV2 sa pahina ng modelo, o ang buong string sa SHA-256.
- Kapag tugma: ilipat ang file sa tamang folder (checkpoints, loras, controlnet, vae) at i-refresh ang UI. Ipinapakita ng A1111 at Forge ang AutoV2 sa tabi ng pangalan ng modelo; dapat tugma rin ito.
- Kapag hindi tugma: burahin at i-download muli mula sa pahina ng author; kung iba ang file ng author sa listahan natin, ibig sabihin na-update ng author ang file (suriin ang version) o luma na ang record natin; gamitin ang Telegram community link sa FAQ para i-report ito.
- Para sa .ckpt, kailangan mong: patakbuhin ang pickle scan, i-load lang ito sa environment na pwedeng i-rebuild, at i-convert agad sa safetensors (may converters ang ComfyUI at A1111) para hindi mo na muling i-load ang pickle.
- Para iwasan lahat ng ito, pindutin ang PirateDiffusion o BitVector button sa pahina ng modelo; ang naka-host na file ay ang verified na file.
Mga halimbawa
Pag-hash sa Windows
Get-FileHash "C:\ComfyUI\models\checkpoints\juggernautXL_v9.safetensors"
certutil -hashfile "C:\ComfyUI\models\checkpoints\juggernautXL_v9.safetensors" SHA256
Pag-hash sa Mac o Linux
shasum -a 256 ~/ComfyUI/models/checkpoints/juggernautXL_v9.safetensors
Pag-convert ng .ckpt minsan, gamit ang Python
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")
Mga tip
- Ipinapakita ng Hugging Face ang SHA-256 ng bawat file sa repository (i-click ang file, "Copy SHA256"); ipinapakita ng Civitai ang AutoV2 at SHA-256 sa file details. Dapat pareho ito sa nakalista dito sa pahina ng modelo.
- Kapag na-quarantine ng antivirus habang nagda-download, nagiging putol ang file kaya hindi pumasa sa hash; i-whitelist ang models folder mo kaysa i-disable ang scans.
- Ang pag-check ng hash ay paraan din para mahuli kapag ang torrent o mirror ay nagse-serve ng lumang version na may parehong pangalan.
- Hindi pinoprotektahan ng safetensors laban sa masamang modelo, kundi laban lang sa code; ang mga halimbawa sa pahina ng modelo at heat score ang nagsasabi kung sulit ang file.
- Ang mga LoRA files mula sa trainers ay palaging safetensors; kapag LoRA ay .pt, dapat magduda ka maliban na lang kung ito ay embedding mula 2022.
- Magtabi ng text file ng mga hash malapit sa models folder mo; makakatulong ito para maalala mo pa rin kung anong "v3" ang meron ka kahit isang taon na ang lumipas.
Pag-aayos ng problema
Hindi tugma ang hash sa pahina ng modelo
Bakit ito nangyayari
Naputol na download, ibang version, o pinalitang file.
Paano ayusin
I-compare ang laki, i-download muli mula sa author, suriin ang version; i-report ang luma na listahan gamit ang community link.
Hindi tinatanggap ng UI ang .ckpt
Bakit ito nangyayari
Pickle safety setting.
Paano ayusin
Humanap o gumawa ng safetensors version; huwag i-disable ang safety setting.
Nag-ulat ang pickle scan ng kahina-hinalang import
Bakit ito nangyayari
Code sa pickle, malisyoso o kakaiba lang.
Paano ayusin
Huwag i-load ito. Hanapin ang safetensors release.
Mas doble ang laki ng download kaysa sa nakalista
Bakit ito nangyayari
fp32 version samantalang fp16 ang nakalista, o buong checkpoint imbes na LoRA.
Paano ayusin
Piliin ang variant na tugma sa listahan; parehong valid pero iba ang kilos.
Nagbubukas ang file pero basura ang mga larawan
Bakit ito nangyayari
Maling pamilya o corrupt pero kumpleto ang laki ng file.
Paano ayusin
I-verify ang hash; i-load gamit ang checkpoint ng tamang pamilya.
Mga tanong
Ligtas ba palaging safetensors?
Ligtas sa code execution, oo. Hindi nito sinasabi ang kalidad o lisensya ng modelo; galing iyon sa pahina ng modelo.
Bakit may mga repositories pa rin na may .bin o .pt?
Mga lumang release at ilang research code. Karamihan may safetensors din; gamitin iyon.
Nagbabago ba ang hash kapag pinalitan ko ang pangalan ng file?
Hindi. Ang hash ay mula sa laman; hindi mahalaga ang pangalan.
Paano naman ang GGUF files?
Tensor format din ito na walang code execution; i-hash mo rin ng pareho.
Saan nanggagaling ang mga hash dito sa site?
Galing ito sa mga inilathalang file ng mga author noong inilista; ipinapakita ito para ma-verify ang download, at pwedeng mag-report ng corrections sa community chat.
Mga link at pinagmulan
- Safetensors documentation
- picklescan
- Hugging Face security notes on pickles
- Models browser
- PirateDiffusionAD
Mga model sa gabay na ito
Isinulat ni
Nag-aalaga ng imbentaryo: bawat LoRA, bawat quant, bawat file na pinangalanang final_v2_REAL.safetensors. Sinusukat ang hardware sa dami ng Wan renders bago maghapunan. Ibibigay ang VRAM figure, tapos sasabihin na mali ito dahil may bukas kang Chrome. Buksan ang weights o hindi ito naipadala.
Lahat ng gabay ni Quartermaster
Mga kaugnay na gabay
Paano mag-install ng LoRA: mga folder, tsek ng file at unang gamit sa ComfyUI, Forge, Automatic1111 at Draw Things
Set 24, 2025
Checkpoint vs LoRA vs embedding vs ControlNet: ano ang ginagawa ng bawat file
Okt 8, 2025
Ano ang Hugging Bay? Isang mirror index para sa open models, at paano i-verify ang download gamit ang mga hash nito
Okt 5, 2026
Ano ang LoRA at paano ito gamitin sa ComfyUI, Forge, Automatic1111 at sa cloud
May 20, 2026
Open weights vs open source vs API-only: ano talaga ang pwede mong gawin
Hul 29, 2026
Ano ang GGUF file? Ipinaliwanag ang mga quantized na modelo (Q4, Q8, fp8, NF4)
Ago 26, 2026
Mga alternatibo sa Civitai: saan makakahanap at makakadownload ng AI models sa 2026
Set 16, 2026
Higit pang gabay
Mga error sa ComfyUI at paano ayusin: pulang nodes, nawawalang mga modelo, CUDA out of memory
May 12, 2026
CUDA out of memory: gaano karaming VRAM ang kailangan ng bawat AI model at paano ito mapasya
May 18, 2026
Mga Error at Ayos sa Stable Diffusion WebUI Forge (Flux, SDXL, mababang VRAM)
May 16, 2026
Mga kinakailangan sa VRAM para sa bawat sikat na AI image at video model (2026): full precision, FP8 at GGUF
Okt 6, 2026
Paano gumagana ang mga generative AI image models: diffusion, latents at text encoders na ipinaliwanag nang simple
Ago 28, 2025
