> ## 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, 보이스 클론, 음성 전사 워크플로 실행하기: 템플릿 사용법, 노드 연결, Cloud 링크

Fish Audio는 텍스트 기반 음성 생성, 보이스 복제, 음성 인식을 아우르는 음성 AI 서비스입니다. ComfyUI에서는 Text to Speech, Speech to Text, Voice Selector, Instant Voice Clone의 네 가지 파트너 노드로 제공됩니다. 이 페이지에서는 미리 만들어진 워크플로 템플릿과 노드 연결 방법을 다룹니다. 인라인 태그(감정, 톤, 멈춤, 음소) 전체 레퍼런스는 [Fish Audio 프롬프트 가이드](/ko/tutorials/partner-nodes/fishaudio/prompt-guide)를 참고하세요. 최신 텍스트 기반 음성 생성 모델인 Drama 3에는 별도 페이지가 있습니다: [Fish Audio Drama 3](/ko/tutorials/partner-nodes/fishaudio/drama-3).

<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에서 Fish Audio 사용하기

Fish Audio 파트너 노드는 노드 메뉴의 `partner/audio/Fish Audio` 카테고리에서 사용할 수 있습니다. 4개의 노드가 워크플로를 구성합니다:

* **Fish Audio Text to Speech**: 텍스트를 음성으로 변환하며 `AUDIO`를 출력합니다
* **Fish Audio Speech to Text**: 오디오를 텍스트로 전사하며 `text`, `language_code`, `segments_json`을 출력합니다
* **Fish Audio Voice Selector**: 프리셋 목소리 중 하나를 선택하거나, `custom`(즉 `https://fish.audio/m/<id>/`의 ID)을 통해 임의의 fish.audio 음성 모델을 연결하며 `voice`를 출력합니다
* **Fish Audio Instant Voice Clone**: 녹음으로 비공개 복제 목소리를 만들며 `voice`를 출력합니다

### 모델 선택

Text to Speech 노드의 `model` 파라미터는 두 가지 옵션을 제공합니다:

* `s2.1-pro`(권장): 0\~5개의 음성 입력으로 확장 가능한 목록을 통해 여러 화자를 지원합니다
* `s1`(레거시): 선택 사항인 단일 음성 입력을 받으며, 프롬프트 가이드에서 설명하는 괄호 감정 태그 구문을 사용합니다

최신 모델인 `drama-3`는 별도 페이지에 문서화되어 있습니다: [Fish Audio Drama 3](/ko/tutorials/partner-nodes/fishaudio/drama-3).

### 목소리 연결

Voice Selector 또는 Instant Voice Clone의 `voice` 출력은 Text to Speech 노드에 연결됩니다. 입력 이름은 모델에 따라 다릅니다: `s2.1-pro`(권장)는 확장 가능한 `voices` 입력(최대 5개 음성 슬롯)을 노출하고, `s1`은 선택 사항인 단일 `voice` 입력을 가집니다. 음성이 하나 연결된 경우 노드는 내부적으로 이를 `reference_id`로 전달합니다. 두 개 이상인 경우 텍스트에서 `@Voice1`, `@Voice2` 등으로 화자를 표시해야 하며, 연결된 모든 음성이 텍스트에 최소 한 번은 등장해야 합니다. 그렇지 않으면 노드가 오류를 발생시킵니다. 자세한 내용은 프롬프트 가이드의 [다중 화자 대화](/ko/tutorials/partner-nodes/fishaudio/prompt-guide#다중-화자-대화)를 참고하세요.

### 보이스 클론 제한

Instant Voice Clone 노드는 1~~20개의 녹음을 받고, 클립당 10~~30초를 권장하며, 총 재생 시간이 270초 미만인지 검증합니다. `enhance_audio_quality` 옵션은 기본적으로 활성화되어 있습니다. 녹음 팁은 프롬프트 가이드의 [보이스 클론 품질](/ko/tutorials/partner-nodes/fishaudio/prompt-guide#보이스-클론-품질)을 참고하세요.

### 계정 및 가격

이 노드들은 ComfyUI 계정 로그인이 필요하며 사용량에 따라 과금됩니다. 노드에 표시된 참고 가격: 텍스트→음성은 텍스트 1M 바이트당 약 $21.45, 음성→텍스트는 분당 $0.00858, 보이스 클론은 무료입니다.

## 사용 가능한 워크플로

3개의 바로 사용할 수 있는 템플릿이 Fish Audio의 주요 흐름인 텍스트→음성, 보이스 클론→음성, 음성→텍스트를 다룹니다. ComfyUI의 템플릿 라이브러리에서 열거나 Comfy Cloud에서 바로 실행할 수 있습니다. 보이스 클론과 음성→텍스트 템플릿은 ComfyUI 0.34.0 이상이 필요합니다. Drama 3에는 [Drama 3 페이지](/ko/tutorials/partner-nodes/fishaudio/drama-3)에 설명된 자체 템플릿 2개가 있습니다.

<h3 id="api_fishaudio_text_to_speech">
  Fish Audio: 텍스트-음성
</h3>

프리셋 목소리로 대사를 음성으로 생성합니다. [프롬프트 가이드](/ko/tutorials/partner-nodes/fishaudio/prompt-guide)의 인라인 태그를 텍스트에 작성하고, Voice Selector에서 다른 프리셋을 고르거나 클론 목소리를 연결하세요.

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_fishaudio_text_to_speech-1.webp" alt="Fish Audio: 텍스트-음성 워크플로 미리보기" />

<CardGroup cols={2}>
  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=api_fishaudio_text_to_speech&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_text_to_speech.json">
    JSON 다운로드 또는 템플릿 라이브러리에서 "Fish Audio: Text to Speech" 검색
  </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_voice_clone_tts">
  Fish Audio: 보이스 클론-음성
</h3>

짧은 녹음에서 목소리를 복제하고, 그 목소리로 어떤 대사든 말하게 합니다. 15~~20초 길이의 클립을 2~~3개 녹음해 `LoadAudio` 노드로 업로드하거나(`RecordAudio` 노드에서 직접 녹음도 가능), Instant Voice Clone 출력을 Text to Speech 노드에 연결하세요. 녹음 팁은 프롬프트 가이드의 [보이스 클론 품질](/ko/tutorials/partner-nodes/fishaudio/prompt-guide#보이스-클론-품질)을 참고하세요.

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_fishaudio_voice_clone_tts-1.webp" alt="Fish Audio: 보이스 클론-음성 워크플로 미리보기" />

<CardGroup cols={2}>
  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=api_fishaudio_voice_clone_tts&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_voice_clone_tts.json">
    JSON 다운로드 또는 템플릿 라이브러리에서 "Fish Audio: Voice Clone to Speech" 검색
  </Card>
</CardGroup>

**입력 자료**

이 파일을 해당 `LoadAudio` 노드에 업로드하세요:

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

<h3 id="api_fishaudio_speech_to_text">
  Fish Audio: 음성-텍스트
</h3>

오디오 클립을 텍스트로 전사합니다. 80개 이상의 언어가 자동으로 감지되며, `precise_timestamps`를 활성화하면 세그먼트별 시작·종료 시간이 JSON으로 반환되어 자막 제작에 유용합니다.

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_fishaudio_speech_to_text-1.webp" alt="Fish Audio: 음성-텍스트 워크플로 미리보기" />

<CardGroup cols={2}>
  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=api_fishaudio_speech_to_text&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_speech_to_text.json">
    JSON 다운로드 또는 템플릿 라이브러리에서 "Fish Audio: Speech to Text" 검색
  </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>

## 시작하기

1. ComfyUI를 최신 버전으로 업데이트합니다
2. 위의 워크플로 템플릿을 열거나, 노드 메뉴의 `partner/audio/Fish Audio` 카테고리에서 Fish Audio 노드를 추가합니다
3. 안내가 뜨면 ComfyUI 계정에 로그인합니다
4. [프롬프트 가이드](/ko/tutorials/partner-nodes/fishaudio/prompt-guide)의 인라인 태그로 대사를 작성합니다
5. 워크플로를 실행하고 오디오를 미리 듣거나 저장합니다


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