Point links at the ArcAnima organization

b729afd verified 2 days ago

8.19 kB

# Anima Reference Adapter 사용 가이드

[English](guide.en.md) · **한국어** · [日本語](guide.ja.md)

이 가이드는 ComfyUI에 어댑터를 설치하고, 첫 이미지를 만들고, 프롬프트를 쓰고, 두 캐릭터를 함께 그리고,
설정을 조절하고, 자주 생기는 문제를 해결하는 방법을 순서대로 설명합니다. 작동 원리와 측정 결과는
[README](https://github.com/ArcAnima/ComfyUI-Anima-Ref-Adapter/blob/main/README.ko.md)에 있습니다.

## 1. 준비물

- Anima를 돌릴 수 있는 **ComfyUI**. 이미 Anima로 이미지를 만들고 있다면 준비가 끝난 것입니다.
- [circlestone-labs/Anima](https://huggingface.co/circlestone-labs/Anima)에서 받는 Anima 파일 3개:
  - `anima-base-v1.0.safetensors` → `ComfyUI/models/diffusion_models/`
  - `qwen_3_06b_base.safetensors` → `ComfyUI/models/text_encoders/`
  - `qwen_image_vae.safetensors` → `ComfyUI/models/vae/`
- Anima를 돌리는 데 필요한 VRAM 외에 약 1GB가 더 필요합니다. 1MP 레퍼런스의 key/value를 캐시해 두는 데 쓰입니다.
  8GB인 RTX 3060 Ti에서 테스트했습니다.

어댑터 가중치는 따로 받지 않아도 됩니다. 처음 실행할 때 노드가 직접 받아옵니다.

## 2. 노드 설치

```bash
cd ComfyUI/custom_nodes
git clone https://github.com/ArcAnima/ComfyUI-Anima-Ref-Adapter.git
```

ComfyUI를 재시작합니다. git이 없다면 GitHub에서 ZIP으로 받아(Code → Download ZIP)
`ComfyUI/custom_nodes/`에 압축을 풀면 됩니다.

## 3. 첫 이미지 만들기

1. [`anima_ref_adapter.json`](https://github.com/ArcAnima/ComfyUI-Anima-Ref-Adapter/blob/main/workflows/anima_ref_adapter.json)을
   받아서 ComfyUI 화면에 끌어다 놓습니다. Anima의 기본 text-to-image 워크플로에 **Anima Ref Adapter** 노드
   하나를 모델 로더와 KSampler 사이에 더한 것입니다.
2. **Load Image** 노드에서 레퍼런스 이미지를 고릅니다.
3. 긍정 프롬프트에는 퀄리티 태그를 그대로 두고 장면만 씁니다(4장 참고).
4. 실행합니다. 처음 실행할 때 `anima_ref_adapter_v2_r64.safetensors`(183MB)를 `ComfyUI/models/loras/`로
   받아오고, 그다음부터는 바로 시작합니다.

<img src="https://raw.githubusercontent.com/ArcAnima/ComfyUI-Anima-Ref-Adapter/main/docs/showcase/v2_police.jpg" width="100%" alt="레퍼런스와 결과">

## 4. 프롬프트 쓰는 법

캐릭터(얼굴, 머리, 눈, 의상, 장신구)와 그림체의 상당 부분은 레퍼런스에서 가져옵니다. 나머지는 모두
프롬프트에서 정합니다.

| 쓸 것 | 쓰지 않을 것 |
|---|---|
| 퀄리티 태그: `masterpiece, best quality, score_7, safe,` | 캐릭터 이름 |
| `1girl` 또는 `1boy`, 그리고 `solo` | 작가 태그 |
| 구도: `cowboy shot`, `full body`, `upper body`, `portrait` | 머리·눈·의상 태그(몇 개 정도는 괜찮습니다) |
| 자세와 동작: `sitting`, `lying, on side`, `holding cup` | |
| 표정: `smile`, `sleepy`, `laughing` | |
| 장소·시간·조명: `cafe, indoors, day`, `beach, sunset` | |

예시: `masterpiece, best quality, score_7, safe, 1girl, solo, cowboy shot, sitting, cafe, holding cup, smile, looking at viewer, indoors, window, day`

도움이 되는 점:

- 레퍼런스와 다른 자세를 쓰는 것이 좋습니다. 어댑터는 레퍼런스의 자세를 따라 하지 않도록 학습되었고,
  프롬프트에 자세가 분명하게 적혀 있으면 그 효과가 더 확실해집니다.
- 레퍼런스에 보이지 않는 부분(상반신 이미지의 다리, 의상의 뒷면 등)은 모델이 추측해서 그립니다.
  캐릭터 전체가 보이는 레퍼런스를 쓰면 의상이 더 일정하게 유지됩니다.
- 부정 프롬프트는 Anima 모델 카드에 있는 것을 그대로 쓰면 됩니다.

## 5. 두 캐릭터 함께 그리기

<img src="https://raw.githubusercontent.com/ArcAnima/ComfyUI-Anima-Ref-Adapter/main/docs/showcase/v2_duo_police_mecha.jpg" width="100%" alt="레퍼런스 두 장과 결과">

1. [`anima_ref_adapter_two_characters.json`](https://github.com/ArcAnima/ComfyUI-Anima-Ref-Adapter/blob/main/workflows/anima_ref_adapter_two_characters.json)을
   엽니다. **Load Image** 노드 두 개를 기본 **Image Stitch** 노드가 좌우로 이어 붙입니다.
2. 첫 번째 이미지에는 왼쪽에 올 캐릭터를, 두 번째 이미지에는 오른쪽에 올 캐릭터를 넣습니다.
3. `solo` 대신 `2girls`(또는 `1boy, 1girl`, `2boys`)를 쓰고, 누가 어느 쪽인지 몇 단어로 적습니다.
   `2girls, the girl on the left is a policewoman with black hair over one eye, the girl on the right is a mecha girl with aqua hair and mechanical wings, standing side by side, peace sign, smile, city, street, day`
4. 1216x832처럼 가로가 긴 크기를 씁니다.

두 캐릭터는 섞이지 않고 따로 그려지지만, 그림체는 둘의 중간쯤으로 하나로 맞춰지는 경향이 있습니다.

## 6. 설정

모두 **Anima Ref Adapter** 노드에 있습니다.

| 설정 | 기본값 | 역할 |
|---|---|---|
| `ref_guidance` | 4.5 | 레퍼런스 쪽으로 미는 세기입니다. 캐릭터가 달라지면 5~6으로 올리고, 색이 너무 진해지면 낮춥니다. 1로 두면 모델을 한 번 덜 호출하므로 빠르지만 약해집니다. |
| `correction` | `apg` | 가이던스가 높을 때 색이 과해지는 것을 막습니다. `rescale`도 쓸 수 있고, `none`은 끕니다. |
| `ref_end` | 1.0 | 샘플링 진행 중 이 지점부터 `ref_guidance`를 멈춥니다. 레퍼런스 자체는 끝까지 유지됩니다. 0.6 정도로 두면 거의 같은 그림을 더 빨리 얻습니다. |
| `ref_megapixels` | 1.0 | 레퍼런스를 줄이거나 늘리는 크기입니다. VRAM이 부족하면 0.5~0.7로 낮춥니다. |
| `strength` | 1.0 | 어댑터 LoRA의 세기입니다. |

다른 LoRA(그림체, 디테일 등)는 어댑터 노드 **앞**, 즉 모델 로더와 Anima Ref Adapter 사이에 둡니다.

## 7. 더 빠르게

| 방법 | 설정 | 효과 (RTX 3060 Ti, 832x1216) |
|---|---|---|
| turbo LoRA | Anima base용 turbo LoRA를 어댑터 앞에 두고 10 steps, cfg 1, `ref_guidance` 1 | 67초 → 11초. 레퍼런스 그림체는 약해집니다. |
| `ref_guidance` 1 | 노드에서 설정 | 67초 → 50초 |
| SageAttention | KJNodes의 **Patch Sage Attention**을 어댑터 앞에 둠 | 약 7% |
| EasyCache | 기본 **EasyCache** 노드를 어댑터 뒤에 둠 | 약 7% |
| `ref_end` 0.6 | 노드에서 설정 | 약 7% |

## 8. 문제 해결

| 증상 | 해결 방법 |
|---|---|
| 레퍼런스가 아니라 평범한 Anima 그림이 나옵니다 | KSampler의 `model` 입력이 모델 로더가 아니라 **Anima Ref Adapter**에서 오는지 확인합니다. `ref_guidance`를 올려 봅니다. |
| 색이 너무 진하거나 탄 것처럼 보입니다 | `ref_guidance`를 3~4로 낮추고 `correction`은 `apg`로 둡니다. |
| 레퍼런스의 자세를 그대로 따라 합니다 | 프롬프트에 레퍼런스와 다른 자세와 구도를 분명하게 씁니다. |
| 레퍼런스 캐릭터가 장면 안에 포스터나 피규어로 다시 나옵니다 | 알려진 한계입니다. 시드를 바꾸거나 `ref_guidance`를 낮춥니다. |
| 자동 다운로드가 실패합니다 | [`anima_ref_adapter_v2_r64.safetensors`](https://huggingface.co/ElectronGirl/anima-ref-adapter/blob/main/anima_ref_adapter_v2_r64.safetensors)를 직접 받아 `ComfyUI/models/loras/`에 넣습니다. |
| 메모리가 부족합니다 | `ref_megapixels`를 낮추거나 출력 크기를 줄입니다. |
| 파일럿 어댑터를 쓰고 싶습니다 | [`anima_ref_adapter_advanced.json`](https://github.com/ArcAnima/ComfyUI-Anima-Ref-Adapter/blob/main/workflows/anima_ref_adapter_advanced.json)을 씁니다. 파일럿은 레퍼런스가 출력과 같은 크기여야 합니다. |

## 9. Forge Neo

Stable Diffusion WebUI Forge (Neo)용 확장도 있습니다:
[sd-forge-anima-ref-adapter](https://github.com/ElectronGirl/sd-forge-anima-ref-adapter).

	# Anima Reference Adapter 사용 가이드

	[English](guide.en.md) · 한국어 · [日本語](guide.ja.md)

	이 가이드는 ComfyUI에 어댑터를 설치하고, 첫 이미지를 만들고, 프롬프트를 쓰고, 두 캐릭터를 함께 그리고,
	설정을 조절하고, 자주 생기는 문제를 해결하는 방법을 순서대로 설명합니다. 작동 원리와 측정 결과는
	[README](https://github.com/ArcAnima/ComfyUI-Anima-Ref-Adapter/blob/main/README.ko.md)에 있습니다.

	## 1. 준비물

	- Anima를 돌릴 수 있는 ComfyUI. 이미 Anima로 이미지를 만들고 있다면 준비가 끝난 것입니다.
	- [circlestone-labs/Anima](https://huggingface.co/circlestone-labs/Anima)에서 받는 Anima 파일 3개:
	- `anima-base-v1.0.safetensors` → `ComfyUI/models/diffusion_models/`
	- `qwen_3_06b_base.safetensors` → `ComfyUI/models/text_encoders/`
	- `qwen_image_vae.safetensors` → `ComfyUI/models/vae/`
	- Anima를 돌리는 데 필요한 VRAM 외에 약 1GB가 더 필요합니다. 1MP 레퍼런스의 key/value를 캐시해 두는 데 쓰입니다.
	8GB인 RTX 3060 Ti에서 테스트했습니다.

	어댑터 가중치는 따로 받지 않아도 됩니다. 처음 실행할 때 노드가 직접 받아옵니다.

	## 2. 노드 설치

	```bash
	cd ComfyUI/custom_nodes
	git clone https://github.com/ArcAnima/ComfyUI-Anima-Ref-Adapter.git
	```

	ComfyUI를 재시작합니다. git이 없다면 GitHub에서 ZIP으로 받아(Code → Download ZIP)
	`ComfyUI/custom_nodes/`에 압축을 풀면 됩니다.

	## 3. 첫 이미지 만들기

	1. [`anima_ref_adapter.json`](https://github.com/ArcAnima/ComfyUI-Anima-Ref-Adapter/blob/main/workflows/anima_ref_adapter.json)을
	받아서 ComfyUI 화면에 끌어다 놓습니다. Anima의 기본 text-to-image 워크플로에 Anima Ref Adapter 노드
	하나를 모델 로더와 KSampler 사이에 더한 것입니다.
	2. Load Image 노드에서 레퍼런스 이미지를 고릅니다.
	3. 긍정 프롬프트에는 퀄리티 태그를 그대로 두고 장면만 씁니다(4장 참고).
	4. 실행합니다. 처음 실행할 때 `anima_ref_adapter_v2_r64.safetensors`(183MB)를 `ComfyUI/models/loras/`로
	받아오고, 그다음부터는 바로 시작합니다.

	<img src="https://raw.githubusercontent.com/ArcAnima/ComfyUI-Anima-Ref-Adapter/main/docs/showcase/v2_police.jpg" width="100%" alt="레퍼런스와 결과">

	## 4. 프롬프트 쓰는 법

	캐릭터(얼굴, 머리, 눈, 의상, 장신구)와 그림체의 상당 부분은 레퍼런스에서 가져옵니다. 나머지는 모두
	프롬프트에서 정합니다.

	\| 쓸 것 \| 쓰지 않을 것 \|
	\|---\|---\|
	\| 퀄리티 태그: `masterpiece, best quality, score_7, safe,` \| 캐릭터 이름 \|
	\| `1girl` 또는 `1boy`, 그리고 `solo` \| 작가 태그 \|
	\| 구도: `cowboy shot`, `full body`, `upper body`, `portrait` \| 머리·눈·의상 태그(몇 개 정도는 괜찮습니다) \|
	\| 자세와 동작: `sitting`, `lying, on side`, `holding cup` \| \|
	\| 표정: `smile`, `sleepy`, `laughing` \| \|
	\| 장소·시간·조명: `cafe, indoors, day`, `beach, sunset` \| \|

	예시: `masterpiece, best quality, score_7, safe, 1girl, solo, cowboy shot, sitting, cafe, holding cup, smile, looking at viewer, indoors, window, day`

	도움이 되는 점:

	- 레퍼런스와 다른 자세를 쓰는 것이 좋습니다. 어댑터는 레퍼런스의 자세를 따라 하지 않도록 학습되었고,
	프롬프트에 자세가 분명하게 적혀 있으면 그 효과가 더 확실해집니다.
	- 레퍼런스에 보이지 않는 부분(상반신 이미지의 다리, 의상의 뒷면 등)은 모델이 추측해서 그립니다.
	캐릭터 전체가 보이는 레퍼런스를 쓰면 의상이 더 일정하게 유지됩니다.
	- 부정 프롬프트는 Anima 모델 카드에 있는 것을 그대로 쓰면 됩니다.

	## 5. 두 캐릭터 함께 그리기

	<img src="https://raw.githubusercontent.com/ArcAnima/ComfyUI-Anima-Ref-Adapter/main/docs/showcase/v2_duo_police_mecha.jpg" width="100%" alt="레퍼런스 두 장과 결과">

	1. [`anima_ref_adapter_two_characters.json`](https://github.com/ArcAnima/ComfyUI-Anima-Ref-Adapter/blob/main/workflows/anima_ref_adapter_two_characters.json)을
	엽니다. Load Image 노드 두 개를 기본 Image Stitch 노드가 좌우로 이어 붙입니다.
	2. 첫 번째 이미지에는 왼쪽에 올 캐릭터를, 두 번째 이미지에는 오른쪽에 올 캐릭터를 넣습니다.
	3. `solo` 대신 `2girls`(또는 `1boy, 1girl`, `2boys`)를 쓰고, 누가 어느 쪽인지 몇 단어로 적습니다.
	`2girls, the girl on the left is a policewoman with black hair over one eye, the girl on the right is a mecha girl with aqua hair and mechanical wings, standing side by side, peace sign, smile, city, street, day`
	4. 1216x832처럼 가로가 긴 크기를 씁니다.

	두 캐릭터는 섞이지 않고 따로 그려지지만, 그림체는 둘의 중간쯤으로 하나로 맞춰지는 경향이 있습니다.

	## 6. 설정

	모두 Anima Ref Adapter 노드에 있습니다.

	\| 설정 \| 기본값 \| 역할 \|
	\|---\|---\|---\|
	\| `ref_guidance` \| 4.5 \| 레퍼런스 쪽으로 미는 세기입니다. 캐릭터가 달라지면 5~6으로 올리고, 색이 너무 진해지면 낮춥니다. 1로 두면 모델을 한 번 덜 호출하므로 빠르지만 약해집니다. \|
	\| `correction` \| `apg` \| 가이던스가 높을 때 색이 과해지는 것을 막습니다. `rescale`도 쓸 수 있고, `none`은 끕니다. \|
	\| `ref_end` \| 1.0 \| 샘플링 진행 중 이 지점부터 `ref_guidance`를 멈춥니다. 레퍼런스 자체는 끝까지 유지됩니다. 0.6 정도로 두면 거의 같은 그림을 더 빨리 얻습니다. \|
	\| `ref_megapixels` \| 1.0 \| 레퍼런스를 줄이거나 늘리는 크기입니다. VRAM이 부족하면 0.5~0.7로 낮춥니다. \|
	\| `strength` \| 1.0 \| 어댑터 LoRA의 세기입니다. \|

	다른 LoRA(그림체, 디테일 등)는 어댑터 노드 앞, 즉 모델 로더와 Anima Ref Adapter 사이에 둡니다.

	## 7. 더 빠르게

	\| 방법 \| 설정 \| 효과 (RTX 3060 Ti, 832x1216) \|
	\|---\|---\|---\|
	\| turbo LoRA \| Anima base용 turbo LoRA를 어댑터 앞에 두고 10 steps, cfg 1, `ref_guidance` 1 \| 67초 → 11초. 레퍼런스 그림체는 약해집니다. \|
	\| `ref_guidance` 1 \| 노드에서 설정 \| 67초 → 50초 \|
	\| SageAttention \| KJNodes의 Patch Sage Attention을 어댑터 앞에 둠 \| 약 7% \|
	\| EasyCache \| 기본 EasyCache 노드를 어댑터 뒤에 둠 \| 약 7% \|
	\| `ref_end` 0.6 \| 노드에서 설정 \| 약 7% \|

	## 8. 문제 해결

	\| 증상 \| 해결 방법 \|
	\|---\|---\|
	\| 레퍼런스가 아니라 평범한 Anima 그림이 나옵니다 \| KSampler의 `model` 입력이 모델 로더가 아니라 Anima Ref Adapter에서 오는지 확인합니다. `ref_guidance`를 올려 봅니다. \|
	\| 색이 너무 진하거나 탄 것처럼 보입니다 \| `ref_guidance`를 3~4로 낮추고 `correction`은 `apg`로 둡니다. \|
	\| 레퍼런스의 자세를 그대로 따라 합니다 \| 프롬프트에 레퍼런스와 다른 자세와 구도를 분명하게 씁니다. \|
	\| 레퍼런스 캐릭터가 장면 안에 포스터나 피규어로 다시 나옵니다 \| 알려진 한계입니다. 시드를 바꾸거나 `ref_guidance`를 낮춥니다. \|
	\| 자동 다운로드가 실패합니다 \| [`anima_ref_adapter_v2_r64.safetensors`](https://huggingface.co/ElectronGirl/anima-ref-adapter/blob/main/anima_ref_adapter_v2_r64.safetensors)를 직접 받아 `ComfyUI/models/loras/`에 넣습니다. \|
	\| 메모리가 부족합니다 \| `ref_megapixels`를 낮추거나 출력 크기를 줄입니다. \|
	\| 파일럿 어댑터를 쓰고 싶습니다 \| [`anima_ref_adapter_advanced.json`](https://github.com/ArcAnima/ComfyUI-Anima-Ref-Adapter/blob/main/workflows/anima_ref_adapter_advanced.json)을 씁니다. 파일럿은 레퍼런스가 출력과 같은 크기여야 합니다. \|

	## 9. Forge Neo

	Stable Diffusion WebUI Forge (Neo)용 확장도 있습니다:
	[sd-forge-anima-ref-adapter](https://github.com/ElectronGirl/sd-forge-anima-ref-adapter).