# UGC 크리에이터

> UGC 동영상에서 카메라를 보고 말할 사람을 제품에 맞춰 만든 AI 크리에이터나 내 사진 중에서 고르고, 마음에 드는 크리에이터를 이후 모든 실행에 유지합니다.

Source: https://nodaro.ai/ko/docs/nodes/video/ugc-creator

**UGC 크리에이터** 노드는 UGC 동영상에서 카메라를 보고 말할 사람을 정합니다. 제품에 맞춰 만든 **AI 크리에이터**나 **내 사진**입니다. 크리에이터는 [UGC 클립 목록](https://nodaro.ai/docs/nodes/video/ugc-clips)으로 전달되며, 동영상의 모든 클립에 이 사람이 나옵니다.

- Found in: Video › UGC Video
- API type: `ugc-creator`

UGC 크리에이터는 6개의 UGC 동영상 노드 중 하나입니다. [UGC 스크립트](https://nodaro.ai/docs/nodes/video/ugc-script), [UGC 클립 목록](https://nodaro.ai/docs/nodes/video/ugc-clips), [UGC 클립](https://nodaro.ai/docs/nodes/video/ugc-clip), [UGC 마무리](https://nodaro.ai/docs/nodes/video/ugc-finish-clips), [UGC 카드](https://nodaro.ai/docs/nodes/video/ugc-cards)와 함께, 크리에이터가 제품에 대해 말하는 동안 스크린샷이 카드로 나타나고 자막이 붙는 동영상을 만듭니다.

UGC 크리에이터는 Nodaro Cloud에서만 실행됩니다. 다른 설치에서는 모든 UGC 노드가 아무것도 예약되기 전에 “UGC 동영상은 Nodaro Cloud 기능이라 이 인스턴스에서는 제공되지 않습니다.”라는 메시지와 함께 실패합니다.

크리에이터는 성인만 가능합니다. **크리에이터 외모**에 연결한 인물 피커가 나이를 20세 미만으로 설정하면 “그 나이는 사용할 수 없습니다. UGC 크리에이터는 성인이어야 합니다.”라는 메시지와 함께 거부됩니다. 성인 나이를 설정하지 않은 상태에서 미성년자를 뜻하는 유형을 설정해도 마찬가지입니다. 사진에는 얼굴이 또렷하게 보이는 성인 한 명만 있어야 합니다.

## 사용 시기
- UGC 동영상을 만들면서 제품에 어울리는 AI 크리에이터가 필요할 때.
- 사진 한 장으로 직접 동영상을 진행하고 싶을 때.
- 마음에 드는 크리에이터를 찾았고, 이후 모든 동영상에 같은 사람을 쓰고 싶을 때.

## 빠른 시작
### 노드 추가
캔버스에서 Tab을 누르고 **동영상 › UGC 동영상 › UGC 크리에이터**를 선택하세요.

### 크리에이터 선택
설정 패널을 여세요. **AI 크리에이터**를 그대로 두거나, **내 사진 사용**을 선택하고 [이미지 업로드](https://nodaro.ai/docs/nodes/image/upload-image)를 **내 사진**에 연결하세요. **성별**에서 **여성** 또는 **남성**을 선택하세요.

### 카테고리와 외모 연결
[UGC 스크립트](https://nodaro.ai/docs/nodes/video/ugc-script)의 **카테고리** 출력을 **제품 카테고리**에 연결하세요. AI 크리에이터의 모습을 조정하려면 인물, 스타일링, 배경, 조명 피커를 **크리에이터 외모**에 연결하세요.

### 실행하고 크리에이터 선택
**실행**을 클릭하세요. 옵션이 노드에 나란히 나타납니다. 원하는 크리에이터에서 **이 옵션 사용**을 누르세요. 그런 다음 UGC 크리에이터에서 **여기서부터 실행**을 눌러 동영상을 만드세요.

Workflow: UGC 스크립트가 스크립트를 쓰고, UGC 크리에이터가 사람을 고르고, UGC 클립 목록이 스크립트를 나누고, UGC 클립이 각 클립을 렌더링하고, 동영상 합치기가 클립을 합치고, UGC 카드가 동영상 오버레이용 카드와 자막 추가용 자막의 타이밍을 맞춥니다.

- UGC 스크립트 → UGC 크리에이터 (카테고리)
- UGC 스크립트 → UGC 클립 목록 (스크립트)
- UGC 크리에이터 → UGC 클립 목록 (크리에이터)
- UGC 클립 목록 → UGC 클립 (클립)
- UGC 클립 → 동영상 합치기 (묶음)
- 동영상 합치기 → UGC 카드 (동영상)
- UGC 카드 → 동영상 오버레이 (레이어 플랜)
- 동영상 오버레이 → 자막 추가 (동영상)

## 입력
| 입력 | 필수 | 연결할 것 |
| --- | --- | --- |
| **내 사진** | **내 사진 사용**일 때만 | 내 이미지입니다. 예를 들어 이미지 업로드에서 연결합니다. 연결한 사진이 설정에서 지정한 사진보다 우선합니다. |
| **제품 카테고리** | 아니요 | [UGC 스크립트](https://nodaro.ai/docs/nodes/video/ugc-script)의 **카테고리** 출력입니다. 노드에서 고른 카테고리가 우선합니다. |
| **크리에이터 외모** | 아니요 | [인물](https://nodaro.ai/docs/nodes/creative-controls/person), [스타일링](https://nodaro.ai/docs/nodes/creative-controls/styling), [배경](https://nodaro.ai/docs/nodes/creative-controls/setting), [조명](https://nodaro.ai/docs/nodes/creative-controls/lighting) 피커입니다. 여러 피커가 이 입력을 함께 쓸 수 있습니다. 피커에서 설정한 필드만 사용되며, 노드에 연결된 피커 목록이 표시됩니다. |

## 출력
| 출력 | 전달하는 것 |
| --- | --- |
| **크리에이터** | [UGC 클립 목록](https://nodaro.ai/docs/nodes/video/ugc-clips)의 **크리에이터** 입력에 쓰는 JSON 형식의 크리에이터입니다. |
| **이미지** | 크리에이터의 이미지로, 모든 이미지 입력에 쓸 수 있습니다. |

옵션이 선택을 기다리는 동안에는 노드에서 아무것도 출력되지 않습니다.

## 설정
| 설정 | 하는 일 |
| --- | --- |
| **크리에이터** | 기본값인 **AI 크리에이터** 또는 **내 사진 사용**입니다. |
| **성별** | 기본값인 **여성** 또는 **남성**입니다. AI 크리에이터는 이 성별로 만들어지며, 이미지마다 성별을 확인합니다. |
| **제품 카테고리** | AI 크리에이터 전용입니다. 기본값인 **스크립트에서**는 UGC 스크립트가 고른 카테고리를 사용합니다. 스킨케어, 테크, 음식 같은 카테고리를 목록에서 직접 고를 수도 있습니다. |
| **시드** | AI 크리에이터 전용이며 선택 사항입니다. 크리에이터 외모의 무작위 선택을 고정합니다. |
| **이 크리에이터 유지** | 기본적으로 꺼져 있습니다. 켜면 다음 실행에서 새로 만들지 않고 마지막 크리에이터를 비용 없이 그대로 전달합니다. |
| **내 사진** | 내 사진 사용 전용입니다. **내 사진**에 아무것도 연결되어 있지 않을 때 쓰는 사진입니다. 게시된 앱의 크리에이터 카드가 이 값을 설정합니다. 설정에 **이미지 제거**와 함께 표시됩니다. |

편집기에서는 **내 사진** 입력으로 **내 사진 사용**에 사진을 전달하세요. 사진이 없으면 노드가 “본인 사진을 연결하거나 업로드하세요.”라는 메시지와 함께 실패합니다. 본인 또는 동의한 사람의 사진만 업로드하세요.

### AI 크리에이터를 만드는 방식
AI 크리에이터는 제품 카테고리, 고른 성별, **크리에이터 외모** 피커가 설정한 필드에 맞춰 만들어집니다. 새로 만들 때마다 다른 사람이 나옵니다. 새 크리에이터는 피커로 고정하지 않는 한, 마지막으로 본 크리에이터와 나이, 머리 색, 헤어스타일, 체형 중 최소 두 가지가 다릅니다.

- **편집기에서**는 노드가 옵션을 여러 개 만들고, 하나를 고를 때까지 실행이 UGC 크리에이터에서 멈춥니다.
- **게시된 앱이나 API 실행에서**는 노드가 크리에이터를 하나만 만들고 실행이 계속됩니다.
- **하위 워크플로에서나 목록의 항목마다 실행할 때**도 노드가 크리에이터를 하나만 만들고 실행이 계속됩니다.

옵션이 하나만 나오면 노드는 묻지 않고 그 옵션을 사용합니다.

### 크리에이터 선택
옵션은 옵션 1, 옵션 2와 같은 라벨이 붙어 노드에 나란히 표시되고 선택을 기다립니다.

- **이 옵션 사용**은 그 옵션을 유지하고 **이 크리에이터 유지**를 켭니다. 그런 다음 UGC 크리에이터에서 **여기서부터 실행**을 눌러 동영상을 만드세요.
- **새 옵션 보기**는 다시 만듭니다. 새 옵션은 이미 본 옵션과 다릅니다. 크리에이터를 유지하고 있을 때 **새 옵션 보기**를 누르면 **이 크리에이터 유지**가 꺼지고 노드가 실행됩니다.

옵션이 선택을 기다리는 동안 UGC 크리에이터를 포함한 실행은 “먼저 크리에이터를 선택하세요.”라는 메시지와 함께 거부됩니다. 옵션 하나를 만들지 못하면 나머지 옵션은 안내 문구와 함께 그대로 표시됩니다.

## 크레딧
UGC 크리에이터에는 자체 가격이 없습니다. 실행에서 청구되는 항목은 다음과 같습니다.

- **만드는 이미지마다** 일반 이미지 작업이 되며, 해당 이미지 모델의 가격이 청구됩니다.
- **이미지마다** 이미지 판독을 한 번 실행해, 인물이 고른 성별과 맞는지 확인합니다.
- **편집기에서**는 모든 옵션을 만들고 확인합니다. **게시된 앱이나 API 실행에서**는 크리에이터 하나를 만들고 확인합니다.
- **사진**은 이미지 판독 한 번으로 확인합니다. 확인을 통과하지 못한 사진은 “이 사진은 사용할 수 없습니다. 얼굴이 또렷하게 보이는 성인 한 명만 있어야 합니다.”라는 메시지와 함께 거부됩니다.
- **유지한 크리에이터**는 비용 없이 전달됩니다.

검수로 한 번에 만든 이미지가 모두 차단되면, 그 대신 이미지를 하나 더 만들고 같은 방식으로 확인합니다. 이 이미지에도 자체 가격이 청구됩니다.

확인을 통과한 옵션이 없으면 크리에이터를 한 번 더 만들고, 같은 가격이 다시 청구됩니다. 그것도 실패하면 클립을 렌더링하기 전에 실행이 멈춥니다. 메시지는 “AI 크리에이터가 선택한 인물로 만들어지지 않았습니다. UGC 크리에이터를 다시 실행하세요.”입니다. UGC 스크립트가 이미 쓴 스크립트는 그대로 청구됩니다.

만드는 도중에 크레딧이 떨어지면 노드가 멈춥니다. 편집기에서는 크레딧 구매 대화 상자가 열리고, 이미 확인된 옵션은 노드에 남아 선택할 수 있습니다.

실행 전에 편집기는 크리에이터의 가격을 동영상의 나머지 비용과 함께 표시합니다. [편집기의 가격](https://nodaro.ai/docs/nodes/video/ugc-clip#prices-in-the-editor)을 참고하세요.

## 팁
- **피커로 외모를 조정하세요.** 나이, 머리, 체형은 인물, 메이크업, 헤어, 의상은 스타일링, 크리에이터가 촬영하는 장소는 배경, 빛은 조명으로 정합니다.
- **크리에이터 외모를 비워 두면** 제품 카테고리에만 맞춘 크리에이터가 만들어집니다.
- **마음에 드는 크리에이터는 유지하세요.** **이 옵션 사용**을 누르면 이후 모든 실행에서 같은 사람을 비용 없이 사용합니다.
- **내 사진은 비공개로 유지됩니다.** 게시된 앱이나 템플릿에는 내 사진이 포함되지 않습니다. **내 사진 사용**으로 설정한 앱은 실행하는 사람마다 본인 사진을 요청합니다.

## 문제 해결
| 메시지 또는 문제 | 원인과 해결 |
| --- | --- |
| “먼저 크리에이터를 선택하세요.” | 노드에서 옵션이 선택을 기다리고 있습니다. 그중 하나에서 **이 옵션 사용**을 누르거나 **새 옵션 보기**를 누르세요. |
| “본인 사진을 연결하거나 업로드하세요.” | **내 사진 사용**이 설정되어 있지만 **내 사진**에 사진이 연결되어 있지 않습니다. 이미지 업로드를 연결하세요. |
| “이 사진은 사용할 수 없습니다. 얼굴이 또렷하게 보이는 성인 한 명만 있어야 합니다.” | 카메라를 바라보고 얼굴이 또렷하게 보이는 성인 한 명의 사진을 사용하세요. |
| “먼저 “UGC 스크립트”를 실행하거나 제품 카테고리를 선택하세요.” | AI 크리에이터에는 제품 카테고리가 필요합니다. UGC 스크립트의 **카테고리** 출력을 연결하거나 노드에서 카테고리를 고르세요. |
| “그 나이는 사용할 수 없습니다. UGC 크리에이터는 성인이어야 합니다.” | 인물 피커가 나이를 20세 미만으로 설정했거나 미성년자를 뜻하는 유형을 설정했습니다. 성인 나이를 설정하세요. |
| “AI 크리에이터가 선택한 인물로 만들어지지 않았습니다. UGC 크리에이터를 다시 실행하세요.” | 두 번 모두 만든 이미지가 고른 성별과 맞지 않았습니다. UGC 크리에이터를 다시 실행하세요. |
| “UGC 동영상은 Nodaro Cloud 기능이라 이 인스턴스에서는 제공되지 않습니다.” | UGC 노드는 Nodaro Cloud에서만 실행됩니다. app.nodaro.ai에서 워크플로를 사용하세요. |

## API에서 사용
UGC 크리에이터는 실행될 때 `POST /v1/ugc/creator`를 호출합니다. UGC 경로의 요청과 응답 형식은 노드에 속하며 버전에 따라 바뀔 수 있습니다. 코드로 UGC 동영상을 만들려면 UGC 노드가 들어 있는 워크플로나 게시된 앱을 실행하세요. API 실행은 크리에이터를 하나만 만들며 선택을 기다리지 않습니다.

실행 요청으로 설정할 수 있는 UGC 크리에이터 필드는 `source`(AI 크리에이터는 `sampled`, 내 사진 사용은 `photo`), `gender`(`woman` 또는 `man`), `photoUrl` 세 가지뿐입니다. UGC 노드의 다른 필드를 설정하면 `400 locked_field`로 응답합니다. [워크플로](https://nodaro.ai/docs/developers/api/workflows#run-a-workflow-with-new-input-values)와 [미니앱](https://nodaro.ai/docs/concepts/apps#embed-a-miniapp-or-run-it-from-code)을 참고하세요.

MCP로 연결된 AI 어시스턴트는 `build_ugc_creator` 같은 별도의 UGC 도구를 사용합니다. `get_recipe`로 불러오는 ugc-website 레시피가 이 도구를 설명합니다. [콘텐츠 레시피](https://nodaro.ai/docs/mcp/recipes)를 참고하세요.

## 자주 묻는 질문

### UGC 크리에이터 노드는 무엇을 하나요?

UGC 크리에이터는 UGC 동영상에서 카메라를 보고 말할 사람을 정합니다. 제품에 맞는 AI 크리에이터를 만들거나 내 사진을 사용합니다. 동영상의 모든 클립에 이 사람이 나옵니다.

### 실행이 UGC 크리에이터에서 멈추는 이유는 무엇인가요?

편집기에서는 AI 크리에이터가 여러 옵션으로 나란히 만들어지고, 실행은 선택을 기다립니다. 원하는 옵션에서 이 옵션 사용을 누른 다음 UGC 크리에이터에서 여기서부터 실행을 눌러 동영상을 만드세요.

### UGC 동영상에 내 얼굴을 사용할 수 있나요?

네. 크리에이터를 내 사진 사용으로 설정하고 이미지 업로드 노드를 내 사진 입력에 연결하세요. 사진에는 얼굴이 또렷하게 보이는 성인 한 명만 있어야 합니다.

### UGC 크리에이터는 크레딧이 얼마나 드나요?

노드 자체의 가격은 없습니다. 만드는 이미지마다 해당 이미지 모델의 가격이 청구되고, 이미지마다 확인을 위한 이미지 판독이 한 번씩 실행됩니다. 유지한 크리에이터는 비용이 들지 않습니다.

### UGC 크리에이터가 어린이일 수 있나요?

아니요. UGC 크리에이터는 성인만 가능합니다. 나이를 20세 미만으로 설정하거나 미성년자를 뜻하는 유형을 설정한 인물 피커는 거부됩니다.