StepFun TTS (stepaudio-2.5-tts)
Generate emotionally expressive Chinese and Japanese speech with StepFun's stepaudio-2.5-tts using natural-language instructions and inline prosody directives.
Image & VideoIntermediate★ 1,323⑂ 212AI score 8/10Last updated: Aug 8, 2026
What it does
This skill wires Claude Code into StepFun's stepaudio-2.5-tts contextual TTS model. Instead of fixed emotion tags (voice_label, as in step-tts-2), you describe the delivery in natural language via the instruction field (≤200 chars) and drop inline () directives into the text for pauses, breath, emphasis, and mid-sentence mood pivots.
- Single-line (1–500 chars) and long-form (up to a 1000-char hard cap) synthesis
- JSONL batch generation for game/app voice lines
- A/B comparison script across two model outputs
- A full
step-tts-2→stepaudio-2.5-ttsmigration playbook - Documented handling for
censorship_blockerrors plus mixed-model fallback
Who it's for
- Game and app developers needing Chinese/Japanese voice lines
- Teams migrating legacy
step-tts-2pipelines to the 2.5 model - Audio content creators who need whispers, sobs, playfulness, and other nuance
- Engineers calling the StepFun API directly who want fast error diagnosis
Examples
- One emotive line:
python3 scripts/tts_generate.py --text "你好" --out /tmp/hello.mp3 --instruction "温暖的希望感"for a warm, hopeful greeting. - Mid-sentence emotion shift: write
"(试探着问)你好吗?(开心地)太好了!"— the parenthesised text acts as stage direction and is never spoken aloud. - Batch of 29 game lines: run
--batch lines.jsonl; if 2 lines returncensorship_block, log the IDs, keep the batch running, and regenerate just those two throughstep-tts-2.
· · · Install guide · · ·
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the daymade-audio/stepfun-tts folder from the GitHub repo daymade/claude-code-skills into my ~/.claude/skills/stepfun-tts/. When it's done, tell me in one line what this skill can do.
Install with a command instead
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/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and clone the repo:
git clone https://github.com/daymade/claude-code-skills.git - Create the skills directory:
mkdir -p ~/.claude/skills - Copy this skill in:
cp -r claude-code-skills/daymade-audio/stepfun-tts ~/.claude/skills/ - Sign up at https://platform.stepfun.com/ and create a key under API Keys. Choose a Normal key — Plan keys are text-only and fail silently on audio endpoints.
- Export the key:
export STEPFUN_API_KEY="your-key-here"(add it to~/.zshrcor~/.bashrcto persist). - Restart Claude Code and ask something like "synthesize this Chinese line with StepFun TTS, whispered".
- Smoke test: run
python3 ~/.claude/skills/stepfun-tts/scripts/tts_generate.py --text "你好" --out /tmp/hello.mp3and play the resulting mp3.
View source on GitHub ↗License: MIT