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

StepFun ASR (stepaudio-2.5-asr) 음성 전사

StepFun의 stepaudio-2.5-asr 모델로 최대 30분 길이 오디오를 한 번의 요청으로 텍스트로 변환해 주는 스킬.

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

무엇을 해주나

  • StepFun(阶跃星辰)의 stepaudio-2.5-asr 모델을 이용해 오디오 파일을 텍스트로 전사합니다.
  • 32K 컨텍스트 덕분에 5~30분짜리 긴 녹음도 분할(chunking) 없이 한 번의 호출로 처리합니다. 17.4분 오디오를 약 10초에 처리할 정도로 빠릅니다(RTF 85~101배).
  • 번들된 scripts/asr_transcribe.py가 base64 인코딩, 중첩 JSON 바디, SSE 스트림 파싱까지 알아서 처리하고, --json 옵션으로 토큰 사용량·소요 시간까지 뽑아 줍니다.
  • 초보자가 반드시 걸려 넘어지는 세 가지 함정(잘못된 엔드포인트로 인한 "model not supported" 오류, Plan 키 vs Normal 키, 스트림 중간 error 이벤트)을 표로 정리해 두었습니다.
  • mp3 / wav / ogg / opus / pcm을 지원하며, mp4·m4a 등은 ffmpeg로 변환 후 사용합니다.

이런 분께 추천

  • 중국어 또는 영어 회의·인터뷰·팟캐스트 녹음을 자주 전사해야 하는 분
  • 기존 step-asr / step-asr-1.1에서 마이그레이션을 검토 중인 개발자
  • model stepaudio-2.5-asr not supported 오류로 시간을 낭비하고 있는 분
  • 긴 오디오를 잘라 붙이는 파이프라인을 없애고 싶은 분

활용 예시

  1. 20분 회의 녹음 전사: python3 scripts/asr_transcribe.py meeting.mp3 한 줄로 전문 텍스트를 얻고, 이어서 회의록 작성 스킬로 넘깁니다.
  2. 영어 인터뷰 처리: --language en 옵션으로 영어 오디오를 전사한 뒤 --json으로 토큰 사용량을 기록해 비용을 추적합니다.
  3. 1시간짜리 강의: 30분 상한에 걸리므로 ffmpeg로 두 조각으로 나눈 뒤 각각 전사하고, 결과를 이어 붙여 자막 초안으로 활용합니다.

· · · 설치 가이드 · · ·

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-asr 폴더를 내 ~/.claude/skills/stepfun-asr/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

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

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

  1. 터미널을 열고 저장소를 내려받습니다. 
    git clone https://github.com/daymade/claude-code-skills.git /tmp/ccs
  2. 스킬 폴더를 Claude Code 스킬 디렉터리로 복사합니다. 
    mkdir -p ~/.claude/skills && cp -r /tmp/ccs/daymade-audio/stepfun-asr ~/.claude/skills/
  3. https://platform.stepfun.com/ 에 가입하고 API Keys 메뉴에서 키를 발급받습니다. 이때 반드시 Normal 키를 만드세요(Plan 구독 키는 오디오 API를 호출할 수 없고, 오류 메시지도 불친절합니다).
  4. 키를 환경 변수로 등록합니다. 
    export STEPFUN_API_KEY="발급받은_키"
    (매번 입력하기 싫다면 ~/.zshrc 또는 ~/.bashrc에 추가하세요.)
  5. Python 3와 ffmpeg가 설치되어 있는지 확인합니다. mp4·m4a 파일은 ffmpeg로 mp3/ogg로 변환해야 합니다.
  6. Claude Code를 다시 실행한 뒤 "이 녹음 파일 StepFun ASR로 전사해줘"처럼 요청하면 스킬이 자동으로 호출됩니다.
GitHub에서 원본 보기 ↗라이선스: MIT