Télécharger les jetons (HuggingFace & Civitai)
Configurez les jetons gratuits que certains téléchargements de modèles nécessitent, et corrigez la boucle « demande à nouveau une clé API ».
Certains modèles sont hébergés derrière un mur de compte gratuit. SimpliGen les télécharge pour vous, mais l'hôte nécessite un jeton d'accès personnel :
- HuggingFace : requis pour les modèles gated (par exemple Flux Klein). Gratuit.
- Civitai : requis pour télécharger les LoRAs et les modèles communautaires depuis Civitai. Gratuit.
Les deux sont entrés une seule fois dans Paramètres et mémorisés.
Jeton HuggingFace, étape par étape
- Créez un compte gratuit sur huggingface.co.
- Ouvrez la page Tokens d'accès (Paramètres -> Tokens d'accès) et cliquez sur Nouveau jeton.
- Choisissez le type de jeton classique Read. N'utilisez pas de jeton fine-grained, car ils échouent souvent à moins que chaque permission ne soit définie correctement.
- Copiez le jeton dans SimpliGen lorsqu'un téléchargement le demande (ou dans Paramètres).
Modèles gated : l'étape supplémentaire que tout le monde oublie
Les modèles gated (Flux Klein et autres) vous obligent également à accepter les conditions de licence du modèle sur le site HuggingFace ; le jeton seul ne suffit pas.
- Ouvrez la page du modèle sur huggingface.co en étant connecté au même compte auquel appartient votre jeton.
- Cliquez sur l'invite « accepter / demander l'accès » sur la page du modèle.
- Attendez « Vous avez obtenu l'accès » (généralement instantané).
- Réessayez le téléchargement dans SimpliGen.
Bloqué dans une boucle « entrez la clé API » ?
Le téléchargement qui demande votre clé encore et encore signifie presque toujours l'une de ces raisons : (1) les conditions ont été acceptées avec un compte HuggingFace différent de celui du jeton, (2) le jeton est fine-grained au lieu de classique Read (créez un nouveau jeton classique Read), ou (3) le modèle nécessite que les conditions soient acceptées sur plus d'un dépôt : Flux Klein dispose d'un dépôt de base et d'un dépôt fp8 séparé, et les deux nécessitent un accès. Pour vérifier, essayez de télécharger le fichier directement sur la page HuggingFace dans votre navigateur : si cela échoue, SimpliGen échouera aussi.
Jeton Civitai
- Créez un compte gratuit sur civitai.com.
- Ouvrez vos paramètres de compte, faites défiler jusqu'à Clés API, et créez une clé.
- Collez-la dans SimpliGen lorsque vous y êtes invité.
Remarque : coller une URL de page Civitai dans SimpliGen comme source de téléchargement n'est pas supporté. Pour utiliser un modèle Civitai qui ne fait pas partie d'un preset, téléchargez le fichier dans votre navigateur et ajoutez-le manuellement (LoRAs : via le gestionnaire de LoRA).
Recours de téléchargement manuel
Si un téléchargement continue d'échouer, vous pouvez récupérer le fichier dans votre navigateur et le placer dans le dossier des modèles du moteur, %APPDATA%\simpligen\engine\models\, en utilisant la disposition ComfyUI standard (diffusion_models, checkpoints, loras, text_encoders, vae, ...). Redémarrez le moteur après pour qu'il détecte le fichier.