> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# SyncLipSyncNode - ComfyUI Built-in Node Documentation

> Complete documentation for the SyncLipSyncNode node in ComfyUI. Learn its inputs, outputs, parameters and usage.

이 노드는 sync.so API를 사용하여 비디오의 입 움직임을 새로운 음성 오디오에 다시 동기화합니다. 클로즈업, 측면 및 장애물을 자동으로 처리하면서 화자의 표정을 유지합니다. 비용은 출력 길이에 따라 달라집니다.

## 입력

| 매개변수    | 설명                                                                               | 데이터 유형 | 필수 여부 | 범위              |
| ------- | -------------------------------------------------------------------------------- | ------ | ----- | --------------- |
| `video` | 다시 동기화할 화자의 영상입니다. 최대 4K(4096x2160)까지 지원되며, 24/25/30fps의 일정한 프레임 속도가 가장 잘 작동합니다. | VIDEO  | 예     | -               |
| `audio` | 입에 동기화할 음성 오디오입니다.                                                               | AUDIO  | 예     | -               |
| `seed`  | 시드는 노드를 다시 실행할지 여부를 제어합니다. 시드와 관계없이 결과는 비결정적입니다(기본값: 42).                        | INT    | 예     | 0 \~ 2147483647 |
| `model` | sync.so 생성 모델입니다.                                                                | COMBO  | 예     | 아래 참조           |

`model` 매개변수는 다음과 같은 하위 매개변수를 포함하는 동적 콤보입니다:

| 하위 매개변수             | 설명                                                                                | 데이터 유형 | 필수 여부 | 범위                                                                        |
| ------------------- | --------------------------------------------------------------------------------- | ------ | ----- | ------------------------------------------------------------------------- |
| `sync_mode`         | 비디오와 오디오 간 길이 불일치를 처리하는 방법입니다. 또한 출력 길이를 설정합니다(기본값: "bounce").                    | COMBO  | 예     | `"bounce"`<br />`"cut_off"`<br />`"loop"`<br />`"silence"`<br />`"remap"` |
| `speaker_selection` | 여러 사람이 보일 때 립싱크할 얼굴을 선택합니다(기본값: "default").                                       | COMBO  | 예     | `"default"`<br />`"auto-detect"`<br />`"coordinates"`                     |
| `speaker_frame`     | 화자를 찾는 데 사용되는 비디오 프레임입니다. `speaker_selection`이 "coordinates"인 경우에만 사용됩니다(기본값: 0). | INT    | 아니요   | 0 \~ 1000000                                                              |
| `speaker_x`         | 화자 얼굴의 X 픽셀 좌표입니다. `speaker_selection`이 "coordinates"인 경우에만 사용됩니다(기본값: 0).        | INT    | 아니요   | 0 \~ 4096                                                                 |
| `speaker_y`         | 화자 얼굴의 Y 픽셀 좌표입니다. `speaker_selection`이 "coordinates"인 경우에만 사용됩니다(기본값: 0).        | INT    | 아니요   | 0 \~ 4096                                                                 |

**동기화 모드 옵션:**

* `bounce`: 비디오가 오디오가 끝날 때까지 앞뒤로 재생됩니다(출력 = 오디오 길이)
* `loop`: 비디오가 오디오가 끝날 때까지 다시 시작됩니다(출력 = 오디오 길이)
* `remap`: 비디오가 오디오와 일치하도록 시간이 늘어납니다(출력 = 오디오 길이)
* `cut_off`: 더 긴 트랙이 잘립니다(출력 = 더 짧은 길이)
* `silence`: 아무것도 잘리지 않으며, 더 짧은 트랙이 채워집니다(출력 = 더 긴 길이)

**화자 선택 옵션:**

* `default`: 모델이 립싱크할 얼굴을 결정하도록 합니다
* `auto-detect`: 활성 화자를 감지하고 추적합니다
* `coordinates`: `speaker_frame`에서 선택한 프레임의 픽셀(`speaker_x`, `speaker_y`)에 있는 얼굴을 대상으로 합니다

**제약 사항:**

* 비디오 해상도는 4K(4096x2160)를 초과할 수 없습니다. 이 제한을 초과하는 비디오는 오류가 발생합니다.
* 오디오 길이는 600초(10분)를 초과할 수 없습니다.
* `speaker_frame`, `speaker_x`, `speaker_y` 매개변수는 `speaker_selection`이 "coordinates"로 설정된 경우에만 사용됩니다.

## 출력

| 출력 이름   | 설명                                    | 데이터 유형 |
| ------- | ------------------------------------- | ------ |
| `video` | 제공된 오디오와 일치하도록 입 움직임이 다시 동기화된 비디오입니다. | VIDEO  |

> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SyncLipSyncNode/ko.md)

***

**Source fingerprint (SHA-256):** `b41f8c9bf0d55059f081a66af20636ec96462c3fd9caeb685cab10278f84678a`