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

# Skills

> Claude Code의 AI 어시스턴트로 Typecast TTS API를 쉽게 사용하세요.

<Info>
  [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview)는 Anthropic의 AI 코딩 어시스턴트입니다. **Typecast Skills**를 사용하면 Claude가 자연어로 요청하기만 해도 TTS를 프로젝트에 통합하도록 도와줄 수 있습니다!
</Info>

## 할 수 있는 것

Typecast Skills for Claude를 사용하면 다음을 할 수 있습니다:

* **단계별 가이드 받기** — Python, JavaScript 또는 cURL로 API 통합하기
* **작동하는 코드 생성** — 사용 사례에 맞게 조정됨
* **오류 문제 해결** — 자세한 설명 및 솔루션 제공
* **요금제 비교** — 비용 계산
* **음성 찾기** — 프로젝트 요구에 맞는 음성 발견

***

## 사전 요구 사항

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

1. **Claude Code** — [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview)에서 공식 설치 가이드를 확인하세요
2. **타입캐스트 API 키** — [여기서 받기](https://typecast.ai/developers/api/)

***

## 설치

Claude Code를 열고 다음 명령을 실행하세요:

```bash theme={null}
npx skills add neosapience/typecast-skills
```

이게 끝입니다! Typecast Skills를 사용할 준비가 되었습니다.

### 설치 확인

Claude에게 물어보세요: **"타입캐스트 API에 대해 무엇을 도와줄 수 있어?"**

올바르게 설치되었다면 Claude가 자신을 Typecast TTS API 전문 에이전트로 소개할 것입니다.

<Tip>
  **수동 설치**: 스킬 폴더를 다음 위치에 직접 복사할 수도 있습니다:

  * 개인 범위: `~/.claude/skills/`
  * 프로젝트 범위: `.cursor/skills/`
</Tip>

***

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

자연어로 Claude에게 물어보세요! 다음은 몇 가지 예시 프롬프트입니다:

### 기본 설정

<CodeGroup>
  ```text 시작하기 theme={null}
  Typecast TTS API를 어떻게 시작하나요?
  ```

  ```text API 키 theme={null}
  타입캐스트 API 키를 어떻게 받나요?
  ```

  ```text 음성 목록 theme={null}
  Python에서 사용 가능한 음성 목록을 보여줘.
  ```
</CodeGroup>

### 코드 생성

<CodeGroup>
  ```text Python theme={null}
  타입캐스트 API를 사용해서 "안녕하세요"를 음성으로 변환하는 Python 코드를 작성해줘.
  ```

  ```text JavaScript theme={null}
  행복한 감정으로 텍스트 음성 변환하는 JavaScript 함수를 만들어줘.
  ```

  ```text cURL theme={null}
  ssfm-v30 모델로 음성을 생성하는 cURL 명령어를 줘.
  ```
</CodeGroup>

### 오류 문제 해결

<CodeGroup>
  ```text 403 오류 theme={null}
  타입캐스트 API에서 403 오류가 발생해요. 무엇을 확인해야 하나요?
  ```

  ```text 요청 한도 theme={null}
  오류 429 - 요청이 너무 많다고 나와요. 요청 한도가 어떻게 되나요?
  ```

  ```text 음성을 찾을 수 없음 theme={null}
  voice_id가 404를 반환해요. 유효한 음성 ID를 어떻게 찾나요?
  ```
</CodeGroup>

***

## 예시 대화

### 시작하기 (코딩 경험 없음)

<AccordionGroup>
  <Accordion title="사용자: API를 한 번도 사용해본 적 없는데 앱에 음성을 추가하고 싶어요.">
    **Claude가 할 것:**

    1. API가 무엇인지 간단하게 설명
    2. API 키 받는 방법 안내
    3. 가장 간단한 코드 예제 제공
    4. 각 코드 라인 설명
  </Accordion>

  <Accordion title="사용자: ssfm-v21과 ssfm-v30의 차이가 뭐예요?">
    **Claude가 할 것:**

    * v30이 더 나은 품질의 최신 모델임을 설명
    * 각 모델에서 사용 가능한 감정 나열
    * 새 프로젝트에는 v30 권장
    * 스마트 모드(문맥 인식 감정) 설명
  </Accordion>
</AccordionGroup>

### 프로젝트에 통합하기

<AccordionGroup>
  <Accordion title="사용자: React 앱을 만들고 있는데 TTS가 필요해요. Typecast 통합을 도와줘.">
    **Claude가 할 것:**

    1. API 호출은 백엔드를 통해야 한다고 설명 (보안)
    2. Node.js/Express 백엔드 예제 제공
    3. React에서 호출하는 방법 제공
    4. 오류 처리 포함
  </Accordion>

  <Accordion title="사용자: FastAPI 서버에 Typecast TTS를 추가해줘.">
    **Claude가 할 것:**

    1. 완전한 FastAPI 엔드포인트 생성
    2. API 키에 환경 변수 사용
    3. 적절한 오류 처리 포함
    4. 예시 요청/응답 제공
  </Accordion>
</AccordionGroup>

***

## Claude가 Typecast에 대해 아는 것

| 주제         | Claude가 도와줄 수 있는 것                           |
| ---------- | -------------------------------------------- |
| **API 기본** | 인증, 엔드포인트, 요청/응답 형식                          |
| **코드 샘플**  | Python SDK, JavaScript SDK, Direct API, cURL |
| **음성 선택**  | 500개 이상의 음성, 성별/나이/사용 사례별 필터링                |
| **감정 제어**  | 이모션 프리셋, 스마트 모드, 강도 조절                       |
| **오디오 설정** | 형식(WAV/MP3), 볼륨, 피치, 템포                      |
| **오류 처리**  | 모든 오류 코드(400-500) 및 해결책                      |
| **요금제**    | 플랜 비교, 크레딧 계산                                |
| **모범 사례**  | 보안, 환경 변수, 요청 한도                             |

***

## 최상의 결과를 위한 팁

<CardGroup cols={2}>
  <Card title="구체적으로" icon="crosshairs">
    "TTS 도와줘" 대신 "ssfm-v30으로 슬픈 감정의 Python 코드를 생성해줘"라고 요청하세요
  </Card>

  <Card title="스택 언급하기" icon="layer-group">
    기술 스택을 알려주세요: "Next.js와 TypeScript를 사용하고 있어요"
  </Card>

  <Card title="오류 공유하기" icon="bug">
    전체 오류 메시지를 붙여넣으세요 — Claude가 진단하고 수정합니다
  </Card>

  <Card title="후속 질문하기" icon="comments">
    Claude는 문맥을 기억하므로 "이제 오류 처리를 추가해줘" 또는 "TypeScript로 변환해줘"라고 요청하세요
  </Card>
</CardGroup>

***

## 최신 상태 유지

최신 기능 및 수정 사항을 받으려면 Typecast Skills를 업데이트하세요:

```bash theme={null}
npx skills update
```

***

## 문제 해결

<AccordionGroup>
  <Accordion title="Claude가 Typecast 명령을 인식하지 못함">
    * 설정에서 스킬이 제대로 설치되었는지 확인
    * Claude Code를 다시 시작해보기
    * 스킬 저장소에 접근할 수 있는지 확인
  </Accordion>

  <Accordion title="Claude가 오래된 정보를 제공함">
    * Claude에게 최신 문서를 확인하라고 요청
    * 최신 기능을 위해 "ssfm-v30"을 구체적으로 언급
    * 로컬에 클론한 경우 스킬 저장소 업데이트
  </Accordion>

  <Accordion title="코드 예제가 작동하지 않음">
    * `YOUR_API_KEY`를 실제 키로 교체했는지 확인
    * 유효한 `voice_id`를 사용하고 있는지 확인
    * 사용 중인 모델을 API 플랜이 지원하는지 확인
  </Accordion>
</AccordionGroup>

***

## 리소스

<CardGroup cols={2}>
  <Card title="API 키 받기" icon="key" href="https://typecast.ai/developers/api/">
    타입캐스트 API 키 받기
  </Card>

  <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="Skills 저장소" icon="github" href="https://github.com/neosapience/typecast-skills">
    GitHub에서 소스 보기
  </Card>
</CardGroup>