Claude Code는 Anthropic의 AI 코딩 어시스턴트입니다. Typecast Skills를 사용하면 Claude가 자연어로 요청하기만 해도 TTS를 프로젝트에 통합하도록 도와줄 수 있습니다!
할 수 있는 것
Typecast Skills for Claude를 사용하면 다음을 할 수 있습니다:- 단계별 가이드 받기 — Python, JavaScript 또는 cURL로 API 통합하기
- 작동하는 코드 생성 — 사용 사례에 맞게 조정됨
- 오류 문제 해결 — 자세한 설명 및 솔루션 제공
- 요금제 비교 — 비용 계산
- 음성 찾기 — 프로젝트 요구에 맞는 음성 발견
사전 요구 사항
시작하기 전에 다음을 준비하세요:- Claude Code — Claude Code에서 공식 설치 가이드를 확인하세요
- Typecast API 키 — 여기서 받기
설치
단계 1: Typecast Marketplace 추가
Claude Code를 열고 다음 명령을 실행하세요:단계 2: 플러그인 설치
설치 확인
Claude에게 물어보세요: “Typecast API에 대해 무엇을 도와줄 수 있어?” 올바르게 설치되었다면 Claude가 자신을 Typecast TTS API 전문 에이전트로 소개할 것입니다.빠른 시작: 첫 번째 음성 생성
자연어로 Claude에게 물어보세요! 다음은 몇 가지 예시 프롬프트입니다:기본 설정
코드 생성
오류 문제 해결
예시 대화
시작하기 (코딩 경험 없음)
사용자: API를 한 번도 사용해본 적 없는데 앱에 음성을 추가하고 싶어요.
사용자: API를 한 번도 사용해본 적 없는데 앱에 음성을 추가하고 싶어요.
Claude가 할 것:
- API가 무엇인지 간단하게 설명
- API 키 받는 방법 안내
- 가장 간단한 코드 예제 제공
- 각 코드 라인 설명
사용자: ssfm-v21과 ssfm-v30의 차이가 뭐예요?
사용자: ssfm-v21과 ssfm-v30의 차이가 뭐예요?
Claude가 할 것:
- v30이 더 나은 품질의 최신 모델임을 설명
- 각 모델에서 사용 가능한 감정 나열
- 새 프로젝트에는 v30 권장
- 스마트 모드(문맥 인식 감정) 설명
프로젝트에 통합하기
사용자: React 앱을 만들고 있는데 TTS가 필요해요. Typecast 통합을 도와줘.
사용자: React 앱을 만들고 있는데 TTS가 필요해요. Typecast 통합을 도와줘.
Claude가 할 것:
- API 호출은 백엔드를 통해야 한다고 설명 (보안)
- Node.js/Express 백엔드 예제 제공
- React에서 호출하는 방법 제공
- 오류 처리 포함
사용자: FastAPI 서버에 Typecast TTS를 추가해줘.
사용자: FastAPI 서버에 Typecast TTS를 추가해줘.
Claude가 할 것:
- 완전한 FastAPI 엔드포인트 생성
- API 키에 환경 변수 사용
- 적절한 오류 처리 포함
- 예시 요청/응답 제공
Claude가 Typecast에 대해 아는 것
| 주제 | Claude가 도와줄 수 있는 것 |
|---|---|
| API 기본 | 인증, 엔드포인트, 요청/응답 형식 |
| 코드 샘플 | Python SDK, JavaScript SDK, Direct API, cURL |
| 음성 선택 | 500개 이상의 음성, 성별/나이/사용 사례별 필터링 |
| 감정 제어 | 프리셋 감정, 스마트 모드, 강도 조절 |
| 오디오 설정 | 형식(WAV/MP3), 볼륨, 피치, 템포 |
| 오류 처리 | 모든 오류 코드(400-500) 및 해결책 |
| 요금제 | 플랜 비교, 크레딧 계산 |
| 모범 사례 | 보안, 환경 변수, 요청 한도 |
최상의 결과를 위한 팁
구체적으로
“TTS 도와줘” 대신 “ssfm-v30으로 슬픈 감정의 Python 코드를 생성해줘”라고 요청하세요
스택 언급하기
기술 스택을 알려주세요: “Next.js와 TypeScript를 사용하고 있어요”
오류 공유하기
전체 오류 메시지를 붙여넣으세요 — Claude가 진단하고 수정합니다
후속 질문하기
Claude는 문맥을 기억하므로 “이제 오류 처리를 추가해줘” 또는 “TypeScript로 변환해줘”라고 요청하세요
최신 상태 유지
최신 기능 및 수정 사항을 받으려면 플러그인을 업데이트하세요:문제 해결
Claude가 Typecast 명령을 인식하지 못함
Claude가 Typecast 명령을 인식하지 못함
- 설정에서 스킬이 제대로 설치되었는지 확인
- Claude Code를 다시 시작해보기
- 스킬 저장소에 접근할 수 있는지 확인
Claude가 오래된 정보를 제공함
Claude가 오래된 정보를 제공함
- Claude에게 최신 문서를 확인하라고 요청
- 최신 기능을 위해 “ssfm-v30”을 구체적으로 언급
- 로컬에 클론한 경우 스킬 저장소 업데이트
코드 예제가 작동하지 않음
코드 예제가 작동하지 않음
YOUR_API_KEY를 실제 키로 교체했는지 확인- 유효한
voice_id를 사용하고 있는지 확인 - 사용 중인 모델을 API 플랜이 지원하는지 확인
리소스
API 키 받기
Typecast API 키 받기
음성 라이브러리
사용 가능한 모든 음성 둘러보기
API 레퍼런스
Typecast API 탐색하기
Skills 저장소
GitHub에서 소스 보기