# 마스크 생성

> “the red car”(빨간 자동차)처럼 쉬운 말로 피사체를 설명하면 그 피사체의 흑백 마스크를 받아, 편집 노드에서 그 영역만 다시 그릴 수 있습니다.

Source: https://nodaro.ai/ko/docs/nodes/image/generate-mask

**마스크 생성** 노드는 텍스트 설명으로 이미지에서 피사체를 찾아 그 피사체의 흑백 마스크를 반환합니다. `the red car`(빨간 자동차) 같은 짧은 구절을 쓰면, 노드가 그 피사체를 흰색으로, 나머지를 모두 검은색으로 표시합니다. 마스크를 편집 노드에 연결하면 그 영역만 다시 그릴 수 있습니다.

- Found in: Image › Edit & Retouch
- Output: image
- API type: `generate-mask`

## 사용 시기
- 피사체 하나만 바꾸고 나머지는 유지합니다. `the jacket`(재킷)을 마스크한 다음 [이미지 수정](https://nodaro.ai/docs/nodes/image/modify-image)에서 색을 바꾸세요.
- 피사체 뒤에 있는 것을 바꿉니다. `the background`(배경)을 마스크하고 다시 그리세요.
- 정밀한 수작업 마스크의 출발점을 만듭니다. 먼저 마스크를 생성한 다음 [마스크 그리기](https://nodaro.ai/docs/nodes/image/paint-mask)에서 다듬으세요.
- [조명 변경 및 교체](https://nodaro.ai/docs/nodes/video/relight-and-switch)나 마스크 입력이 있는 다른 노드에 쓸 영역을 선택합니다.

## 빠른 시작
### 노드 추가
캔버스에서 Tab을 누르고 **이미지 › 편집 및 보정 › 마스크 생성**을 선택하세요.

### 이미지 연결
[이미지 업로드](https://nodaro.ai/docs/nodes/image/upload-image)나 [이미지 생성](https://nodaro.ai/docs/nodes/image/generate-image) 같은 이미지 노드에서 **이미지** 입력으로 드래그하세요.

### 피사체 설명
설정 패널을 열고 **마스크할 대상 설명**에 피사체를 쓰세요. 예: `the red car`(빨간 자동차).

### 실행하고 마스크 연결
**실행**을 클릭하세요. 마스크가 노드에 표시됩니다. **마스크** 출력을 편집 노드의 **마스크** 입력에 연결하고, 같은 이미지를 그 노드의 **이미지** 입력에 연결하세요. [이미지 수정](https://nodaro.ai/docs/nodes/image/modify-image)에서는 Ideogram Edit처럼 마스크를 지원하는 모델을 고르세요.

Workflow: 마스크 생성이 사진을 빨간 자동차의 마스크와 함께 그대로 넘기고, 이미지 수정이 그 영역만 다시 그립니다.

- 이미지 업로드 → 마스크 생성 (이미지)
- 마스크 생성 → 이미지 수정 (이미지 + 마스크)

## 입력
| 입력 | 받는 것 | 하는 일 |
| --- | --- | --- |
| **이미지** | 이미지 업로드, 이미지 생성, 이미지 수정 같은 이미지 노드 | 피사체를 찾을 이미지입니다. 필수입니다. |

마스크 생성에는 출력이 두 개 있습니다.

| 출력 | 전달하는 내용 |
| --- | --- |
| **이미지** | 바뀌지 않은 원본 이미지입니다. 같은 이미지를 마스크와 함께 편집 노드로 보낼 때 쓰세요. |
| **마스크** | 이미지와 같은 크기의 흑백 PNG입니다. 흰색은 편집할 영역인 피사체입니다. 검은색은 유지할 영역인 그 밖의 모든 부분입니다. |

마스크는 평범한 PNG이므로, 미리 보거나 저장하는 등 이미지를 받는 곳이면 어디서든 쓸 수 있습니다.

## 설정
| 설정 | 기능 |
| --- | --- |
| **마스크할 대상 설명** | 찾을 피사체입니다. `the red car`, `the woman`, `the background`(빨간 자동차, 여성, 배경)처럼 짧은 구절로 씁니다. 필수이며, 최대 500자입니다. |
| **감지 임계값** | `0.05`~`0.95` 범위의 슬라이더이며, 기본값은 `0.3`입니다. 현재 마스크 생성이 쓰는 모델은 이 값을 무시하므로, 슬라이더를 움직여도 마스크는 바뀌지 않습니다. 결과를 바꾸려면 프롬프트를 바꾸세요. |
| **앞뒤 텍스트** | 프롬프트 앞뒤에 항상 붙는 텍스트입니다. 내 워크플로를 앱으로 사용하는 사람에게는 보이지 않습니다. [프롬프트 앞뒤 텍스트](https://nodaro.ai/docs/concepts/prompt-pre-post-text)를 참고하세요. |

## 마스크를 만드는 방식
마스크 생성은 항상 세그멘테이션 모델 하나, Grounded SAM을 씁니다. 모델은 내 말이 가리키는 피사체를 찾은 다음, 그 정확한 윤곽을 따라 그립니다. 모델 버전이 고정되어 있으므로, 같은 이미지와 같은 프롬프트는 항상 같은 마스크를 냅니다. 고를 수 있는 모델은 없습니다.

흰색은 “편집”, 검은색은 “유지”를 뜻합니다. [마스크 그리기](https://nodaro.ai/docs/nodes/image/paint-mask)와 [이미지 수정](https://nodaro.ai/docs/nodes/image/modify-image)의 마스크 그리기 도구도 같은 규칙을 쓰므로, 생성한 마스크와 직접 그린 마스크는 서로 바꿔 쓸 수 있습니다.

## 크레딧
실행할 때마다 이미지 크기나 프롬프트와 관계없이 55크레딧이 듭니다. 설명과 일치하는 영역이 없으면 실행이 실패하고 크레딧이 환불됩니다.

## 문제 해결
**실행이 `No region matched the mask prompt`(마스크 프롬프트와 일치하는 영역이 없음) 메시지와 함께 실패합니다.** 이미지에 내 말과 일치하는 것이 없었습니다. 크레딧은 환불됩니다. 같은 프롬프트로 다시 실행해도 같은 방식으로 실패하므로, 긴 설명 대신 `the hat`(모자)처럼 더 짧고 쉬운 구절로 다시 쓰세요.

**마스크가 비어 있습니다.** 전부 검은 마스크는 프롬프트가 너무 일반적이거나 피사체가 이미지에 없다는 뜻입니다. `hair`(머리카락) 대신 `the left girl's hair`(왼쪽 소녀의 머리카락)처럼 피사체를 더 분명하게 지정하세요.

**마스크가 거의 맞습니다.** **마스크** 출력을 [마스크 그리기](https://nodaro.ai/docs/nodes/image/paint-mask) 노드의 **초기 마스크** 입력에 연결하세요. 생성된 마스크가 열린 상태로 그리기 도구가 시작되며, 영역을 직접 추가하거나 지울 수 있습니다.

## 팁
- **분명한 피사체 하나를 지정하세요.** 모델은 긴 절보다 `the woman`(여성)이나 `the red car`(빨간 자동차) 같은 짧은 명사구를 훨씬 잘 읽습니다.
- **이미지와 마스크를 함께 보내세요.** **이미지** 출력은 원본을 그대로 넘기므로, 두 출력에서 하나씩 연결하면 편집 노드에 둘 다 도착합니다.
- **슬라이더로 마스크를 고치려 하지 마세요.** **감지 임계값**은 현재 효과가 없습니다. 프롬프트를 바꾸거나 마스크를 직접 다듬으세요.

## 자주 묻는 질문

### 마스크 생성 노드는 무엇을 만드나요?

이미지와 같은 크기의 흑백 PNG입니다. 흰색은 내가 설명한 피사체, 즉 편집 노드가 바꿀 수 있는 영역입니다. 검은색은 그 밖의 모든 영역으로, 그대로 유지됩니다.

### 마스크 생성 노드는 크레딧이 얼마나 드나요?

이미지 크기나 프롬프트와 관계없이 실행당 55크레딧입니다. 설명과 일치하는 영역이 없으면 실행이 실패하고 크레딧이 환불됩니다.

### 프롬프트에는 무엇을 써야 하나요?

“the red car”, “the woman”, “the left girl's hair”(빨간 자동차, 여성, 왼쪽 소녀의 머리카락)처럼 피사체를 가리키는 짧고 쉬운 구절을 쓰세요. 짧은 명사구가 긴 묘사 문장보다 훨씬 잘 작동합니다.

### 마스크 생성 노드가 아무것도 찾지 못한 이유는 무엇인가요?

설명이 모델이 찾을 수 있는 어떤 것과도 일치하지 않았습니다. 더 짧고 쉬운 구절로 다시 쓰세요. 같은 프롬프트로 다시 실행하면 같은 결과가 나옵니다.

### 거의 맞는 마스크를 고칠 수 있나요?

네. 마스크 출력을 마스크 그리기 노드의 초기 마스크 입력에 연결하세요. 생성된 마스크가 열린 상태로 그리기 도구가 시작되며, 영역을 직접 추가하거나 지울 수 있습니다.