# UGC 스크립트

> 제품 이름이나 웹사이트와 최대 8장의 스크린샷으로 UGC 동영상의 첫 줄, 파트, 마지막 줄을 쓰고 동영상 규칙에 맞는지 확인합니다.

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

**UGC 스크립트** 노드는 UGC 동영상에서 크리에이터가 말할 내용인 **첫 줄**, **파트**, **마지막 줄**을 씁니다. 최대 8장의 스크린샷과 입력한 제품 이름이나 웹사이트를 읽습니다. 스크립트가 동영상 규칙에 맞는지 확인하고, 규칙을 어기면 스크립트를 다시 씁니다.

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

UGC 스크립트는 [UGC 크리에이터](https://nodaro.ai/docs/nodes/video/ugc-creator)가 크리에이터를 만들 때 쓰는 제품 카테고리도 고릅니다. 보통 다음 노드는 스크립트를 클립으로 나누는 [UGC 클립 목록](https://nodaro.ai/docs/nodes/video/ugc-clips)입니다.

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

## 사용 시기
- 크리에이터가 내 제품이나 웹사이트에 대해 말하는 짧은 동영상을 원할 때.
- 사이트나 앱의 스크린샷이 있고, 크리에이터가 언급할 때마다 각 스크린샷을 카드로 보여 주고 싶을 때.
- 동영상 길이에 이미 맞춘 스크립트가 필요할 때.

이미지 프롬프트, 대사, 음악 분위기가 있는 여러 장면의 스크립트가 필요하면 [대본 생성](https://nodaro.ai/docs/nodes/video/generate-script)을 사용하세요.

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

### 제품 입력
[텍스트](https://nodaro.ai/docs/nodes/automate/text) 노드를 **제품 이름 또는 웹사이트**에 연결하세요. 제품 이름을 입력하거나 웹사이트를 붙여 넣으세요.

### 스크린샷 추가
[이미지 업로드](https://nodaro.ai/docs/nodes/image/upload-image) 노드 3~8개를 크리에이터가 말할 순서대로 **스크린샷 1**~**스크린샷 8**에 연결하세요. 필요하면 제품 사진을 **제품 사진**에 연결하세요.

### 길이 설정 후 실행
설정 패널을 열고 **동영상 길이(초)**를 설정하세요. **실행**을 클릭하세요. 스크립트의 줄이 노드에 표시됩니다.

Workflow: UGC 스크립트가 제품 이름과 스크린샷으로 스크립트를 씁니다. 카테고리는 UGC 크리에이터로, 스크립트는 UGC 클립 목록으로 전달됩니다.

- 텍스트 → UGC 스크립트 (제품 이름 또는 웹사이트)
- 이미지 업로드 → UGC 스크립트 (스크린샷)
- UGC 스크립트 → UGC 크리에이터 (카테고리)
- UGC 스크립트 → UGC 클립 목록 (스크립트)
- UGC 크리에이터 → UGC 클립 목록 (크리에이터)

## 입력
| 입력 | 필수 | 연결할 것 |
| --- | --- | --- |
| **제품 이름 또는 웹사이트** | 예 | 텍스트입니다. 80자 이하의 이름은 입력한 그대로 브랜드 이름으로 쓰입니다. 300자 이하의 더 긴 설명은 맥락으로 읽히며, 스크립트는 그 안에서 브랜드 이름을 정합니다. 이 입력이 없으면 노드가 “제품 이름 또는 웹사이트를 추가하세요.”라는 메시지와 함께 실패합니다. |
| **스크린샷 1**~**스크린샷 8** | 아니요 | 카드 순서대로 연결하는 이미지입니다. 비어 있는 입력은 건너뜁니다. |
| **제품 사진** | 아니요 | 제품 이미지입니다. 제품 사진이 있으면 마지막 줄에서 크리에이터가 제품을 들고 있을 수 있습니다. |

### 스크린샷 개수
- **스크린샷 3~8장:** 입력 순서대로, 스크린샷 1부터 한 장에 파트 하나씩입니다. 크리에이터가 그 내용을 말하는 동안 각 스크린샷이 카드로 나타납니다. 카드 타이밍은 [UGC 카드](https://nodaro.ai/docs/nodes/video/ugc-cards)가 맞춥니다.
- **스크린샷 1~2장**은 사용되지 않습니다. 카드 없이 크리에이터가 말하는 동영상이 되며, UGC 카드의 메모에 그렇게 표시됩니다.
- **스크린샷 없음:** 똑같이 크리에이터가 말하는 동영상이 됩니다.

UGC 스크립트는 스크린샷을 이미지로 읽습니다. 웹사이트를 방문하지 않습니다.

## 출력
| 출력 | 전달하는 것 |
| --- | --- |
| **스크립트** | [UGC 클립 목록](https://nodaro.ai/docs/nodes/video/ugc-clips)의 **스크립트** 입력에 쓰는 JSON 형식의 스크립트입니다. |
| **카테고리** | [UGC 크리에이터](https://nodaro.ai/docs/nodes/video/ugc-creator)의 **제품 카테고리** 입력이나 다른 텍스트 입력에 쓰는 일반 텍스트 형식의 제품 카테고리입니다. |

## 설정
| 설정 | 하는 일 |
| --- | --- |
| **동영상 길이(초)** | 동영상 길이로, 4~300초입니다. 기본값은 15입니다. 스크립트는 이 길이에 맞춰 작성됩니다. |
| **언어** | 스크립트를 쓰고 말하는 언어로, **영어**(기본값) 또는 **히브리어**입니다. 히브리어 동영상은 클립을 합치기 전에 [UGC 마무리](https://nodaro.ai/docs/nodes/video/ugc-finish-clips)가 필요합니다. |
| **이 스크립트 유지** | 기본적으로 꺼져 있습니다. 켜면 다음 실행에서 새로 쓰지 않고 마지막 스크립트를 비용 없이 그대로 전달합니다. 스크립트를 유지하는 동안 길이는 유지한 스크립트의 길이로 고정됩니다. 길이를 바꾸려면 **이 스크립트 유지**를 끄세요. |

설정에는 스크립트를 몇 번 만에 작성했는지도 “2회 만에 작성”처럼 표시됩니다.

### 스크립트 확인 방식
UGC 스크립트는 스크립트가 동영상 규칙에 맞는지 확인합니다. 규칙을 어기면 노드가 확인 결과를 바탕으로 스크립트를 다시 씁니다. 처음 작성과 최대 두 번의 재작성을 합쳐 모두 세 번 시도합니다.

### 줄 편집
실행 후 설정에 스크립트의 줄이 표시됩니다. **첫 줄**, 각 파트(**파트 1**, **파트 2** 등), **마지막 줄**입니다.

1. **편집**을 누르고 줄의 문구를 바꾸세요.
2. **저장**을 누르면 스크립트에 반영됩니다. 저장하면 **이 스크립트 유지**가 켜지므로 다음 실행에서 편집한 줄을 사용합니다.
3. 스크립트를 그대로 두려면 **취소**를 누르세요.

편집할 수 있는 것은 줄의 문구뿐입니다. 빈 줄은 “파트 2의 줄이 비어 있습니다.”와 같은 메시지와 함께 거부됩니다. 스크립트의 글자 수 제한을 넘는 줄도 “파트 2의 줄이 너무 깁니다. …자 이하로 입력하세요.”와 같은 메시지와 함께 거부됩니다.

[UGC 클립 목록](https://nodaro.ai/docs/nodes/video/ugc-clips)은 클립 비용을 지불하기 전에 편집한 스크립트를 다시 확인합니다. 규칙을 어긴 스크립트는 UGC 클립 목록에서 “스크립트를 수정해야 합니다:”라는 메시지와 각 문제 및 해결 방법과 함께 실패합니다.

### 게시된 앱에서
길이는 앱 입력 **동영상 길이(초)**로 만들 수 있습니다. 4~300초 슬라이더이거나, 앱에서 허용하는 길이 중에서 고르는 방식입니다. **내 사이트로 만드는 UGC 동영상** 튜토리얼을 앱으로 게시하면 15초, 20초, 25초를 제공합니다.

## 크레딧
UGC 스크립트는 다시 쓰는 횟수와 관계없이 실행마다 고정 가격을 청구합니다. 편집기는 실행이 시작되기 전에 **실행** 버튼에 가격을 표시합니다.

- 세 번 시도해도 규칙을 맞추지 못한 실행은 환불됩니다. “스크립트가 세 번 시도한 뒤에도 동영상 규칙을 충족하지 못했습니다:”라는 메시지와 함께 아직 남은 문제가 표시되며 실패합니다.
- 다른 이유로 실패한 실행도 환불됩니다.
- 유지한 스크립트는 비용 없이 전달됩니다. 그 뒤의 클립은 유지한 스크립트의 길이와 스크린샷 카드 기준으로 가격이 매겨집니다.

동영상 전체 가격은 [편집기의 가격](https://nodaro.ai/docs/nodes/video/ugc-clip#prices-in-the-editor)을 참고하세요.

## 팁
- **스크린샷은 말하는 순서대로 업로드하세요.** 카드 순서는 스크린샷 입력의 순서입니다.
- **마음에 드는 스크립트는 유지하세요.** **이 스크립트 유지**를 켜거나 줄을 편집하고 저장하세요. 그러면 다음에 워크플로 전체를 실행할 때 새 스크립트 비용을 내지 않고 스크립트를 그대로 전달합니다.
- **카드를 넣으려면 스크린샷을 3~8장 사용하세요.** 그보다 적으면 동영상에 카드가 없습니다.
- **게시할 때 스크립트는 비워집니다.** **이번 실행 결과 포함**으로 게시한 템플릿은 복사한 사람이 첫 스크립트를 쓸 때까지 말하는 줄을 예시로 보여 줍니다.

## 문제 해결
| 메시지 또는 문제 | 원인과 해결 |
| --- | --- |
| “제품 이름 또는 웹사이트를 추가하세요.” | **제품 이름 또는 웹사이트**에 아무것도 연결되어 있지 않습니다. 이름이나 웹사이트를 입력한 텍스트 노드를 연결하세요. |
| “스크립트가 세 번 시도한 뒤에도 동영상 규칙을 충족하지 못했습니다:” | 두 번 다시 쓴 뒤에도 스크립트가 규칙을 어겼습니다. 실행은 환불됩니다. 길이, 제품 텍스트 또는 스크린샷을 바꾸고 다시 실행하세요. |
| “파트 2의 줄이 비어 있습니다.” | 편집한 줄이 비어 있습니다. 줄을 쓰거나 **취소**를 누르세요. |
| “파트 2의 줄이 너무 깁니다. …자 이하로 입력하세요.” | 편집한 줄이 제한을 넘었습니다. 줄을 줄이세요. |
| 길이 설정을 바꿀 수 없습니다. | **이 스크립트 유지**가 켜져 있습니다. 길이를 바꾸려면 끄세요. |
| 동영상에 카드가 없습니다. | 연결된 스크린샷이 3장보다 적습니다. 스크린샷을 3~8장 추가하세요. |

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

실행 요청으로 UGC 스크립트의 `targetDurationSec`를 4~300 사이로 설정할 수 있습니다. UGC 노드에서 실행이 그 밖에 설정할 수 있는 것은 UGC 크리에이터의 `source`, `gender`, `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_clips` 같은 별도의 UGC 도구를 사용합니다. `get_recipe`로 불러오는 ugc-website 레시피가 이 도구를 설명합니다. [콘텐츠 레시피](https://nodaro.ai/docs/mcp/recipes)를 참고하세요.

## 자주 묻는 질문

### UGC 스크립트 노드는 무엇을 하나요?

UGC 스크립트는 UGC 동영상에서 크리에이터가 말할 내용인 첫 줄, 파트, 마지막 줄을 씁니다. 제품 이름이나 웹사이트와 최대 8장의 스크린샷을 읽고, 스크립트가 동영상 규칙에 맞는지 확인합니다.

### UGC 스크립트가 내 웹사이트를 방문하나요?

아니요. UGC 스크립트는 스크린샷을 이미지로 읽을 뿐 웹사이트를 방문하지 않습니다. 제품 이름을 입력하거나 웹사이트를 맥락으로 붙여 넣으세요.

### 스크린샷은 몇 장 업로드해야 하나요?

3~8장을 업로드하세요. 스크린샷마다 파트가 하나씩 생기고, 크리에이터가 그 내용을 말하는 동안 카드로 나타납니다. 1~2장이거나 없으면 카드 없이 크리에이터가 말하는 동영상이 됩니다.

### UGC 스크립트는 크레딧이 얼마나 드나요?

UGC 스크립트는 다시 쓰는 횟수와 관계없이 실행마다 고정 가격을 청구합니다. 실패한 실행은 환불되고, 유지한 스크립트는 비용이 들지 않습니다. 편집기는 실행이 시작되기 전에 가격을 표시합니다.

### 스크립트를 편집할 수 있나요?

네. 실행 후 설정 패널에서 편집을 누르고 줄의 문구를 바꾼 다음 저장을 누르세요. 저장하면 이 스크립트 유지가 켜지므로 다음 실행에서 편집한 줄을 사용합니다.