Model
.ai
sinusubaybayan ang mga open AI model

Safetensors vs .ckpt at .pt: paano ligtas na mag-download ng AI models at i-verify gamit ang SHA-256

Paksa: Mga error at solusyon
Ni Quartermaster
Inilathala Abr 1, 2026

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
Quantised tensors na may metadata (mula sa llama.cpp lineage); walang code execution. Ginagamit para sa GGUF Flux, Qwen at LLMs.
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
Unang 10 characters ng SHA-256, na ipinapakita ng A1111, Forge at Civitai.
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

  1. Buksan ang modelo dito sa site at kopyahin ang SHA-256 (o AutoV2) mula sa listahan ng file; tandaan ang laki ng file.
  2. 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.
  3. Suriin muna ang laki: kapag mas maliit ng malaki kaysa sa nakalista, putol ang file.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
  8. 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 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

Higit pang gabay