클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
 
← 목록으로

StepFun stepaudio-2.5-tts 음성 합성

자연어 지시문과 문장 내 () 표기로 감정·억양까지 조절하는 StepFun 중국어·일본어 TTS 스킬.

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

무엇을 해주나

  • StepFun의 stepaudio-2.5-tts 모델로 중국어·일본어 음성을 생성합니다.
  • 고정 감정 라벨(voice_label) 대신 200자 이내 자연어 instruction으로 전체 톤을 지정하고, 텍스트 안의 () 안내문으로 속삭임·멈춤·강조·중간 감정 전환을 세밀하게 제어합니다.
  • step-tts-2 → stepaudio-2.5-tts 마이그레이션 플레이북(감정→instruction 변환표, 비파괴 A/B 디렉터리 전략)을 제공합니다.
  • 실제로 만난 오류(voice_label is not supported, censorship_block, 1000자 초과 무음 잘림)의 원인과 해결책을 표로 정리해 두었습니다.
  • 단건 합성, JSONL 배치 합성, 두 모델 A/B 비교 스크립트가 동봉되어 있습니다.

이런 분께 추천

  • 게임·앱의 중국어 보이스 라인을 대량으로 만들어야 하는 개발자
  • 기존 step-tts-2 파이프라인을 2.5로 옮겨야 하는 팀
  • 감정 연출이 중요한 내레이션·캐릭터 더빙 작업자

활용 예시

  1. python3 scripts/tts_generate.py --text "你好" --out /tmp/hello.mp3 --instruction "温暖的希望感" 로 따뜻한 톤의 한 줄 음성 만들기
  2. input: "你好(停顿一下)我是蕾格(轻声)今天(加重)的天气真不错。" 처럼 문장 안에서 멈춤·작은 목소리·강조를 지정하기
  3. 대사 29줄 JSONL 배치 실행 중 2줄이 검열 차단되면 해당 ID만 기록하고 나머지는 계속 진행, 차단된 줄만 step-tts-2로 폴백

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/daymade/claude-code-skills/HEAD/daymade-audio/stepfun-tts/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

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 /tmp/ccs && mkdir -p ~/.claude/skills && cp -r /tmp/ccs/daymade-audio/stepfun-tts ~/.claude/skills/

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

  1. 터미널에서 저장소를 내려받습니다: git clone https://github.com/daymade/claude-code-skills.git
  2. 스킬 폴더를 Claude 스킬 디렉터리로 복사합니다: mkdir -p ~/.claude/skills && cp -r claude-code-skills/daymade-audio/stepfun-tts ~/.claude/skills/
  3. https://platform.stepfun.com/ 에서 API 키를 발급합니다. 반드시 Normal 키를 선택하세요(Plan 키는 오디오 엔드포인트에서 조용히 실패합니다).
  4. 키를 환경변수로 등록합니다: export STEPFUN_API_KEY="발급받은키" (셸 설정 파일에 추가하면 계속 유지됩니다).
  5. Claude Code를 재시작한 뒤 "중국어 대사를 감정 담아 TTS로 만들어줘"처럼 요청하면 스킬이 실행됩니다.
  6. Python 3와 인터넷 연결이 필요하며, 요금은 만 자당 약 5.8元 수준이므로 대량 작업 전 비용을 확인하세요.
GitHub에서 원본 보기 ↗라이선스: MIT