Descargar tokens (HuggingFace y Civitai)
Configura los tokens gratuitos que algunos descargas de modelos requieren y soluciona el bucle de "pide clave API de nuevo".
Algunos modelos están alojados detrás de un muro de cuenta gratuita. SimpliGen los descarga por ti, pero el host requiere un token de acceso personal:
- HuggingFace: requerido para modelos gated (por ejemplo Flux Klein). Gratuito.
- Civitai: requerido para descargar LoRAs y modelos de comunidad de Civitai. Gratuito.
Ambos se ingresan una sola vez en Settings y se recuerdan.
Token de HuggingFace, paso a paso
- Crea una cuenta gratuita en huggingface.co.
- Abre la página de Access Tokens (Settings -> Access Tokens) y haz clic en New Token.
- Elige el tipo de token clásico Read. No uses un token fine-grained; estos a menudo fallan a menos que todos los permisos estén configurados correctamente.
- Copia el token en SimpliGen cuando una descarga lo solicite (o en Settings).
Modelos gated: el paso extra que todos olvidan
Los modelos gated (Flux Klein y otros) también requieren que aceptes los términos de licencia del modelo en el sitio web de HuggingFace; el token por sí solo no es suficiente.
- Abre la página del modelo en huggingface.co mientras inicias sesión con la misma cuenta a la que pertenece tu token.
- Haz clic en el indicador "agree / request access" en la página del modelo.
- Espera a "You have been granted access" (generalmente instantáneo).
- Reintentar la descarga en SimpliGen.
¿Atrapado en un bucle de 'ingresar clave API'?
La descarga pidiendo tu clave una y otra vez casi siempre significa uno de estos: (1) los términos fueron aceptados con una cuenta de HuggingFace diferente a la del token, (2) el token es fine-grained en lugar de clásico Read (crea un nuevo token clásico Read), o (3) el modelo necesita que aceptes términos en más de un repositorio: Flux Klein tiene un repositorio base y un repositorio fp8 separado, y ambos necesitan acceso. Para verificar, intenta descargar el archivo directamente en la página de HuggingFace en tu navegador: si eso falla, SimpliGen también fallará.
Token de Civitai
- Crea una cuenta gratuita en civitai.com.
- Abre tu configuración de cuenta, desplázate a API Keys y crea una clave.
- Pégala en SimpliGen cuando se te solicite.
Nota: pegar una URL de página de Civitai en SimpliGen como fuente de descarga no es compatible. Para usar un modelo de Civitai que no sea parte de un preset, descarga el archivo en tu navegador y agrégalo manualmente (LoRAs: a través del gestor de LoRA).
Alternativa de descarga manual
Si una descarga sigue fallando, puedes obtener el archivo en tu navegador y soltarlo en la carpeta de modelos del engine, %APPDATA%\simpligen\engine\models\, usando el diseño estándar de ComfyUI (diffusion_models, checkpoints, loras, text_encoders, vae, ...). Reinicia el engine después para que detecte el archivo.