> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Fish Audio 프롬프트 가이드: ComfyUI에서 Fish Audio TTS 프롬프트 작성하기

> ComfyUI의 Fish Audio 파트너 노드용 프롬프트 작성법: 감정 태그, 톤 마커, 오디오 이펙트, 멈춤, 음소 제어, 다중 화자 대화.

Fish Audio TTS는 텍스트 안에 직접 작성하는 인라인 태그로 음성의 들리는 방식을 직접 제어할 수 있습니다. 이 가이드는 모델이 이해하는 모든 태그 카테고리, 배치 방법, 조합 방법을 다룹니다.

아래 예제는 Fish Audio Text to Speech 노드에서 바로 사용할 수 있습니다. `text` 필드에 입력하고 샘플 문장을 자신의 대사로 바꾸세요. 노드 연결, 워크플로 템플릿, 가격은 [Fish Audio: 텍스트-음성, 보이스 클론, 음성-텍스트](/ko/tutorials/partner-nodes/fishaudio/fish-audio)를 참고하세요.

## 태그 작동 방식

Fish Audio S2 모델은 대괄호로 작성된 자연어 지시를 해석합니다:

```text theme={null}
[happy] What a beautiful day!
[sad] I'm sorry to hear that.
[excited] This is amazing news!
```

이 시스템에는 세 가지 특징이 있습니다:

* **위치가 곧 의미입니다.** 태그는 나타난 위치부터 다음 태그 또는 문장 끝까지 적용됩니다. `[whispering] I didn't want to go inside`는 전체를 속삭이고, `I didn't want to go [whispering] inside`는 "inside"부터 속삭이기 시작합니다.
* **자유로운 설명도 됩니다.** 고정된 태그 세트에 제한되지 않습니다. 성우에게 설명할 수 있는 것은 무엇이든 대괄호에 쓸 수 있습니다: `[tired, end of a long shift]`, `[voice rough from crying, trying to sound normal]`, `[professional broadcast tone]`.
* **태그는 자신의 언어로 쓸 수 있습니다.** 대사와 같은 언어로 지시를 작성하세요: `[低声说] 不要让他们听见`, `[ため息をついて] もう一度やり直そう`.

레거시 `s1` 모델은 같은 감정 이름을 소괄호로 감싸며 고정 태그 세트만 지원합니다: `(happy) What a beautiful day!` 현재 `s2.1-pro` 모델은 대괄호 지시와 자유로운 설명을 받습니다.

## 감정 태그

### 기본 감정

| 태그 | 표현 | 자주 쓰는 상황 |
| - | - | - |
| `[happy]` | 밝고 경쾌 | 좋은 소식, 인사 |
| `[sad]` | 우울, 침울 | 위로, 나쁜 소식 |
| `[angry]` | 짜증, 공격적 | 불만, 경고 |
| `[excited]` | 활기찬, 열정적 | 발표, 축하 |
| `[calm]` | 평온, 이완 | 안내, 명상 |
| `[nervous]` | 불안, 머뭇거림 | 면책, 사과 |
| `[confident]` | 자신감 | 프레젠테이션, 영업 |
| `[surprised]` | 놀람 | 반응, 발견 |
| `[satisfied]` | 만족 | 확인, 리뷰 |
| `[delighted]` | 매우 기쁨 | 축하, 칭찬 |
| `[scared]` | 두려움 | 경고, 공포 이야기 |
| `[worried]` | 걱정 | 우려, 질문 |
| `[upset]` | 동요, 괴로움 | 불만, 문제 |
| `[frustrated]` | 답답함 | 장애, 지연 |
| `[depressed]` | 절망 | 심각한 주제 |
| `[empathetic]` | 공감, 배려 | 지원, 상담 |
| `[embarrassed]` | 창피, 어색 | 사과, 실수 |
| `[disgusted]` | 혐오 | 부정 리뷰 |
| `[moved]` | 감동 | 감동적인 순간 |
| `[proud]` | 자부심 | 성취, 칭찬 |
| `[relaxed]` | 편안, 캐주얼 | 일상 대화 |
| `[grateful]` | 감사 | 감사 인사 |
| `[curious]` | 호기심 | 질문, 탐구 |
| `[sarcastic]` | 비꼼 | 유머, 비판 |

### 심화 감정

| 태그 | 표현 | 자주 쓰는 상황 |
| - | - | - |
| `[disdainful]` | 경멸 | 비판, 거절 |
| `[unhappy]` | 불만 | 불만, 피드백 |
| `[anxious]` | 심한 걱정 | 긴급한 일 |
| `[hysterical]` | 감정 폭발 | 극단적 반응 |
| `[indifferent]` | 무관심, 중립 | 중립적 응답 |
| `[uncertain]` | 확신 없음 | 추측, 질문 |
| `[doubtful]` | 의심 | 불신, 재질문 |
| `[confused]` | 혼란 | 확인 요청 |
| `[disappointed]` | 실망 | 기대 이하 |
| `[regretful]` | 후회 | 사과, 실수 |
| `[guilty]` | 죄책감 | 고백, 사과 |
| `[ashamed]` | 깊은 창피 | 심각한 실수 |
| `[jealous]` | 질투 | 비교 |
| `[envious]` | 부러움 | 갈망이 섞인 감탄 |
| `[hopeful]` | 미래에 대한 희망 | 향후 계획 |
| `[optimistic]` | 낙관적 | 격려 |
| `[pessimistic]` | 비관적 | 경고, 의심 |
| `[nostalgic]` | 그리움 | 추억, 이야기 |
| `[lonely]` | 고독 | 감성 콘텐츠 |
| `[bored]` | 지루함 | 무관심 |
| `[contemptuous]` | 멸시 | 강한 비판 |
| `[sympathetic]` | 동정 | 조의 |
| `[compassionate]` | 깊은 연민 | 지원, 도움 |
| `[determined]` | 결심 | 목표, 약속 |
| `[resigned]` | 체념, 수용 | 포기, 받아들임 |

## 톤 마커

톤 마커는 음량, 강도, 강세를 제어합니다. `[emphasis]`는 강조할 단어나 구 바로 앞에 놓습니다:

```text theme={null}
This is [emphasis] really important.
```

| 태그 | 표현 | 사용 시점 |
| - | - | - |
| `[in a hurry tone]` | 서두르는, 급한 | 시간에 민감한 정보 |
| `[shouting]` | 큰 소리, 외침 | 주의 끌기 |
| `[screaming]` | 비명, 공황 | 비상 상황, 공포 |
| `[whispering]` | 아주 작은 목소리 | 비밀, 조용한 장면 |
| `[soft tone]` | 부드럽고 조용 | 위로, 자장가 |
| `[emphasis]` | 단어나 구 강세 | 핵심 단어 강조 |

## 오디오 이펙트

오디오 이펙트 태그는 자연스러운 사람 소리를 추가합니다. 권장 텍스트가 있는 태그는 뒤에 해당 텍스트를 이어 주세요:

| 태그 | 설명 | 태그 뒤 권장 텍스트 |
| - | - | - |
| `[laughing]` | 큰 웃음 | Ha, ha, ha |
| `[chuckling]` | 가벼운 웃음 | Heh, heh |
| `[sobbing]` | 세게 울음 | 텍스트 선택 |
| `[crying loudly]` | 격한 울음 | 텍스트 선택 |
| `[sighing]` | 안도 또는 답답함의 한숨 | sigh |
| `[groaning]` | 답답함의 신음 | ugh |
| `[panting]` | 헐떡임 | huff, puff |
| `[gasping]` | 숨을 삼킴 | gasp |
| `[yawning]` | 하품 | yawn |
| `[snoring]` | 코골이 | zzz |
| `[clear throat]` | 헛기침 | ahem |

## 멈춤과 특수 이펙트

| 태그 | 설명 |
| - | - |
| `[break]` | 짧은 멈춤 |
| `[long-break]` | 긴 멈춤 |
| `[short pause]` | 짧은 간격 |
| `[long pause]` | 긴 침묵 |
| `[audience laughing]` | 관객 웃음소리 |
| `[background laughter]` | 배경 웃음소리 |
| `[crowd laughing]` | 군중 웃음소리 |

일반 연결어("um", "uh", "嗯", "啊")도 태그 없이 리듬을 만듭니다.

## 태그 조합

**신체 반응 태그와 감정 태그를 짝지으세요.** `[panting]`, `[whispering]` 같은 신체 태그는 단독으로도 작동하지만, 감정 태그와 조합하면 더 일관되고 자연스럽습니다:

```text theme={null}
[panting] [tired] I've been running for twenty minutes.
[whispering] [scared] Don't move. Don't make a sound.
[shouting] [angry] I told you this would happen!
```

**감정을 겹쳐 복잡한 표현을 만드세요.** 문장당 조합은 3개 이하로 유지합니다:

```text theme={null}
[sad][whispering] I miss you so much.
[angry][shouting] Get out of here now!
[excited][laughing] We won! Ha ha!
```

**감정 전환**을 문장에 걸친 자연스러운 흐름으로 작성하세요:

```text theme={null}
[happy] I got the promotion!
[uncertain] But... it means relocating.
[sad] I'll miss everyone here.
[hopeful] Though it's a great opportunity.
[determined] I'm going to make it work!
```

**배경 이펙트**로 분위기를 더하세요:

```text theme={null}
The comedy show was amazing [audience laughing]
```

**강도 수식어**로 감정의 세기를 조절하세요:

```text theme={null}
[slightly sad] I'm a bit disappointed.
[very excited] This is absolutely amazing!
[extremely angry] This is unacceptable!
```

## 모범 사례

**권장:**

* 문장마다 주요 감정을 하나만 사용
* 감정을 문맥과 논리적으로 일치
* 효과음 태그 뒤에 텍스트 추가 (예: `[laughing]` 뒤에 "Ha ha")
* 감정 변화 간격을 띄워 현실감 확보
* 같은 목소리로 다양한 조합 테스트

**비권장:**

* 짧은 텍스트에서 태그 남용
* 한 문장에 상충하는 감정 혼합
* 대괄호 설명이 너무 길어 흐름을 해치는 것
* 설명 태그 뒤에 대사를 두지 않는 것
* 문장 수준 감정 지시를 제어할 문장에서 멀리 두는 것

출력이 부자연스럽게 들리면 감정 변화 간격을 띄우거나, 강도를 낮추거나, 다른 목소리를 시도하세요. 같은 태그도 목소리에 따라 효과가 다릅니다.

## 다중 화자 대화

Fish Audio Text to Speech 노드에 두 개 이상의 목소리를 연결하고, 텍스트에서 `@Voice1`, `@Voice2` 등으로 화자 전환을 표시합니다. 연결된 모든 목소리가 텍스트에 최소 한 번은 나타나야 하며, 그렇지 않으면 노드가 오류를 냅니다. 목소리 연결 방법은 [Fish Audio: 텍스트-음성, 보이스 클론, 음성-텍스트](/ko/tutorials/partner-nodes/fishaudio/fish-audio#목소리-연결)를 참고하세요.

```text theme={null}
@Voice1 [nervous] You're sure no one followed you?
@Voice2 [calm] Relax. I took the long way, exactly like you asked.
@Voice1 [sighing][relieved] Good. Then let's see what's inside.
@Voice2 [curious] You don't even know what it is?
```

## 음소 제어

음소 태그는 이름, 다자(多字), 두문자어, 전문 용어의 정확한 발음을 지정합니다. 대체 발음을 `<|phoneme_start|>`와 `<|phoneme_end|>` 태그로 감쌉니다. 음소 태그는 텍스트 정규화에서도 보존되므로 `normalize`를 켜 두면 됩니다.

**영어** (CMU Arpabet, 단어 1개 대체):

```text theme={null}
I am an <|phoneme_start|>EH1 N JH AH0 N IH1 R<|phoneme_end|>.
```

**중국어** (성조 표기 병음, 글자 1개 또는 음절 대체, 다자(多音字)와 고유명사에 유용):

```text theme={null}
我是一个<|phoneme_start|>gong1<|phoneme_end|><|phoneme_start|>cheng2<|phoneme_end|><|phoneme_start|>shi1<|phoneme_end|>。
```

**일본어** (OpenJTalk 방식 로마자＋억양 번호):

```text theme={null}
<|phoneme_start|>ha0shi1ga0<|phoneme_end|>見えます。
```

음소 제어는 다른 태그와 같은 텍스트에서 조합할 수 있습니다:

```text theme={null}
I am, um, an [break] <|phoneme_start|>EH1 N JH AH0 N IH1 R<|phoneme_end|>.
```

## 파라미터 조정

기본값은 잘 조정되어 있습니다. 필요할 때만 변경하세요:

| 파라미터 | 기본값 | 효과 |
| - | - | - |
| `temperature` | 0.7 | 표현력. 높을수록 다양, 낮을수록 일관 |
| `top_p` | 0.7 | nucleus sampling 기반 다양성 |
| `speed` | 1.0 | 말 속도, 0.5에서 2.0 |
| `volume` | 0.0 | 음량 조정(데시벨), -10에서 10 |
| `normalize` | true | 숫자와 날짜를 자연스럽게 읽도록 확장. 정규화가 그대로 읽고 싶은 텍스트를 바꾸는 경우가 아니면 켜 둠 |

`seed`는 노드 재실행 여부만 제어합니다. seed 값과 무관하게 결과는 비결정적입니다.

## 보이스 클론 품질

Fish Audio Instant Voice Clone 노드에서는 참조 녹음 품질이 결과를 결정합니다. 녹음 제한은 [Fish Audio: 텍스트-음성, 보이스 클론, 음성-텍스트](/ko/tutorials/partner-nodes/fishaudio/fish-audio#클론-제한)를 참고하세요:

* 15~~20초 클립 2~~3개, 총 270초 이내
* 화자는 한 명만, 일정한 음량, 일관된 톤과 감정
* 문장 사이에 0.5초 정도의 짧은 멈춤
* 조용한 방, 마이크는 입에서 한 뼘 정도
* 휴대폰 녹음이나 헤드셋 마이크로도 충분합니다. 배경 음악, TV, 잔향은 피하세요

클론한 목소리가 로봇처럼 들리면 총 30\~60초로 소재를 늘리고, 멈춤을 넣으며 자연스럽게 말하세요.

자신의 목소리, 또는 명시적 허락을 받은 사람의 목소리처럼 사용 권한이 있는 목소리만 클론하세요.

## 참고 자료

* [Fish Audio 감정 제어 문서](https://docs.fish.audio/developer-guide/core-features/emotions)
* [Fish Audio 파인그레인 제어 문서](https://docs.fish.audio/developer-guide/core-features/fine-grained-control)
* [Fish Audio 보이스 클론 모범 사례](https://docs.fish.audio/developer-guide/best-practices/voice-cloning)


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