> ## 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.

# Fish Audio Drama 3: 디렉션, 단어 태그, 템플릿

> ComfyUI에서 Fish Audio Drama 3 모델을 실행하세요: 자연어 디렉션과 짝을 이룬 단어 태그로 연기를 연출하고, 미리 만들어진 Drama 3 워크플로 템플릿을 사용하세요.

Drama 3은 음성 연출을 위해 만들어진 Fish Audio의 최신 텍스트 기반 음성 생성 모델입니다. 장면 전체를 하나의 대본으로 작성하고, 발화 방식은 텍스트 안에 평이한 언어로 설명하며, 짝을 이루는 단어 태그는 자신이 감싼 단어만 변경합니다. ComfyUI에서는 `model`을 `drama-3`으로 설정한 Fish Audio Text to Speech 노드에서 실행됩니다. 다른 Fish Audio 모델은 [Fish Audio: 텍스트 기반 음성 생성, 음성 복제, 음성 텍스트 변환](/ko/tutorials/partner-nodes/fishaudio/fish-audio)을 참조하세요.

<Tip>
  파트너 노드를 사용하려면 올바르게 로그인되어 있고 허가된 네트워크 환경을 사용하고 있는지 확인해야 합니다. 파트너 노드를 사용하기 위한 구체적인 요구사항은 문서의 [파트너 노드 개요](/ko/tutorials/partner-nodes/overview) 섹션을 참조해 주세요.
</Tip>

<Tip>
  <Tabs>
    <Tab title="로컬 사용자">
      ComfyUI가 최신 버전으로 업데이트되었는지 확인하세요.

      * [ComfyUI 다운로드](https://www.comfy.org/download)
      * [업데이트 가이드](/ko/installation/update_comfyui)

      이 가이드의 워크플로는 [워크플로 템플릿](/ko/interface/features/template)에서 확인할 수 있습니다.
      템플릿에서 찾을 수 없다면, 귀하의 ComfyUI가 오래된 버전일 수 있습니다.

      워크플로를 로드할 때 노드가 누락되는 경우, 가능한 원인:

      1. 최신 ComfyUI 버전(최신 테스트 버전(nightly))을 사용하고 있지 않음
      2. 일부 노드가 시작 시 가져오기에 실패함
    </Tab>

    <Tab title="클라우드 사용자">
      * [클라우드](https://cloud.comfy.org)는 ComfyUI 안정판 출시 후 업데이트됩니다.

      따라서 이 문서에서 핵심 노드가 누락된 것을 발견했다면, 그 이유는 새로운 핵심 노드가 아직 최신 안정판에 공개되지 않았기 때문일 수 있습니다. 다음 안정판 출시를 기다려 주세요.
    </Tab>
  </Tabs>
</Tip>

## ComfyUI에서 Drama 3 사용하기

Fish Audio 파트너 노드는 노드 메뉴의 `partner/audio/Fish Audio` 아래에서 사용할 수 있으며, Drama 3는 다른 모델들과 동일한 노드를 사용합니다: Text to Speech, Speech to Text, Voice Selector, Instant Voice Clone.

### 모델 선택

Text to Speech 노드에서 `model`을 `drama-3`로 설정합니다.

### 보이스 연결

Voice Selector 또는 Instant Voice Clone의 `voice` 출력은 Text to Speech 노드에 연결됩니다. `drama-3`는 최대 5개의 슬롯을 가진 확장 가능한 `voices` 입력을 제공합니다. 보이스가 하나 연결된 경우, 노드는 이를 내부적으로 `reference_id`로 전달합니다. 두 개 이상인 경우, 텍스트에서 `@Voice1`, `@Voice2` 등으로 화자를 표시해야 하며, 연결된 모든 보이스가 텍스트에 최소 한 번 이상 나타나야 합니다. 그렇지 않으면 노드에서 오류가 발생합니다.

## 연기 연출하기

`drama-3`는 스크립트 자체에서 연출 지시를 받습니다. 대괄호 안에 평범한 문장으로 적은 지시는 그 지점부터 전달 방식을 바꾸고, 짝을 이루는 단어 태그는 감싼 단어만 변경합니다:

```text theme={null}
[calm and inviting] Welcome back to the studio.
[leans in, conspiratorial] There is one trick nobody tells you about.
[light, playful] Ready? <whisper>It is all in the timing.</whisper> [bright, back to full voice] And that is the whole secret.
```

### 전달 방식 묘사하기

지시는 적용할 단어 앞에 대괄호로 넣고, 성우에게 브리핑하듯 작성하세요. 감정, 의도, 속도, 또는 캐릭터가 누구에게 말하는지 등을 적으면 됩니다.

```text theme={null}
[barely holding it together, forcing a smile] I'm fine. Really. Go on without me.
[professional broadcast tone] And now, the headlines.
```

지시는 다음 지시가 나올 때까지 적용됩니다. 줄 맨 앞의 `[calm]`은 다른 지시가 대체하지 않는 한 그 줄 전체에 유지되며, 한 줄에 여러 지시가 있으면 그 줄 안에서 전달 방식이 바뀝니다.

### 사운드와 멈춤 추가하기

한숨, 웃음, 숨소리처럼 사운드나 멈춤이 일어나야 하는 지점에 대괄호로 작성하세요:

```text theme={null}
I'm fine. [shaky breath] Really. [small laugh] Go on without me.
```

### 어떤 언어로든 연출하기

지시는 스크립트의 언어와 일치할 필요가 없습니다. 영어 스크립트를 중국어로 연출할 수 있고, 그 반대도 가능합니다:

```text theme={null}
[像是在强忍着眼泪，却努力笑着] I'm fine. Really. Go on without me.
```

### 특정 단어만 변경하기

단어를 짝 태그로 감싸면 해당 단어의 전달 방식만 변경됩니다. 지원되는 태그는 `<whisper>`, `<emphasis>`, `<soft>`, `<fast>`, `<slow>`, `<stress>`, `<forceful>`입니다:

```text theme={null}
It is going to <emphasis>blow</emphasis>.
I'm fine. Really. <whisper>Go on without me.</whisper>
```

### 문장 중간에 언어 전환하기

<Note>Fish Audio는 언어 태그를 실험적으로 분류합니다.</Note>

구절을 언어 태그로 감싸면 해당 단어의 언어만 전환됩니다. 두 언어가 섞인 줄이나, 특정 구절을 다른 언어로 읽어야 할 때 유용합니다:

```text theme={null}
She looked at the menu and said <french>Je voudrais une table pour deux, s'il vous plaît.</french> The waiter smiled.
```

### 함께 결합하기

지시, 단어 태그, [음소 태그](/ko/tutorials/partner-nodes/fishaudio/prompt-guide#음소-제어)는 모두 같은 스크립트에서 작동하며, 여러 화자가 등장하는 턴 안에서도 마찬가지입니다:

```text theme={null}
@Voice1 [calm and inviting] Welcome back to the studio.
@Voice2 [leans in, conspiratorial] There is one trick nobody tells you about.
@Voice1 [light, playful] Ready? <whisper>It is all in the timing.</whisper> [bright, back to full voice] And that is the whole secret.
```

[프롬프트 가이드](/ko/tutorials/partner-nodes/fishaudio/prompt-guide)의 감정, 어조, 효과 태그는 다른 모델에 해당합니다. `drama-3`에서는 이 페이지의 지시와 단어 태그를 대신 사용하세요.

## 사용 가능한 워크플로

두 개의 미리 만들어진 템플릿이 Drama 3를 다룹니다: 단일 연출 퍼포먼스와 두 화자 대화입니다. ComfyUI의 템플릿 라이브러리에서 열거나 Comfy Cloud에서 직접 실행할 수 있습니다. 둘 다 ComfyUI 0.39.3 이상이 필요합니다.

<h3 id="api_fishaudio_drama3_directed">
  Fish Audio Drama 3: 연출 퍼포먼스
</h3>

하나의 음성으로 하나의 대본을 연기합니다. `text` 필드의 지시문은 줄마다 전달 방식을 바꾸고, `<whisper>...</whisper>`는 줄의 나머지는 바꾸지 않으면서 몇 단어만 바꿉니다. 템플릿은 Delia 프리셋 음성에서 시작하며, Voice Selector에서 이를 교체할 수 있습니다.

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_fishaudio_drama3_directed-1.webp" alt="Fish Audio Drama 3: 연출 퍼포먼스 워크플로 미리보기" />

<CardGroup cols={2}>
  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=api_fishaudio_drama3_directed&utm_source=docs&utm_medium=referral&utm_campaign=fishaudio">
    Comfy Cloud에서 열기
  </Card>

  <Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_fishaudio_drama3_directed.json">
    JSON을 다운로드하거나 템플릿 라이브러리에서 "Fish Audio Drama 3: Directed Performance"를 검색하세요
  </Card>
</CardGroup>

**입력 자료**

이 파일을 일치하는 `LoadAudio` 노드에 업로드하세요:

<CardGroup cols={2}>
  <Card title="fish_audio_example.mp3" icon="music" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/fish_audio_example.mp3">
    `LoadAudio` 노드 11 · `fish_audio_example.mp3`
  </Card>
</CardGroup>

<h3 id="api_fishaudio_drama3_dialogue">
  Fish Audio Drama 3: 두 화자 대화
</h3>

한 번의 실행으로 전체 장면을 생성하며, 화자별로 하나의 Voice Selector를 사용하고 대본에 대화 태그를 넣습니다. 템플릿에는 Delia와 Sheila 프리셋 음성이 함께 제공됩니다:

```text theme={null}
[deep, cinematic narrator] @Voice1 Every night, the city tells a story.
[soft, close, like a secret] @Voice2 But only one voice ever finishes it.
[drops to a whisper, then brightens] @Voice1 Fish Audio Drama 3, <whisper>now in ComfyUI</whisper>.
```

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_fishaudio_drama3_dialogue-1.webp" alt="Fish Audio Drama 3: 두 화자 대화 워크플로 미리보기" />

<CardGroup cols={2}>
  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=api_fishaudio_drama3_dialogue&utm_source=docs&utm_medium=referral&utm_campaign=fishaudio">
    Comfy Cloud에서 열기
  </Card>

  <Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_fishaudio_drama3_dialogue.json">
    JSON을 다운로드하거나 템플릿 라이브러리에서 "Fish Audio Drama 3: Two-Speaker Dialogue"를 검색하세요
  </Card>
</CardGroup>

**입력 자료**

이 파일을 일치하는 `LoadAudio` 노드에 업로드하세요:

<CardGroup cols={2}>
  <Card title="fish_audio_example.mp3" icon="music" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/fish_audio_example.mp3">
    `LoadAudio` 노드 11 · `fish_audio_example.mp3`
  </Card>
</CardGroup>

## 계정 및 가격

이 노드를 사용하려면 ComfyUI 계정으로 로그인해야 하며, 사용량에 따라 과금됩니다. Drama 3은 출시 기념 프로모션 기간 동안 텍스트 1M 바이트당 약 $14.30이며, 2026년 11월 13일부터는 $35.75입니다. 크레딧 요율과 프로모션 기간은 [파트너 노드 가격](/ko/tutorials/partner-nodes/pricing)을 참조하세요.

## 시작하기

1. ComfyUI를 0.39.3 이상으로 업데이트하세요
2. 위의 Drama 3 템플릿 중 하나를 열거나, `partner/audio/Fish Audio`에서 Fish Audio 노드를 추가하세요
3. Text to Speech 노드에서 `drama-3`을 선택하고 Voice Selector 또는 Instant Voice Clone을 통해 음성을 연결하세요
4. [디렉션과 단어 태그](#연기-연출하기)로 스크립트를 작성한 다음 실행하세요


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.