# UGC 마무리

> UGC 동영상의 모든 클립을 한꺼번에 받아 합칠 수 있게 순서대로 전달합니다. 히브리어 동영상에서는 녹음한 음성을 각 클립에 다시 입힙니다.

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

**UGC 마무리** 노드는 UGC 동영상의 모든 클립을 한꺼번에 받아 합칠 수 있게 순서대로 전달합니다. [UGC 클립](https://nodaro.ai/docs/nodes/video/ugc-clip)과 합치기([동영상 합치기](https://nodaro.ai/docs/nodes/video/combine-videos)) 사이에 둡니다. 모든 클립을 클립 순서대로 한꺼번에 받고, 같은 순서로 전달합니다.

- Found in: Video › UGC Video
- API type: `ugc-finish-clips`

히브리어 동영상에서는 클립을 녹음한 음성 하나에서 잘라 냅니다. UGC 마무리는 그 음성을 각 클립에 다시 입히고 단어 사이의 쉼을 다듬어, 합친 동영상이 한 번에 찍은 것처럼 들리게 합니다. 이것은 정액 작업 한 번입니다. 영어 동영상에서는 클립이 비용 없이 그대로 전달됩니다.

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

## 사용 시기
- 히브리어 UGC 동영상을 만듭니다. 그 클립은 합치기 전에 UGC 마무리가 필요합니다.
- 영어와 히브리어 동영상을 워크플로 하나로 만들고 싶습니다. 영어 동영상에서는 UGC 마무리가 클립을 비용 없이 그대로 전달합니다.

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

### 클립 연결
UGC 클립의 **동영상** 출력을 **클립**에 연결하고, 그 연결을 **묶음** 모드로 설정하세요. 그래야 UGC 마무리가 모든 클립을 한꺼번에 받습니다.

### 스크립트 연결
[UGC 클립 목록](https://nodaro.ai/docs/nodes/video/ugc-clips)의 **스크립트(길이 조정됨)** 출력을 **스크립트**에 연결하세요.

### 클립 합치기
**동영상** 출력을 동영상 합치기에 연결하고, 이 연결도 **묶음** 모드로 설정하세요. 동영상 합치기가 마무리된 클립을 순서대로 합칩니다.

Workflow: UGC 클립이 각 클립을 렌더링합니다. UGC 마무리가 묶음 연결로 모든 클립을 길이 조정된 스크립트와 함께 받아 순서대로 전달합니다. 동영상 합치기가 클립을 합칩니다.

- UGC 클립 목록 → UGC 클립 (개별)
- UGC 클립 → UGC 마무리 (묶음)
- UGC 클립 목록 → UGC 마무리 (스크립트(길이 조정됨))
- UGC 마무리 → 동영상 합치기 (묶음)

## 입력
| 입력 | 필수 | 연결할 것 |
| --- | --- | --- |
| **클립** | 예 | UGC 클립의 **동영상** 출력을 **묶음** 모드로 연결해 모든 클립이 한꺼번에 도착하게 합니다. 없으면 노드가 ““UGC 클립”의 “동영상” 출력을 연결하세요.”라는 메시지와 함께 실패합니다. |
| **스크립트** | 예 | UGC 클립 목록의 **스크립트(길이 조정됨)** 출력입니다. 없으면 노드가 ““UGC 클립 목록”의 “스크립트(길이 조정됨)” 출력을 연결하세요.”라는 메시지와 함께 실패합니다. |

## 출력
| 출력 | 전달하는 것 |
| --- | --- |
| **동영상** | 마무리된 클립을 클립 순서대로 전달합니다. 동영상 합치기로는 **묶음** 연결을 써서 모든 클립을 합치게 하세요. 오디오 믹스로 가는 연결처럼 다른 연결은 노드에 표시된 클립 하나를 전달합니다. |

노드에는 마무리된 클립이 표시되며, 기본은 첫 번째 클립입니다. [연결 모드](https://nodaro.ai/docs/concepts/nodes-and-connections#connection-modes)를 참고하세요.

## 설정
UGC 마무리에는 설정이 없습니다.

### 영어 동영상과 히브리어 동영상
- **영어 동영상**은 그대로 통과합니다. 클립이 바뀌지 않고 순서대로 전달됩니다. 작업이 실행되지 않고 비용도 없습니다.
- **히브리어 동영상**은 모든 클립에 대해 마무리 작업을 한 번 실행합니다. 이 작업은 녹음한 음성을 각 클립에 다시 입히고 단어 사이의 쉼을 다듬습니다. 마무리된 클립이 순서대로 전달됩니다.

언어는 [UGC 스크립트](https://nodaro.ai/docs/nodes/video/ugc-script)의 **언어** 설정입니다. 히브리어 동영상에는 UGC 마무리가 필요합니다. 없으면 UGC 클립 목록은 아무것도 쓰기 전에 ““UGC 클립” 뒤에 “UGC 마무리” 노드를 추가하고, “UGC 클립 목록”의 “스크립트(길이 조정됨)” 출력을 연결하세요.”라는 메시지와 함께 실패합니다.

### 전부 아니면 전무
음성을 따르지 않는 클립이 있으면 UGC 마무리 전체가 실패하고 클립을 하나도 전달하지 않습니다. 그래서 클립이 빠진 채로 합친 동영상이 만들어지지 않습니다. 각 클립은 렌더링할 때 스스로 확인하므로 이런 일은 드뭅니다.

### 중단되는 경우
히브리어 동영상에서 소리가 없는 클립은 마무리 작업을 중단시킵니다. 그 클립에는 다시 입히거나 확인할 음성이 없기 때문입니다. 작업은 “클립 *n*에 소리가 없어 동영상을 완성할 수 없습니다. “UGC 클립” 노드에서 그 클립을 다시 렌더링하세요.”라는 메시지와 함께 실패합니다. 마무리 작업의 크레딧은 환불됩니다. [UGC 클립](https://nodaro.ai/docs/nodes/video/ugc-clip#re-render-a-clip)에서 그 클립을 다시 렌더링한 다음 다시 실행하세요.

## 크레딧
UGC 마무리 자체는 무료입니다.

- **영어 동영상**에서는 아무것도 실행하지 않으며 비용이 없습니다.
- **히브리어 동영상**에서는 마무리 작업을 한 번 실행합니다. 클립 수와 관계없이 **33크레딧**입니다.

이 작업을 포함한 실행의 가격은 실행을 시작하기 전에 표시됩니다. [편집기의 가격](https://nodaro.ai/docs/nodes/video/ugc-clip#prices-in-the-editor)을 참고하세요.

## 팁
- **모든 UGC 워크플로에 UGC 마무리를 넣어 두세요.** 영어 동영상에서는 비용이 없고, 같은 워크플로로 히브리어 동영상도 만들 수 있습니다.
- **클립은 UGC 클립에서 고치세요.** UGC 마무리가 음성을 따르지 않은 클립이 있다고 알리면, UGC 클립에서 그 클립의 **다시 렌더링**을 누르고 다시 실행하세요.
- **게시해도 완성된 클립은 포함되지 않습니다.** **이번 실행 결과 포함**을 켜고 게시한 템플릿은 완성된 클립을 예시로 보여 줍니다. [튜토리얼과 템플릿](https://nodaro.ai/docs/get-started/tutorials-and-templates)을 참고하세요.

## 문제 해결
| 메시지 또는 문제 | 원인과 해결 방법 |
| --- | --- |
| ““UGC 클립”의 “동영상” 출력을 연결하세요.” | **클립**에 아무것도 연결되어 있지 않습니다. UGC 클립의 **동영상** 출력을 **묶음** 모드로 연결하세요. |
| ““UGC 클립 목록”의 “스크립트(길이 조정됨)” 출력을 연결하세요.” | **스크립트**에 아무것도 연결되어 있지 않습니다. UGC 클립 목록의 **스크립트(길이 조정됨)** 출력을 연결하세요. |
| ““UGC 클립” 뒤에 “UGC 마무리” 노드를 추가하고, “UGC 클립 목록”의 “스크립트(길이 조정됨)” 출력을 연결하세요.” | 스크립트가 히브리어인데, UGC 클립 목록의 **스크립트(길이 조정됨)** 출력을 받는 UGC 마무리가 없습니다. UGC 마무리를 추가하고 빠른 시작대로 연결하세요. 아무것도 쓰이지 않았습니다. |
| “음성을 따르지 않은 클립이 있습니다. “UGC 클립” 노드에서 다시 렌더링한 뒤 다시 실행하세요.” | 클립 하나가 녹음한 음성 중 자기 부분과 맞지 않습니다. UGC 클립에서 그 클립의 **다시 렌더링**을 누르고 다시 실행하세요. |
| “클립 *n*에 소리가 없어 동영상을 완성할 수 없습니다. “UGC 클립” 노드에서 그 클립을 다시 렌더링하세요.” | 히브리어 동영상에서 그 클립에 소리가 없습니다. 마무리 작업의 크레딧은 환불됩니다. UGC 클립에서 그 클립의 **다시 렌더링**을 누르고 다시 실행하세요. |
| “이 단계에는 더 새로운 버전의 앱이 필요합니다.” | 클립과 스크립트가 이 버전의 편집기가 읽는 형식과 맞지 않습니다. 예를 들어 클립 수가 스크립트의 클립 수와 다른 경우입니다. UGC 클립 목록과 UGC 클립을 다시 실행하세요. 메시지가 계속 나오면 편집기를 새로 고치세요. |
| 동영상 합치기가 클립을 하나만 받습니다. | UGC 마무리에서 나가는 연결이 **선택됨** 모드입니다. **묶음** 모드로 설정하세요. |

## API에서 사용
히브리어 동영상에서 UGC 마무리는 실행될 때 `POST /v1/ugc/finish`를 호출하며, 이 경로는 작업 ID로 응답합니다. UGC 경로의 요청과 응답 형식은 노드에 속하며 버전에 따라 바뀔 수 있습니다. 코드로 UGC 동영상을 만들려면 UGC 노드가 들어 있는 워크플로나 게시된 앱을 실행하세요. [워크플로](https://nodaro.ai/docs/developers/api/workflows#run-a-workflow-with-new-input-values)를 참고하세요.

MCP에서는 같은 단계가 [`ugc_finish_clips`](https://nodaro.ai/docs/mcp/tools/utility#ugc_finish_clips) 도구입니다.

## 자주 묻는 질문

### UGC 마무리 노드는 무엇을 하나요?

UGC 마무리는 UGC 동영상의 모든 클립을 클립 순서대로 한꺼번에 받아 같은 순서로 전달합니다. 동영상 합치기가 바로 합칠 수 있습니다. UGC 클립과 합치기 사이에 둡니다.

### UGC 마무리에 크레딧이 드나요?

영어 동영상에서는 들지 않습니다. 클립이 그대로 전달되고 작업이 실행되지 않습니다. 히브리어 동영상에서는 정액 마무리 작업을 한 번 실행합니다.

### 히브리어 UGC 동영상에 UGC 마무리가 필요한 이유는 무엇인가요?

히브리어 동영상의 클립은 녹음한 음성 하나에서 잘라 낸 것입니다. UGC 마무리는 그 음성을 각 클립에 다시 입히고 단어 사이의 쉼을 다듬어, 합친 동영상이 한 번에 찍은 것처럼 들리게 합니다.

### UGC 마무리는 어떻게 연결하나요?

UGC 클립의 동영상 출력을 클립에 묶음 모드로 연결하고, UGC 클립 목록의 스크립트(길이 조정됨) 출력을 스크립트에 연결하세요. 그런 다음 동영상 출력을 동영상 합치기에, 역시 묶음 모드로 연결하세요.