클로드스킬마트스킬 둘러보기스킬이 뭐예요?
 
← 목록으로

StepFun 음성 합성 (stepaudio-2.5-tts)

StepFun의 stepaudio-2.5-tts로 자연어 지시문과 문장 내 괄호 지시를 활용해 감정이 살아있는 중국어·일본어 음성을 만들어 주는 스킬.

이미지·영상중급★ 1,323⑂ 212AI 점수 8/10마지막 업데이트: 2026. 8. 8.

무엇을 해주나

StepFun의 최신 음성 합성 모델 stepaudio-2.5-tts를 Claude Code에서 바로 호출할 수 있게 해줍니다. 기존 step-tts-2처럼 고정된 감정 태그(voice_label)를 쓰는 대신, 자연어 지시문(instruction, 200자 이내) 과 문장 안에 넣는 괄호 지시(()) 로 톤·호흡·강세·중간 감정 전환까지 세밀하게 조절합니다.

  • 단문(1~500자) 및 장문(최대 1000자) 합성
  • JSONL 기반 대량 배치 생성 (게임/앱 대사 등)
  • 두 모델 A/B 비교 스크립트 제공
  • step-tts-2 → stepaudio-2.5-tts 마이그레이션 플레이북
  • 검열 차단(censorship_block) 대응 및 혼합 모델 폴백 전략

이런 분께 추천

  • 중국어·일본어 더빙이나 나레이션이 필요한 게임/앱 개발자
  • 기존 step-tts-2 프로젝트를 최신 모델로 옮겨야 하는 팀
  • 감정 표현(속삭임, 울먹임, 장난기 등)이 중요한 음성 콘텐츠 제작자
  • StepFun API를 코드로 직접 다루며 오류 원인을 빨리 찾고 싶은 엔지니어

활용 예시

  1. 감정 있는 한 줄 대사: python3 scripts/tts_generate.py --text "你好" --out /tmp/hello.mp3 --instruction "温暖的希望感" 로 따뜻한 톤의 인사 음성 생성.
  2. 문장 중간 감정 전환: "(试探着问)你好吗？(开心地)太好了！" 처럼 괄호 지시를 넣으면 괄호 내용은 읽히지 않고 연기 지시로만 반영됩니다.
  3. 게임 대사 29줄 일괄 생성: --batch lines.jsonl 로 돌리다가 2줄이 검열 차단되면 배치를 중단하지 않고 해당 ID만 기록한 뒤 그 줄만 step-tts-2로 폴백 처리.

· · · 설치 가이드 · · ·

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 daymade/claude-code-skills 의 daymade-audio/stepfun-tts 폴더를 내 ~/.claude/skills/stepfun-tts/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/daymade/claude-code-skills.git && mkdir -p ~/.claude/skills && cp -r claude-code-skills/daymade-audio/stepfun-tts ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 열고 저장소를 내려받습니다: git clone https://github.com/daymade/claude-code-skills.git
  2. 스킬 폴더를 만듭니다: mkdir -p ~/.claude/skills
  3. 이 스킬만 복사합니다: cp -r claude-code-skills/daymade-audio/stepfun-tts ~/.claude/skills/
  4. https://platform.stepfun.com/ 에 가입 후 API Keys 메뉴에서 키를 발급받습니다. 반드시 Normal 키를 발급하세요(Plan 키는 오디오 엔드포인트에서 조용히 실패합니다).
  5. 발급받은 키를 환경변수로 등록합니다: export STEPFUN_API_KEY="발급받은키" (셸 설정 파일 ~/.zshrc 또는 ~/.bashrc에 추가하면 계속 유지됩니다)
  6. Claude Code를 재시작하고 "중국어 음성 합성해줘" 또는 "stepfun TTS로 대사 만들어줘" 라고 요청하면 스킬이 활성화됩니다.
  7. 첫 테스트: python3 ~/.claude/skills/stepfun-tts/scripts/tts_generate.py --text "你好" --out /tmp/hello.mp3 를 실행해 mp3가 생기는지 확인합니다.
GitHub에서 원본 보기 ↗라이선스: MIT