> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-custom-nodes-sdk-v2-frontend.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Wan2TextToVideoApi - ComfyUI Built-in Node Documentation

> 이 노드는 Wan 2.7 모델을 사용하여 텍스트 설명에서 비디오를 생성합니다. 프롬프트를 Wan 비디오 생성 API로 전송하고 작업이 완료될 때까지 대기한 후 결과 비디오를 반환합니다. 선택적으로 오디오 클립을 연결하여 비디오의 동작과 타이밍에 영향을 줄 수 있습니다. 오디오를 제공하지 않으면 모델이 자동으로 일치하는 오

이 노드는 Wan 2.7 모델을 사용하여 텍스트 설명에서 비디오를 생성합니다. 프롬프트를 Wan 비디오 생성 API로 전송하고 작업이 완료될 때까지 대기한 후 결과 비디오를 반환합니다. 선택적으로 오디오 클립을 연결하여 비디오의 동작과 타이밍에 영향을 줄 수 있습니다. 오디오를 제공하지 않으면 모델이 자동으로 일치하는 오디오를 생성합니다.

## 입력

### 공통 입력

이 입력은 노드 상단에서 항상 사용할 수 있습니다.

| 매개변수            | 설명                                                                                                | 데이터 타입         | 필수 여부 | 범위              |
| --------------- | ------------------------------------------------------------------------------------------------- | -------------- | ----- | --------------- |
| `model`         | 비디오 생성에 사용할 특정 모델입니다.                                                                             | DYNAMIC\_COMBO | 예     | `"wan2.7-t2v"`  |
| `audio`         | 비디오 생성을 유도하는 오디오입니다(예: 립싱크, 비트에 맞춘 동작). 길이: 3초\~30초. 제공하지 않으면 모델이 자동으로 일치하는 배경 음악이나 음향 효과를 생성합니다. | AUDIO          | 아니요   | -               |
| `seed`          | 생성에 사용할 시드입니다(기본값: 0).                                                                            | INT            | 예     | 0\~2147483647   |
| `prompt_extend` | AI 지원으로 프롬프트를 향상시킬지 여부입니다(기본값: True).                                                             | BOOLEAN        | 예     | True<br />False |
| `watermark`     | 결과물에 AI 생성 워터마크를 추가할지 여부입니다(기본값: False).                                                          | BOOLEAN        | 예     | True<br />False |

### wan2.7-t2v 입력

이 설정은 `wan2.7-t2v` 모델을 선택했을 때 표시됩니다.

| 매개변수              | 설명                                          | 데이터 타입 | 필수 여부 | 범위                                                            |
| ----------------- | ------------------------------------------- | ------ | ----- | ------------------------------------------------------------- |
| `prompt`          | 요소와 시각적 특징을 설명하는 프롬프트입니다. 영어와 중국어를 지원합니다.   | STRING | 예     | -                                                             |
| `negative_prompt` | 피해야 할 내용을 설명하는 네거티브 프롬프트입니다. 기본값은 빈 문자열입니다. | STRING | 아니요   | -                                                             |
| `resolution`      | 출력 비디오의 해상도입니다.                             | COMBO  | 예     | `"720P"`<br />`"1080P"`                                       |
| `ratio`           | 출력 비디오의 화면 비율입니다.                           | COMBO  | 예     | `"16:9"`<br />`"9:16"`<br />`"1:1"`<br />`"4:3"`<br />`"3:4"` |
| `duration`        | 비디오 길이(초)입니다(기본값: 5).                       | INT    | 예     | 2\~15                                                         |

**참고:** `prompt` 입력은 비어 있으면 안 됩니다. `audio` 입력은 선택 사항이며, 제공하는 경우 툴팁이 3초\~30초를 권장하지만 노드는 1.5초에서 60초 사이의 오디오를 허용합니다. 오디오를 제공하지 않으면 모델이 자동으로 일치하는 오디오를 생성합니다. `negative_prompt`가 비어 있으면 API로 전송되지 않습니다. `prompt_extend`와 `watermark`는 고급 옵션입니다.

## 출력

| 출력 이름    | 설명             | 데이터 타입 |
| -------- | -------------- | ------ |
| `output` | 생성된 비디오 파일입니다. | VIDEO  |

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

***

**Source fingerprint (SHA-256):** `2b35fb3e897f8c5fb9786576f4e314cb6709527a3cdc4f2eb9f0600d09076835`