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

<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://studio.typecast.ai/developers/api/)

---

## 설치

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

```bash
npx skills add neosapience/typecast-skills
```

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

### 설치 확인

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

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

<Tip>
  **수동 설치**: 스킬 폴더를 다음 위치에 직접 복사할 수도 있습니다:
  - 개인 범위: `~/.claude/skills/`
  - 프로젝트 범위: `.cursor/skills/`
</Tip>

---

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

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

### 기본 설정

<CodeGroup>
```text 시작하기
Typecast TTS API를 어떻게 시작하나요?
```

```text API 키
타입캐스트 API 키를 어떻게 받나요?
```

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

### 코드 생성

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

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

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

### 오류 문제 해결

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

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

```text 음성을 찾을 수 없음
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 |
| **음성 선택** | 600+개 음성, 성별/나이/사용 사례별 필터링 |
| **감정 제어** | 이모션 프리셋, 스마트 모드, 강도 조절 |
| **오디오 설정** | 형식(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
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://studio.typecast.ai/developers/api/"
  >
    타입캐스트 API 키 받기
  </Card>
  <Card
    title="음성 라이브러리"
    icon="microphone"
    href="https://studio.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>