SimpliGen Docs
Models & LoRAs

Scarica i token (HuggingFace e Civitai)

Configura i token gratuiti richiesti da alcuni download di modelli e risolvi il loop "chiede di nuovo la chiave API".

Alcuni modelli sono ospitati dietro un muro di account gratuiti. SimpliGen li scarica per te, ma l'host richiede un token di accesso personale:

  • HuggingFace: richiesto per i modelli gated (ad esempio Flux Klein). Gratuito.
  • Civitai: richiesto per scaricare LoRA e modelli della comunità da Civitai. Gratuito.

Entrambi vengono inseriti una volta in Settings e memorizzati.

Token HuggingFace, passo dopo passo

  1. Crea un account gratuito su huggingface.co.
  2. Apri la pagina Access Tokens (Settings -> Access Tokens) e fai clic su New Token.
  3. Scegli il tipo di token classico Read. Non utilizzare un token con granularità fine; questi spesso falliscono a meno che tutti i permessi non siano impostati correttamente.
  4. Copia il token in SimpliGen quando un download lo richiede (o in Settings).

Modelli gated: il passaggio extra che tutti ignorano

I modelli gated (Flux Klein e altri) richiedono inoltre di accettare i termini di licenza del modello sul sito web di HuggingFace; il token da solo non è sufficiente.

  1. Apri la pagina del modello su huggingface.co mentre sei connesso con lo stesso account a cui appartiene il token.
  2. Fai clic sulla richiesta "accetta / richiedi accesso" nella pagina del modello.
  3. Attendi il messaggio "You have been granted access" (solitamente istantaneo).
  4. Riprova il download in SimpliGen.

Bloccato in un loop 'inserisci la chiave API'?

Il download che chiede di nuovo la tua chiave ancora e ancora quasi sempre significa uno di questi: (1) i termini sono stati accettati con un account HuggingFace diverso da quello del token, (2) il token ha granularità fine invece di essere un classico Read (crea un nuovo token classico Read), oppure (3) il modello richiede l'accettazione dei termini su più di un repository: Flux Klein ha un repository base e un repository fp8 separato, ed entrambi necessitano di accesso. Per verificare, prova a scaricare il file direttamente dalla pagina di HuggingFace nel tuo browser: se fallisce lì, fallirà anche in SimpliGen.

Token Civitai

  1. Crea un account gratuito su civitai.com.
  2. Apri le tue impostazioni account, scorri fino a API Keys e crea una chiave.
  3. Incollala in SimpliGen quando richiesto.

Nota: incollare un URL di una pagina Civitai in SimpliGen come fonte di download non è supportato. Per utilizzare un modello di Civitai che non fa parte di un preset, scarica il file nel tuo browser e aggiungilo manualmente (LoRA: tramite il gestore LoRA).

Fallback di download manuale

Se un download continua a fallire, puoi recuperare il file nel tuo browser e rilasciarlo nella cartella dei modelli del motore, %APPDATA%\simpligen\engine\models\, utilizzando il layout standard di ComfyUI (diffusion_models, checkpoints, loras, text_encoders, vae, ...). Riavvia il motore dopo in modo che rilevi il file.