> For the complete documentation index, see [llms.txt](https://morphic.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://morphic.com/docs/kr/audio/voice-emotion-control.md).

# 음성 감정 제어

Morphic의 음성 감정 제어를 사용하면 감정 톤부터 반응, 속도, 전달 스타일까지 생성된 음성이 어떻게 들릴지 조절할 수 있습니다. 적절한 신호를 담아 프롬프트를 작성하면, 음성이 원하는 대로 표현됩니다.

## 음성 감정 제어 사용 방법

Morphic에서 음성 감정 제어를 사용하는 간단한 튜토리얼입니다:

1. Morphic를 열고 프로젝트로 이동하세요.
2. 새 파일을 만들거나 기존 파일을 여세요.
3. 하단의 프롬프트 바에서 모드를 'Audio'로 바꾸고 'Speech'를 선택하세요.
4. 오디오 모델을 선택하세요: 'ElevenLabs' 또는 'MiniMax'.
5. 음성 선택기에서 음성과 언어를 선택하세요.
6. 선택한 모델의 감정 제어 형식을 사용해 프롬프트를 작성하세요(아래 참조).
7. 'Generate'를 클릭하세요.

Morphic는 두 가지 음성 모델을 지원합니다. 각각 감정 제어에 다른 문법을 사용합니다. 모델을 선택한 뒤 아래 가이드를 따르세요.

## ElevenLabs

ElevenLabs는 프롬프트에 직접 작성하는 대괄호 태그를 사용합니다. 감정, 반응, 지시를 모두 대괄호로 감싸면, 모델은 이를 발화할 텍스트가 아닌 연기 신호로 해석합니다.

### 작동 방식

```
[tag] 여기에 대화 텍스트를 작성하세요.
```

태그는 새로운 태그가 나타날 때까지 그 뒤의 모든 내용에 영향을 줍니다. 태그는 텍스트 어디에나 넣을 수 있으며 여러 태그를 연속으로 조합할 수도 있습니다.

| 태그 없음                      | 태그 있음                                   |
| -------------------------- | --------------------------------------- |
| `내 역할을 얻었어. 정말로 역할을 얻었다고.` | `[excited] 내 역할을 얻었어. 정말로 역할을 얻었다고.`    |
| `우린 떠나야 해. 지금.`            | `[whispers][tense] 우린 떠나야 해. 지금.`       |
| `이게 잘 풀릴 것 같지 않아.`         | `[sad][hesitant] 이게 잘 풀릴 것 같지 않아.`      |
| `보물은 오래된 예배당 아래에 묻혀 있어.`   | `[pirate voice] 보물은 오래된 예배당 아래에 묻혀 있어.` |

ElevenLabs는 개방형입니다. 고정된 목록은 없습니다. 대괄호 안에 어떤 감정이나 지시도 적을 수 있으며, 모델은 이를 해석하려고 시도합니다. 다음과 같은 태그도 `[jealous]`, `[romantic]`, `[awkward]`, `[suspicious tone]`또는 `[continues after a beat]` 모두 작동합니다.

아래 태그들은 흔히 사용되며 안정적으로 효과적이지만, 이 목록에만 제한되지는 않습니다.

### 태그

**감정**

| 태그             | 기능              |
| -------------- | --------------- |
| `[excited]`    | 에너지가 높고 열정적인 전달 |
| `[happy]`      | 따뜻하고 경쾌한 톤      |
| `[cheerfully]` | 가볍고 밝은 전달       |
| `[sad]`        | 축 처지고 가라앉은 톤    |
| `[sorrowful]`  | 깊은 슬픔, 비통함      |
| `[angry]`      | 날카롭고 강한 전달      |
| `[nervous]`    | 불확실하고 약간 떨리는    |
| `[frustrated]` | 긴장되고 조급한 톤      |
| `[calm]`       | 안정적이고 편안한 전달    |
| `[tired]`      | 에너지가 낮고 지친      |
| `[curious]`    | 궁금해하고 묻는 듯한 톤   |
| `[sarcastic]`  | 건조하고 아이러니한 전달   |
| `[playful]`    | 가볍고 장난스러운 에너지   |
| `[deadpan]`    | 평평하고 무감정한 전달    |

다음 예시를 보세요:

```
[excited] 우리 자금 조달에 성공했어. 믿을 수가 없어. [nervous] 그런데 이제 정말 결과를 내야 해. [calm] 한 걸음씩 차근차근. 우리가 해결해 보자.
```

**감정의 뉘앙스**

톤의 미세한 변화를 위해 사용합니다. 전체 전달을 바꾸지 않으면서 문장에 깊이를 더합니다.

| 태그                | 기능               |
| ----------------- | ---------------- |
| `[hesitant]`      | 확신이 없고 주저하는      |
| `[relieved]`      | 짐이 내려가고 긴장이 풀린   |
| `[tense]`         | 긴장하고 무언가를 대비하는   |
| `[warm]`          | 부드럽고 배려하는 톤      |
| `[resigned tone]` | 체념하고 패배를 받아들이는   |
| `[stammers]`      | 말을 더듬으며 당황한      |
| `[regretful]`     | 무언가가 달랐으면 하고 바라는 |
| `[sympathetic]`   | 공감하고 이해하는        |
| `[reassuring]`    | 위로가 되고 안정적인      |
| `[awe]`           | 경이로움이나 놀라움에 사로잡힌 |

다음 예시를 보세요:

```
[tense] 뭔가 이상해. 느껴져. [relieved] 아, 너였구나. 다행이다. [warm] 이리 와. 네 걱정을 하고 있었어.
```

**반응**

문장 사이 또는 문장 안에 사실감을 더하는 비언어적 소리입니다.

| 태그                | 기능                         |
| ----------------- | -------------------------- |
| `[laughs]`        | 큰 웃음                       |
| `[giggles]`       | 작고 부드러운 웃음                 |
| `[light chuckle]` | 짧고 절제된 웃음                  |
| `[sigh]`          | 피로, 안도, 또는 좌절에서 나오는 한숨     |
| `[gasps]`         | 놀라거나 충격을 받았을 때 들이쉬는 날카로운 숨 |
| `[gulps]`         | 긴장한 침 삼킴                   |
| `[crying]`        | 눈물 섞인, 목이 메는 목소리           |
| `[clears throat]` | 빠른 목소리 리셋                  |

다음 예시를 보세요:

```
[laughs] 농담이지. [gasps] 잠깐, 진심이야? [clears throat] 좋아. 이걸 제대로 이야기해 보자.
```

**전달**

감정과 무관하게, 음성이 문장을 물리적으로 어떻게 수행할지 제어합니다.

| 태그                | 기능                 |
| ----------------- | ------------------ |
| `[whispers]`      | 부드럽고 숨결이 섞인 가까운 전달 |
| `[shouts]`        | 크고 또렷하게 뻗는 목소리     |
| `[quietly]`       | 낮은 볼륨, 절제된         |
| `[loudly]`        | 높은 볼륨, 강하게         |
| `[rushed]`        | 빠르고 급한 리듬          |
| `[drawn out]`     | 느리고 늘어진 전달         |
| `[dramatic tone]` | 연극적이고 강한 긴장감       |

다음 예시를 보세요:

```
[whispers] 문 바로 밖에 있어. [rushed] 지금 움직여야 해, 시간이 없어. [shouts] 달려!
```

**억양과 캐릭터**

음성은 바꾸지 않고 억양만 바꾸거나, 음성에 캐릭터 페르소나를 부여하세요.

| 태그                        | 기능                    |
| ------------------------- | --------------------- |
| `[American accent]`       | 표준 미국식 영어             |
| `[British accent]`        | 표준 영국식 영어             |
| `[French accent]`         | 프랑스식 억양이 섞인 영어        |
| `[Southern US accent]`    | 미국 남부식 말투             |
| `[Australian accent]`     | 호주식 영어                |
| `[strong Russian accent]` | 강한 러시아 억양             |
| `[strong X accent]`       | X를 어떤 국적이든 바꾸세요       |
| `[pirate voice]`          | 거칠고 해상 분위기가 나는 캐릭터    |
| `[old man voice]`         | 나이 들고 세월의 흔적이 있는 전달   |
| `[robot voice]`           | 기계적이고 인공적인 톤          |
| `[fantasy narrator]`      | 장대한 동화풍 내레이션          |
| `[film noir narrator]`    | 어둡고 분위기 있으며 냉소적인 내레이션 |
| `[sarcastically]`         | 건조하고 아이러니한 캐릭터 연기     |

다음 예시를 보세요:

```
[pirate voice] 보물은 오래된 예배당 아래, 세 길 깊이에 묻혀 있다. [old man voice] 이 마을에 흙길과 정직한 사람들밖에 없던 때가 기억나는구먼. [robot voice] 경고. 구조적 무결성 손상. 즉시 대피하십시오.
```

### 여러 캐릭터의 대화

한 프롬프트에 두 명 이상이 등장하는 장면을 쓸 때, 아래 태그로 대사 간 상호작용을 조절하세요.

| 태그               | 기능                      |
| ---------------- | ----------------------- |
| `[interrupting]` | 상대의 대사가 끝나기 전에 끼어듦      |
| `[overlapping]`  | 다른 목소리가 이어지는 동안 말하기 시작함 |

다음 예시를 보세요:

```
제가 말하려던 건 [interrupting] 아니, 그만. 이걸 그렇게 얼버무릴 수는 없어. [overlapping] 그런데 잠깐만 들어봐 주면...
```

### 멈춤과 속도 조절

ElevenLabs는 명시적인 일시정지 시간을 지원하지 않습니다. 일시정지 길이는 문맥, 태그, 구두점에서 추론됩니다.

| 이렇게 작성하세요 | 기능                 |
| --------- | ------------------ |
| `[pause]` | 극적인 침묵(길이는 모델이 결정) |
| `...`     | 주저하며 이어지는 멈춤       |
| 모두 대문자    | 단어에 강조             |
| 새 문단      | 명확한 멈춤과 억양 재설정     |

다음 예시를 보세요:

```
"음... 응, 그런 것 같아."

"[pause] 그리고 그 일이 일어났습니다."

"내가 지금 당장 하라고 했잖아!"
```

### 더 나은 결과를 위한 팁

| 팁                            | 효과가 있는 이유                                                                                         |
| ---------------------------- | ------------------------------------------------------------------------------------------------- |
| 태그를 텍스트에 맞추기                 | `[crying] 나를 떠나지 마.` 는 자연스럽게 들립니다. 일상적인 문장에 `[crying]` 을 추가하면 자연스럽지 않습니다. 모델은 문맥을 위해 전체 문장을 읽습니다. |
| 태그를 조합하기                     | `[whispers][tense]` 또는 `[hesitant][nervous]` 는 모델에 두 가지 신호를 주어 더 미묘한 결과를 만들 수 있게 합니다.             |
| 맞는 음성 선택하기                   | 차분한 음성은 설득력 있게 소리치지 못합니다. 에너지가 높은 음성은 속삭임에 적합하지 않습니다. 역할에 맞는 음성을 선택하세요.                           |
| Creative 또는 Natural 안정성 사용하기 | 이 설정들은 모델이 태그를 더 잘 표현할 수 있는 여지를 줍니다. Robust는 더 일관적이지만 표현력은 덜합니다.                                  |
| 구두점을 리듬 신호로 사용하기             | 쉼표는 속도를 늦춥니다. 마침표는 강한 멈춤을 만듭니다. 말줄임표는 흐트러져 이어집니다. 모델은 구두점을 읽고 그에 반응합니다.                           |

## Google Gemini 3.1 Flash TTS

Gemini 3.1 Flash TTS는 다양한 언어에 걸쳐 톤, 속도, 억양을 정교하게 제어할 수 있는 표현력 풍부한 다국어 내레이션을 제공합니다. 제어 방식은 두 가지입니다. 자연어 지시문과, 스크립트 안에 직접 넣는 인라인 신호입니다.

### 작동 방식

Gemini는 자연어로 작성한 지시를 읽고 그에 맞게 전달 방식을 조절합니다. 먼저 지시를 쓰고, 그다음에 대사를 적으세요.

| 지시 없음             | 지시 있음                                           |
| ----------------- | ----------------------------------------------- |
| 폭풍은 지나갔어. 이제 안전해. | 이 문장을 따뜻하고 천천히, 아이를 달래듯 말하세요: 폭풍은 지나갔어. 이제 안전해. |

대괄호 안에 인라인 신호를 넣어 반응을 추가하고, 문장 중간에 전달 방식을 바꿀 수도 있습니다. Gemini는 그 신호를 읽는 대신 연기합니다.

다음 예시를 보세요: `네가 그런 짓을 하다니 믿을 수 없어 [laughs]. 올해 최고의 깜짝 선물이네.`

### 태그

원하는 위치에 맞춰 대괄호 안에 신호를 바로 넣으세요. Gemini는 그 신호를 읽는 대신 연기하며, 한 스크립트에 둘 이상도 사용할 수 있습니다.

반응 및 소리:

| 태그                  | 기능                      |
| ------------------- | ----------------------- |
| \[laughs]           | 자연스러운 웃음을 추가합니다         |
| \[laughs nervously] | 긴장한 웃음을 추가합니다           |
| \[sighs]            | 한숨을 추가합니다               |
| \[gasps]            | 날카롭게 숨을 들이쉬는 소리를 추가합니다  |
| \[exhales]          | 들을 수 있는 숨 내쉬기를 추가합니다    |
| \[scoffs]           | 무시하는 콧방귀를 추가합니다         |
| \[clears throat]    | 문장 앞에 목을 가다듬는 소리를 추가합니다 |
| \[crying]           | 눈물 섞인 상태로 문장을 전달합니다     |

전달과 톤:

| 태그              | 기능                |
| --------------- | ----------------- |
| \[whispering]   | 목소리를 속삭임으로 낮춥니다   |
| \[normal voice] | 일반 말투로 돌아갑니다      |
| \[softly]       | 전달을 부드럽게 합니다      |
| \[shouting]     | 목소리를 외침으로 높입니다    |
| \[slowly]       | 속도를 늦춥니다          |
| \[excited]      | 에너지와 흥분을 더합니다     |
| \[nervously]    | 긴장되고 주저하는 톤을 더합니다 |

다음 예시를 보세요: `[whispering] 소리 내지 마. [normal voice] 좋아, 이제 안전해.`

톤, 에너지, 억양은 문장 앞에 원하는 내용을 자연어로 설명하세요. Gemini는 언어 전반에 걸쳐 억양 제어를 지원합니다.

다음 예시를 보세요: `이걸 영국식 억양으로 읽어 주세요: 오늘 날씨가 참 좋네요, 그렇죠?`

### 여러 화자 대화

Gemini는 한 번의 생성으로 두 화자의 대화를 연기할 수 있으며, 각 화자에게 서로 다른 음성을 부여합니다. 각 줄에 화자 이름을 붙인 뒤, 생성 전에 각 화자에게 음성을 지정하세요. Gemini는 대화당 최대 두 화자를 지원합니다.

다음 예시를 보세요:

```
마야: 채용 결과 연락 받았어?
톰: 받았어. 월요일부터 시작해.
마야: 대단하다, 축하해.
```

| 요소     | 해야 할 일                            |
| ------ | --------------------------------- |
| 화자 라벨  | 각 줄을 화자 이름과 콜론으로 시작하세요            |
| 화자별 음성 | 생성 전에 이름이 있는 각 화자에게 고유한 음성을 지정하세요 |
| 화자 제한  | 한 대화에 최대 두 명의 서로 다른 화자            |

### 멈춤과 속도 조절

말줄임표로 잠깐의 침묵을 추가하고, 원하는 속도를 지시문에 적으세요.

| 방법          | 예시                                       |
| ----------- | ---------------------------------------- |
| 멈춤을 위한 말줄임표 | `잠깐... ... ... 그 소리 들었어?`                |
| 지시문에서 속도 지정 | `이 문장을 천천히, 의도적으로 읽으세요: 모든. 단어가. 중요합니다.` |

### 더 나은 결과를 위한 팁

| 팁            | 도움이 되는 이유                                                    |
| ------------ | ------------------------------------------------------------ |
| 지시를 문장 앞에 두기 | Gemini는 그 뒤에 오는 텍스트에 지시를 적용합니다                               |
| 장면 설정하기      | 다음과 같은 문맥 `자연 다큐멘터리를 내레이션하듯, 차분하고 낮은 목소리로:` 는 톤과 전달 방식을 만듭니다 |
| 방법 결합하기      | 같은 스크립트에서 자연어 지시와 인라인 대괄호 신호를 함께 사용하세요                       |
| 언어와 음성을 맞추기  | 생성하기 전에 스크립트에 맞는 음성과 언어를 선택하세요                               |

## MiniMax

MiniMax는 **괄호형 소리 태그** 를 프롬프트에 사용하고, 별도의 **감정 선택기** 를 Morphic UI에서 사용합니다.

### 감정

생성할 때 드롭다운에서 감정을 선택하세요. 이렇게 하면 전체 출력의 전반적인 톤이 설정됩니다.

| 감정  | 효과                                |
| --- | --------------------------------- |
| 자동  | 모델이 텍스트를 읽고 가장 적합한 감정을 선택합니다(기본값) |
| 행복  | 경쾌하고 긍정적                          |
| 슬픔  | 축 처지고 우울한                         |
| 분노  | 강하고 공격적인                          |
| 두려움 | 불안하고 겁먹은                          |
| 혐오  | 역겹고 거부하는                          |
| 놀람  | 깜짝 놀라고 놀라워하는                      |
| 차분함 | 편안하고 고요한                          |
| 유창함 | 깔끔한 방송 스타일 — 뉴스나 기술 내레이션에 이상적     |
| 중립  | 감정적 편향 없음                         |

### 소리 태그

괄호를 사용해 비언어적 소리를 프롬프트에 직접 추가하세요. 이것들은 **사전 설정만** 지원됩니다 — 아래에 나열된 태그만 사용할 수 있습니다.

```
정말 대단하네요 (laughs) 실제로 작동하다니 믿을 수가 없어요.
결과는... 예상 밖이었어요. (sighs) 설명해 드릴게요.
```

| 태그          | 태그       | 태그         |
| ----------- | -------- | ---------- |
| `(웃음)`      | `(낄낄)`   | `(기침)`     |
| `(목을 가다듬음)` | `(신음)`   | `(숨)`      |
| `(헐떡임)`     | `(들이숨)`  | `(내쉼)`     |
| `(헉)`       | `(킁킁)`   | `(한숨)`     |
| `(코웃음)`     | `(트림)`   | `(입맛 다시기)` |
| `(흥얼거림)`    | `(쉿 소리)` | `(음)`      |
| `(휘파람)`     | `(재채기)`  | `(우는 소리)`  |
| `(박수)`      | `(하품)`   |            |

> ElevenLabs와 달리, 당신은 **할 수 없습니다** 사용자 지정 태그를 만들기. 작성 `(긴장)` 또는 `(질투)` 작동하지 않습니다 — 모델이 이를 텍스트로 읽게 됩니다. 감정적 톤에는 감정 선택기를 사용하세요.

### 일시 정지

다음으로 시간 지정 무음을 삽입하세요 `<#x#>` 여기서 `x` 는 초 단위입니다(0.01–99.99).

```
결과는 예상 밖이었습니다. <#1.2#> 왜 그런지 살펴봅시다.
얘기할 게 있습니다. <#0.5#> 중요합니다.
```

### 팁

* 사운드 태그는 아껴서 사용하세요 — 너무 많으면 부자연스럽게 들릴 수 있습니다.
* 감정을 **자동** 대부분의 경우로 설정하세요. 긴 텍스트에서 일관된 톤이 필요할 때는 수동으로 재정의하세요.
* 구두점이 중요합니다 — 쉼표와 마침표가 모델의 속도와 억양을 안내합니다.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://morphic.com/docs/kr/audio/voice-emotion-control.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
