다운로드 토큰 (HuggingFace & Civitai)
모델 다운로드에 필요한 무료 토큰을 설정하고, "API 키를 다시 요청" 루프 문제를 해결하세요.
일부 모델은 무료 계정 인증이 필요한 호스팅 서비스에서 제공됩니다. SimpliGen이 모델을 다운로드할 때 호스트는 개인 액세스 토큰을 요구합니다:
- HuggingFace: 제한된 모델(예: Flux Klein)에 필요합니다. 무료입니다.
- Civitai: Civitai에서 LoRA 및 커뮤니티 모델을 다운로드할 때 필요합니다. 무료입니다.
두 토큰 모두 설정에서 한 번만 입력하면 저장됩니다.
HuggingFace 토큰, 단계별 설명
- huggingface.co에서 무료 계정을 만들거나 가입하세요.
- 액세스 토큰 페이지(설정 -> 액세스 토큰)를 열고 새 토큰을 클릭하세요.
- 클래식 읽기 토큰 유형을 선택하세요. 세분화된 토큰은 사용하지 마세요. 세분화된 토큰은 모든 권한이 올바르게 설정되지 않으면 실패하는 경우가 많습니다.
- 다운로드에서 요청할 때 SimpliGen에 토큰을 복사하세요(또는 설정에서).
제한된 모델: 모두가 놓치는 추가 단계
제한된 모델(Flux Klein 등)을 사용하려면 HuggingFace 웹사이트에서 모델의 라이선스 약관을 수락해야 합니다. 토큰만으로는 부족합니다.
- huggingface.co의 모델 페이지를 토큰이 속한 동일한 계정으로 로그인한 상태에서 열어주세요.
- 모델 페이지의 "동의 / 액세스 요청" 프롬프트를 클릭하세요.
- "액세스 권한이 부여되었습니다" 메시지를 기다리세요(보통 즉시 표시됩니다).
- SimpliGen에서 다운로드를 다시 시도하세요.
'API 키 입력' 루프에 갇혔나요?
다운로드가 계속해서 키를 요청하는 경우는 거의 항상 다음 중 하나입니다: (1) 약관이 토큰과 다른 HuggingFace 계정으로 수락된 경우, (2) 토큰이 클래식 읽기 토큰이 아닌 세분화된 토큰인 경우(새로운 클래식 읽기 토큰을 만드세요), 또는 (3) 모델이 두 개 이상의 저장소에서 약관을 수락해야 하는 경우: Flux Klein은 기본 저장소와 별도의 fp8 저장소가 있으며 둘 다 액세스 권한이 필요합니다. 확인하려면 브라우저의 HuggingFace 페이지에서 파일을 직접 다운로드해 보세요. 그곳에서 실패하면 SimpliGen도 실패할 것입니다.
Civitai 토큰
- civitai.com에서 무료 계정을 만드세요.
- 계정 설정을 열고 API 키로 스크롤한 다음 키를 생성하세요.
- 메시지가 표시되면 SimpliGen에 붙여넣으세요.
참고: Civitai 페이지 URL을 SimpliGen에 다운로드 소스로 붙여넣기는 지원되지 않습니다. 프리셋에 포함되지 않은 Civitai 모델을 사용하려면 브라우저에서 파일을 다운로드한 다음 수동으로 추가하세요(LoRA: LoRA 관리자를 통해).
수동 다운로드 대체 방법
다운로드가 계속 실패하는 경우 브라우저에서 파일을 가져온 다음 엔진의 모델 폴더 %APPDATA%\simpligen\engine\models\에 표준 ComfyUI 레이아웃(diffusion_models, checkpoints, loras, text_encoders, vae, ...)을 사용하여 드래그하여 놓으세요. 엔진이 파일을 인식하도록 다시 시작하세요.