> ## Documentation Index
> Fetch the complete documentation index at: https://typecast.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Zapier

> 코딩 없이 타입캐스트 TTS를 Zapier 워크플로우에 통합하세요.

<Info>
  [Zapier](https://zapier.com/)는 가장 인기 있는 워크플로우 자동화 플랫폼입니다. 타입캐스트 통합을 사용하면 코딩 없이도 텍스트를 음성으로 자동 변환할 수 있습니다!
</Info>

## 할 수 있는 것

타입캐스트 Zapier 통합을 사용하면 다음을 할 수 있습니다:

* 모든 텍스트에서 **내레이션 자동 생성**
* 다양한 성별, 나이, 스타일의 **500개 이상의 음성 중 선택**
* **감정 적용** (happy, sad, angry, whisper 등)
* 문맥 인식 음성 합성을 위한 **스마트 이모션 사용** (ssfm-v30)
* 텍스트 설명으로 **음성 추천**을 받고, 필요하면 합성 전에 음성 상세 정보를 조회
* **다른 앱과 연결** — 이메일로 오디오 전송, 클라우드 스토리지에 저장, Slack에 게시 등

***

## 사전 요구 사항

시작하기 전에 다음을 준비하세요:

1. **Zapier 계정** — 없다면 [여기서 가입](https://zapier.com/sign-up)하세요
2. **타입캐스트 API 키** — [여기서 받기](https://typecast.ai/developers/api/)

***

## 설치

### 단계 1: 타입캐스트 계정 연결

Zap에서 타입캐스트를 처음 사용할 때:

1. 타입캐스트 계정 연결 메시지가 표시됩니다
2. **타입캐스트 API 키**를 입력하세요
3. **Yes, Continue**를 클릭하세요

<Tip>
  [타입캐스트 API 콘솔](https://typecast.ai/developers/api)에서 API 키를 받을 수 있습니다.
</Tip>

***

## 빠른 시작: 첫 번째 음성 생성

매시간 음성을 생성하는 간단한 Zap을 만들어 봅시다!

### 단계 1: 새 Zap 만들기

1. [Zapier 대시보드](https://zapier.com/app/assets/zaps)로 이동하세요
2. **+ Create** → **New Zap**을 클릭하세요

<Frame caption="Zapier Zaps 대시보드">
  <img src="https://mintcdn.com/neosapienceinc/Z2SKC4k1AnG1xbkd/images/zapier-zaps-dashboard.png?fit=max&auto=format&n=Z2SKC4k1AnG1xbkd&q=85&s=16761af31df4b2bf00ba1e014aa67869" alt="Create 버튼이 있는 Zapier Zaps 대시보드" width="1280" height="800" data-path="images/zapier-zaps-dashboard.png" />
</Frame>

### 단계 2: 트리거 설정

이 예제에서는 Schedule 트리거를 사용합니다:

1. **Trigger** 단계를 클릭하세요
2. **Schedule**을 검색하고 선택하세요
3. 이벤트로 **Every Hour**를 선택하세요
4. **Continue**를 클릭하고 **Test trigger**를 클릭하세요

<Frame>
  <img src="https://mintcdn.com/neosapienceinc/hrSZOoWI1sT1VQOl/images/image-5.png?fit=max&auto=format&n=hrSZOoWI1sT1VQOl&q=85&s=2cb74c2a4c6b0c399282b8426268e37d" alt="Image" width="2874" height="1454" data-path="images/image-5.png" />
</Frame>

### 단계 3: **타입캐스트** 액션 추가

1. **Action** 단계를 클릭하세요
2. **Typecast**를 검색하세요
3. \*\*Typecast (2.0.0)\*\*을 선택하세요

<Frame>
  <img src="https://mintcdn.com/neosapienceinc/hrSZOoWI1sT1VQOl/images/image-2.png?fit=max&auto=format&n=hrSZOoWI1sT1VQOl&q=85&s=1e0c299f1700bdf1daad8ee13c4b2d8e" alt="Image" width="2875" height="1456" data-path="images/image-2.png" />
</Frame>

4. 이벤트로 **Create Speech From Text**를 선택하세요

<Frame>
  <img src="https://mintcdn.com/neosapienceinc/hrSZOoWI1sT1VQOl/images/image-3.png?fit=max&auto=format&n=hrSZOoWI1sT1VQOl&q=85&s=a6e2ab94e7c24ae7277c3193340b4b35" alt="Image" width="2878" height="1458" data-path="images/image-3.png" />
</Frame>

### 단계 4: 텍스트 음성 변환 구성

<Frame>
  <img src="https://mintcdn.com/neosapienceinc/hrSZOoWI1sT1VQOl/images/image-6.png?fit=max&auto=format&n=hrSZOoWI1sT1VQOl&q=85&s=b04c0d887731198ebe9a3fc2c9291e93" alt="Image" width="2876" height="1456" data-path="images/image-6.png" />
</Frame>

| 설정                 | 입력할 내용                               |
| ------------------ | ------------------------------------ |
| **Text**           | 변환할 텍스트 (필수)                         |
| **Model**          | `ssfm-v30 (권장)` — 최고 품질의 최신 모델       |
| **Voice**          | 드롭다운에서 선택 (필수)                       |
| **Language**       | 자동 감지 또는 수동 선택                       |
| **Emotion Type**   | `Preset` 또는 `Smart` (v30만 해당)        |
| **Emotion Preset** | Normal, Happy, Sad, Angry, Whisper 등 |

### 단계 5: 테스트 및 게시

1. **Continue**를 클릭하여 Test 단계로 이동하세요
2. **Test step**을 클릭하여 샘플 오디오를 생성하세요
3. 성공하면 **Publish**를 클릭하여 Zap을 활성화하세요

<Note>
  생성된 오디오 URL은 출력 데이터로 사용 가능합니다. 이메일로 전송, 클라우드 스토리지에 업로드, Slack에 게시하는 등 후속 단계에서 사용할 수 있습니다.
</Note>

***

## 사용 가능한 액션

### Create Speech From Text

타입캐스트 AI 음성 모델을 사용하여 텍스트를 음성으로 변환합니다.

**입력:**

| 필드                | 필수  | 설명                                                     |
| ----------------- | --- | ------------------------------------------------------ |
| Text              | 예   | 변환할 텍스트 (최대 2000자)                                     |
| Model             | 예   | `ssfm-v30` (권장) 또는 `ssfm-v21`                          |
| Voice             | 예   | 500개 이상의 음성 중 선택                                       |
| Language          | 아니오 | ISO 639-3 코드 (미설정 시 자동 감지)                             |
| Emotion Type      | 아니오 | `Preset` 또는 `Smart` (문맥 인식, v30만 해당)                   |
| Emotion Preset    | 아니오 | Normal, Happy, Sad, Angry, Whisper, Tone Up, Tone Down |
| Emotion Intensity | 아니오 | 0.0 \~ 2.0 (기본값: 1.0)                                  |
| Volume            | 아니오 | 0 \~ 200 (기본값: 100)                                    |
| Audio Pitch       | 아니오 | -12 \~ +12 반음 (기본값: 0)                                 |
| Audio Tempo       | 아니오 | 0.5x \~ 2.0x 속도 (기본값: 1.0)                             |
| Audio Format      | 아니오 | WAV 또는 MP3                                             |
| Seed              | 아니오 | 재현 가능한 결과를 위해                                          |

**출력:**

* 오디오 파일 URL
* Speech ID
* 길이 (초)
* Content Type

### List Voices (검색)

향상된 메타데이터와 함께 사용 가능한 모든 음성 모델을 나열합니다.

**필터:**

* Model (ssfm-v30, ssfm-v21)
* Gender (Male, Female)
* Age (Child, Teenager, Young Adult, Middle Age, Elder)
* Use Cases (Audiobook, Podcast, E-learning 등)

### Get Voice by ID (검색)

모델별 지원 감정을 포함한 특정 음성에 대한 자세한 정보를 가져옵니다.

### Recommend Voices (검색)

텍스트 설명으로 후보 음성을 찾습니다.

**입력:**

| 필드    | 필수  | 설명                                        |
| ----- | --- | ----------------------------------------- |
| Query | 예   | 원하는 스타일, 분위기, 언어, 사용 사례, 콘텐츠 맥락을 설명하는 텍스트 |
| Count | 아니오 | 반환할 추천 개수 (1\~10, 기본값: 5)                 |

**출력:**

* Voice ID
* Voice Name
* Score

추천 응답에는 `voice_id`, `voice_name`, `score`만 포함되므로, Zap에서 합성 전에 상세 메타데이터가 필요하면 List Voices 또는 Get Voice by ID를 사용하세요.

***

## 감정 설정

감정 제어로 음성을 표현력 있게 만드세요!

### SSFM-V30(최신 모델)용

감정을 추가하는 두 가지 방법:

<CardGroup cols={2}>
  <Card title="스마트 이모션" icon="wand-magic-sparkles">
    AI가 텍스트 맥락에서 최적의 감정을 자동으로 감지합니다. 자연스러운 대화와 스토리텔링에 적합합니다.

    더 나은 문맥 이해를 위해 "Previous Text"와 "Next Text"를 추가하세요.
  </Card>

  <Card title="이모션 프리셋" icon="sliders">
    7가지 감정 중에서 수동으로 선택합니다: Normal, Happy, Sad, Angry, Whisper, Tone Up, Tone Down.
  </Card>
</CardGroup>

### SSFM-V21용

4가지 감정 중에서 선택: `Normal`, `Happy`, `Sad`, `Angry`

**Emotion Intensity** (0.0 - 2.0) 조절:

* `0.0` — 완전히 중립
* `1.0` — 표준 (기본값)
* `2.0` — 최대 강도

***

## 활용 사례 예시

<AccordionGroup>
  <Accordion title="일일 뉴스 팟캐스트">
    1. **트리거**: 새 기사가 있는 RSS 피드
    2. **액션**: 타입캐스트가 기사 요약으로 오디오 생성
    3. **액션**: 팟캐스트 호스팅 플랫폼에 업로드
  </Accordion>

  <Accordion title="고객 지원 자동 응답">
    1. **트리거**: 새 지원 티켓
    2. **액션**: AI가 응답 텍스트 생성
    3. **액션**: 타입캐스트가 음성 메시지로 변환
    4. **액션**: 이메일 또는 SMS로 전송
  </Accordion>

  <Accordion title="이러닝 콘텐츠">
    1. **트리거**: Google Sheets의 새 레슨 콘텐츠
    2. **액션**: 타입캐스트가 내레이션 생성
    3. **액션**: Google Drive에 업로드
    4. **액션**: Slack으로 팀에 알림
  </Accordion>
</AccordionGroup>

***

## 문제 해결

<AccordionGroup>
  <Accordion title="Zapier에서 타입캐스트를 찾을 수 없음">
    Zapier 앱 디렉토리에서 "Typecast"를 검색하세요. 최신 버전(2.0.0)을 사용하고 있는지 확인하세요.
  </Accordion>

  <Accordion title="인증 실패">
    * API 키가 올바른지 확인하세요
    * [타입캐스트 API 콘솔](https://typecast.ai/developers/api/)에서 키를 확인하세요
    * 키에 여분의 공백이 없는지 확인하세요
  </Accordion>

  <Accordion title="음성 드롭다운이 비어 있음">
    * API 키에 적절한 권한이 있는지 확인하세요
    * 새로고침 아이콘을 클릭하여 필드를 새로고침해 보세요
  </Accordion>

  <Accordion title="오디오가 생성되지 않음">
    * 텍스트가 비어 있지 않은지 확인하세요
    * API 크레딧이 충분한지 확인하세요
    * 테스트 출력에서 오류 메시지를 확인하세요
  </Accordion>
</AccordionGroup>

***

## 리소스

<CardGroup cols={2}>
  <Card title="음성 라이브러리" icon="microphone" href="https://typecast.ai/developers/api/voices">
    사용 가능한 모든 음성 둘러보기
  </Card>

  <Card title="API 레퍼런스" icon="code" href="/ko/api-reference/text-to-speech/text-to-speech">
    타입캐스트 API 탐색하기
  </Card>

  <Card title="Zapier 도움말" icon="circle-question" href="https://help.zapier.com/">
    Zapier 문서 및 지원
  </Card>
</CardGroup>