# 텍스트로 대화 만들기

> 대화 전체를 오디오 파일 하나로 만듭니다. 대사마다 보이스를 정하고 오디오 태그로 감정을 더하세요. ElevenLabs Dialogue v3 또는 Dialogue v4를 씁니다.

Source: https://nodaro.ai/ko/docs/nodes/audio/text-to-dialogue

**텍스트로 대화 만들기** 노드는 대화 전체를 오디오 파일 하나로 만듭니다. 대사를 쓰고 대사마다 보이스를 정하면, ElevenLabs Dialogue v3 또는 ElevenLabs Dialogue v4가 대사를 순서대로 읽어 하나의 자연스러운 대화로 만듭니다. 음성 클립을 따로따로 생성해 이어 붙이는 대신 인터뷰, 팟캐스트 스타일 대화, 대화 장면에 사용하세요.

- Found in: Audio › Speech & Voiceover
- Output: audio
- API type: `text-to-dialogue`

## 사용 시기
- 두 명 이상의 화자가 나누는 팟캐스트 스타일 대화.
- 진행자 보이스와 게스트 보이스가 있는 인터뷰.
- 애니메이션 동영상이나 설명 영상의 대화 트랙.
- 등장인물마다 보이스가 하나씩 있는 오디오북의 대화 장면.
- 대화의 빠른 오디오 프로토타입.

보이스 하나가 텍스트를 읽게 하려면 [텍스트 음성 변환](https://nodaro.ai/docs/nodes/audio/text-to-speech)을 사용하세요.

## 빠른 시작
### 노드 추가
캔버스에서 Tab 키를 누르고 **오디오 › 음성 및 내레이션 › 텍스트로 대화 만들기**를 선택하세요.

### 대사 쓰기
설정 패널을 여세요. **대사 목록**에서 첫 대사의 보이스를 고르고 텍스트를 입력하세요. 대화에 새 대사를 넣을 때마다 **대사 추가**를 클릭하세요.

### 또는 대본으로 대사 채우기
[대본 생성](https://nodaro.ai/docs/nodes/video/generate-script) 노드의 **대사** 출력을 **프롬프트** 입력에 연결하세요. 설정 패널에서 **대본에서 대사 12줄 채우기**처럼 대사를 채우는 버튼을 클릭하세요. 그런 다음 화자마다 보이스를 고르세요.

### 실행
노드에서 **실행**을 클릭하세요. 노드가 모든 대사를 순서대로 담은 오디오 파일 하나를 돌려줍니다.

Workflow: 대본이 대사를 채우고, 대화를 생성한 환경음 위에 믹스합니다.

- 대본 생성 → 텍스트로 대화 만들기 (프롬프트)
- 텍스트로 대화 만들기 → 오디오 믹스 (오디오)
- 텍스트로 오디오 만들기 → 오디오 믹스 (오디오)

## 입력
| 입력 | 받는 것 | 하는 일 |
| --- | --- | --- |
| **프롬프트** | 대본 생성 같은 텍스트 노드 | 대본 생성 노드의 **대사** 출력이 연결되면, 설정 패널에 대본으로 대사를 채우는 버튼이 나타납니다. 노드가 읽는 것은 패널의 대사입니다. |

| 출력 | 담는 것 |
| --- | --- |
| **오디오** | 모든 대사를 순서대로 읽은, 연속된 오디오 파일 하나입니다. |
| **녹취록** | 대화의 타이밍입니다. 단어마다 시작 시간, 종료 시간, 화자가 들어 있고, 대사마다 세그먼트가 하나씩 있습니다. 화자는 그 대사의 보이스입니다. |

**녹취록** 출력을 [자막 추가](https://nodaro.ai/docs/nodes/video/add-captions)의 **녹취록** 입력에 연결하세요. 그러면 자막 추가는 오디오를 다시 받아쓰지 않고 대화 자체의 단어와 타이밍을 사용합니다. 대사 안의 오디오 태그는 자막 단어가 되지 않습니다.

## 설정
| 설정 | 하는 일 |
| --- | --- |
| **모델** | **ElevenLabs Dialogue v3**(기본값) 또는 **ElevenLabs Dialogue v4**입니다. [모델](#models)을 참고하세요. |
| **대사 목록** | 대화의 대사를 순서대로 담습니다. 대사마다 보이스와 텍스트가 따로 있습니다. 대사에서 `[` 또는 `/`를 입력하면 오디오 태그를 넣을 수 있습니다. 빈 대사는 건너뜁니다. |
| **대사 추가** | 맨 끝에 대사를 하나 더합니다. 휴지통 버튼은 대사를 지웁니다. |
| **대본에서 대사 …줄 채우기** | 대본 생성 노드의 대사 출력이 연결되면 나타납니다. 대사 목록을 대본의 한 줄당 대사 하나로 바꿉니다. 각 대사는 화자 이름을 유지하고, 기본 보이스인 **Sarah**로 시작합니다. |
| **안정성** | 낮을수록 더 극적이고, 높을수록 더 고릅니다. 기본값은 0.5입니다. Dialogue v3에서는 **가장 가변적(0)**, **균형(0.5)**, **가장 안정적(1.0)** 중에서 고르세요. Dialogue v4에서는 슬라이더로 0~1 사이의 어떤 값이든 정할 수 있습니다. v3로 바꾸면 단계 사이의 값은 가장 가까운 단계로 옮겨집니다. |
| **유사도** | Dialogue v4 전용입니다. 각 대사가 보이스의 특성을 얼마나 유지할지 0~1로 정합니다. 기본값은 0.75입니다. |
| **언어** | **자동 감지**(기본값) 또는 언어 하나를 고르세요. |
| **시드** | 0부터 4,294,967,295까지의 정수입니다. 시드, 대사, 설정이 같으면 같은 오디오가 다시 만들어집니다. 매번 무작위 결과를 원하면 비워 두세요. |
| **텍스트 정규화** | **자동**(기본값), **켜기**, **끄기** 중에서 고르세요. 켜면 숫자, 날짜, 약어를 풀어 써서 자연스럽게 들리게 합니다. |

쓰는 동안 패널이 보이스 수와 글자 수를 셉니다. 예: `보이스 2/10`, `840/5000`. 글자 수에는 선택한 모델의 한도가 표시됩니다.

## 제한
| 제한 | 값 |
| --- | --- |
| 모든 대사의 텍스트 | Dialogue v3에서는 5,000자, Dialogue v4에서는 10,000자. 2,000자 이내일 때 품질이 가장 좋습니다. |
| 실행당 서로 다른 보이스 | 10개. 한 보이스를 여러 대사에 써도 한 번만 셉니다. |

대화에는 텍스트가 있는 대사가 하나 이상 있어야 합니다. 어느 대사에도 텍스트가 없으면 실행이 시작되기 전에 거부됩니다. 선택한 모델의 한도를 넘는 대본도 크레딧이 청구되기 전에 거부됩니다.

## 보이스와 오디오 태그
모든 대사에 어떤 보이스든 쓸 수 있습니다. 기본 제공 보이스, 보이스 라이브러리의 보이스, 내 보이스를 자유롭게 섞어 쓰세요. 대화용 보이스 목록은 따로 없습니다.

두 모델 모두, 대사는 [텍스트 음성 변환](https://nodaro.ai/docs/nodes/audio/text-to-speech#add-emotion-with-audio-tags)의 ElevenLabs v3 및 v4와 같은 오디오 태그를 이해합니다. 예: `[laughs]`, `[whispers]`, `[sighs]`.

## 모델
텍스트로 대화 만들기는 두 모델 중 하나를 실행합니다. 두 모델 모두 같은 46개 언어를 말하고 오디오 태그를 이해합니다.

- **ElevenLabs Dialogue v3**가 기본값입니다. 표현력이 풍부하며, **안정성**은 3단계입니다.
- **ElevenLabs Dialogue v4**는 최신 모델입니다. **안정성**에 0~1 사이의 어떤 값이든 쓸 수 있고, **유사도**가 추가되며, 최대 10,000자의 대본을 받습니다.

| Model | Maker | Modes | Credits | Details |
| --- | --- | --- | --- | --- |
| [ElevenLabs Dialogue v3](https://nodaro.ai/docs/models/audio/elevenlabs-dialogue-v3) | ElevenLabs | Multi-speaker dialogue | 5부터 | Multi-speaker dialogue via the direct ElevenLabs API — give it a script, it voices each role (any voice: premade, library, or cloned). |
| [ElevenLabs Dialogue v4](https://nodaro.ai/docs/models/audio/elevenlabs-dialogue-v4) | ElevenLabs | Multi-speaker dialogue | 5부터 | Multi-speaker dialogue on ElevenLabs v4 — [audio tags], stability and similarity control. Direct API. |

## 크레딧
가격은 대본 길이에 따라 정해집니다. 모든 대사를 합친 글자 수에서 100자 단위(시작된 단위 포함)마다 Dialogue v3는 5크레딧, Dialogue v4는 5크레딧이 듭니다. 실행 한 번은 최소 8단위로 청구되므로, 800자 이하의 대본은 모두 같은 가격입니다. **녹취록** 출력에는 추가 비용이 없습니다. 정확한 가격은 실행 전에 노드에 표시됩니다.

## 팁
- **화자마다 확실히 다른 보이스를 주세요.** 듣는 사람이 대화를 더 쉽게 따라갑니다. 보이스를 정하기 전에 보이스 브라우저에서 미리 들어 보세요.
- **대사는 대화하듯 쓰세요.** 한 대사에 긴 문단 하나를 넣기보다 짧은 대사 여러 개가 더 자연스럽게 들립니다.
- **균형 안정성으로 시작하세요.** 극적이거나 감정적인 장면에서는 낮추고, 격식 있는 내레이션 같은 읽기에는 높이세요. Dialogue v4에서는 그 사이의 어떤 값이든 고를 수 있습니다.
- **여러 언어가 섞인 대화에는 언어를 정하세요.** 자동 감지는 한 언어일 때 잘 작동합니다. 화자들이 언어를 바꿔 가며 말하면 주 언어를 직접 고르세요.
- **긴 대화는 이어 붙이세요.** 긴 대화를 여러 노드로 나누고 [오디오 합치기](https://nodaro.ai/docs/nodes/audio/combine-audio)로 각 부분을 끝과 끝을 이어 붙이세요.

## API에서 사용
같은 생성 기능을 MCP 도구 `generate_dialogue`로 쓸 수 있습니다. [MCP 도구](https://nodaro.ai/docs/mcp/tools)와 [보이스 및 미디어](https://nodaro.ai/docs/developers/api/voice-and-media)를 참고하세요.

`POST /v1/text-to-dialogue`는 `dialogue`(`[{ text, voice }]`, 말하는 순서대로)와 선택 항목인 `provider`, `stability`, `similarityBoost`, `languageCode`, `seed`, `applyTextNormalization`을 받습니다. `provider`는 `elevenlabs-dialogue`(Dialogue v3, 기본값) 또는 `elevenlabs-dialogue-v4`입니다. MCP 도구에서는 같은 선택을 `model`, CLI에서는 `nodaro voice dialogue`의 `--model`이라고 부릅니다. Dialogue v3에서는 0, 0.5, 1이 아닌 `stability`가 거부됩니다. 완료된 작업의 `output_data.transcript`에는 **녹취록** 출력과 같은 타이밍이 들어 있습니다.

## 자주 묻는 질문

### 대화 하나에 보이스를 몇 개까지 쓸 수 있나요?

실행 한 번에 서로 다른 보이스를 최대 10개까지 쓸 수 있습니다. 같은 보이스를 여러 대사에 써도 한 번만 세므로, 두 사람이 나누는 40줄짜리 대화는 10개 중 2개만 씁니다.

### 대화는 얼마나 길 수 있나요?

모든 대사를 합쳐 ElevenLabs Dialogue v3에서는 최대 5,000자, ElevenLabs Dialogue v4에서는 최대 10,000자입니다. 2,000자 이내일 때 품질이 가장 좋습니다. 더 긴 대화는 텍스트로 대화 만들기 노드 여러 개로 나누고 오디오 합치기로 이어 붙이세요.

### 대화 한 번에 비용이 얼마나 드나요?

가격은 대본 길이에 따라 정해집니다. 모든 대사를 합친 글자 수에서 100자 단위(시작된 단위 포함)마다 두 모델 모두 5크레딧이 들고, 실행 한 번은 최소 8단위로 청구됩니다. 정확한 가격은 실행 전에 노드에 표시됩니다.

### 대사마다 별도의 오디오 파일로 받을 수 있나요?

아니요. 텍스트로 대화 만들기는 모든 대사를 순서대로 담은 연속된 파일 하나를 돌려주며, 각 대사가 시작하고 끝나는 위치는 녹취록 출력으로 알 수 있습니다. 클립을 따로 받으려면 대사마다 텍스트 음성 변환 노드를 하나씩 쓰세요.

### 작성한 대본을 자동으로 대사로 바꿀 수 있나요?

네. 대본 생성 노드의 대사 출력을 이 노드의 프롬프트 입력에 연결하세요. 설정 패널에서 대본에서 대사 12줄 채우기처럼 대사를 채우는 버튼을 클릭한 다음, 화자마다 보이스를 고르세요.

### 같은 결과를 다시 얻으려면 어떻게 하나요?

시드를 설정하세요. 시드, 대사, 설정이 같으면 같은 오디오가 다시 만들어집니다. 실행할 때마다 새로운 결과를 원하면 시드를 비워 두세요.