SimpliGen Docs
Models & LoRAs

下载令牌(HuggingFace 和 Civitai)

设置某些模型下载所需的免费令牌,并修复"反复要求 API 密钥"的循环问题。

某些模型托管在免费账户墙后面。SimpliGen 会为您下载它们,但主机需要个人访问令牌:

  • HuggingFace:受门控模型(例如 Flux Klein)需要。免费。
  • Civitai:从 Civitai 下载 LoRA 和社区模型需要。免费。

两个令牌都在设置中输入一次后会被记住。

HuggingFace 令牌,分步骤说明

  1. 在 huggingface.co 创建免费账户。
  2. 打开访问令牌页面(设置 -> 访问令牌)并点击新令牌。
  3. 选择经典的读取令牌类型。不要使用细粒度令牌;除非每项权限设置正确,否则这些通常会失败。
  4. 当下载要求时将令牌复制到 SimpliGen(或在设置中)。

受门控模型:每个人都遗漏的额外步骤

受门控模型(Flux Klein 等)还要求您在 HuggingFace 网站上接受模型的许可条款;仅有令牌是不够的。

  1. 在 huggingface.co 上打开模型页面,使用您的令牌所属的同一账户登录。
  2. 点击模型页面上的"同意/请求访问"提示。
  3. 等待"您已获得访问权限"(通常是即时的)。
  4. 在 SimpliGen 中重试下载。

陷入'输入 API 密钥'循环?

下载反复要求您的密钥几乎总是意味着以下之一:(1)条款是用不同的 HuggingFace 账户接受的,而不是令牌所属的账户;(2)令牌是细粒度的而不是经典读取令牌(创建一个全新的经典读取令牌);或(3)模型需要在一个以上的存储库中接受条款:Flux Klein 有一个基础存储库和一个单独的 fp8 存储库,两者都需要访问权限。要验证,请尝试在浏览器中直接在 HuggingFace 页面上下载文件:如果失败,SimpliGen 也会失败。

Civitai 令牌

  1. 在 civitai.com 创建免费账户。
  2. 打开您的账户设置,滚动到 API 密钥,并创建一个密钥。
  3. 在提示时将其粘贴到 SimpliGen 中。

注意:SimpliGen 不支持将 Civitai 页面 URL 粘贴为下载源。要使用不属于预设的 Civitai 模型,请在浏览器中下载文件并手动添加(LoRA:通过 LoRA 管理器)。

手动下载回退

如果下载持续失败,您可以在浏览器中获取文件并将其放入引擎的模型文件夹 %APPDATA%\simpligen\engine\models\,使用标准 ComfyUI 布局(diffusion_models、checkpoints、loras、text_encoders、vae 等)。之后重启引擎,使其识别该文件。