Tổng hợp giọng nói StepFun (stepaudio-2.5-tts)
Tạo giọng nói tiếng Trung/Nhật giàu cảm xúc bằng stepaudio-2.5-tts của StepFun thông qua hướng dẫn bằng ngôn ngữ tự nhiên và chỉ dẫn trong ngoặc đơn.
Ảnh · VideoTrung cấp★ 1,323⑂ 212Điểm AI 8/10Cập nhật lần cuối: 8 thg 8, 2026
Làm được gì
Kỹ năng này giúp Claude Code gọi trực tiếp mô hình TTS mới nhất của StepFun là stepaudio-2.5-tts. Thay vì dùng nhãn cảm xúc cố định (voice_label) như step-tts-2, bạn mô tả mong muốn bằng ngôn ngữ tự nhiên trong tham số instruction (tối đa 200 ký tự) và chỉ dẫn nội dòng trong dấu () để điều khiển ngắt nghỉ, hơi thở, nhấn nhá, đổi cảm xúc giữa câu.
- Tổng hợp câu ngắn (1–500 ký tự) và văn bản dài (tối đa 1000 ký tự)
- Tạo hàng loạt lời thoại game/app từ file JSONL
- Script so sánh A/B giữa hai mô hình
- Hướng dẫn migrate đầy đủ từ
step-tts-2 - Xử lý lỗi kiểm duyệt (
censorship_block) và chiến lược dự phòng đa mô hình
Phù hợp với ai
- Lập trình viên game/ứng dụng cần lồng tiếng Trung hoặc Nhật
- Nhóm đang phải nâng cấp dự án
step-tts-2cũ lên mô hình mới - Người làm nội dung audio cần biểu cảm (thì thầm, nghẹn ngào, nũng nịu…)
- Kỹ sư gọi API StepFun trực tiếp và muốn tra lỗi nhanh
Ví dụ sử dụng
- Một câu có cảm xúc:
python3 scripts/tts_generate.py --text "你好" --out /tmp/hello.mp3 --instruction "温暖的希望感"để có lời chào ấm áp. - Đổi cảm xúc giữa câu: viết
"(试探着问)你好吗?(开心地)太好了!"— phần trong ngoặc chỉ là chỉ đạo diễn xuất, không bị đọc lên. - Tạo 29 dòng thoại game một lượt: chạy
--batch lines.jsonl; nếu 2 dòng bị chặn kiểm duyệt thì ghi log ID đó, không dừng batch, rồi dùngstep-tts-2làm phương án dự phòng cho riêng 2 dòng ấy.
· · · Hướng dẫn cài đặt · · ·
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục daymade-audio/stepfun-tts từ repo GitHub daymade/claude-code-skills vào ~/.claude/skills/stepfun-tts/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
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/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal và clone kho mã:
git clone https://github.com/daymade/claude-code-skills.git - Tạo thư mục kỹ năng:
mkdir -p ~/.claude/skills - Sao chép kỹ năng:
cp -r claude-code-skills/daymade-audio/stepfun-tts ~/.claude/skills/ - Đăng ký tại https://platform.stepfun.com/ và lấy khóa ở mục API Keys. Hãy chọn Normal key, không dùng Plan key (Plan key sẽ lỗi âm thầm với endpoint audio).
- Đặt biến môi trường:
export STEPFUN_API_KEY="khóa_của_bạn"(thêm vào~/.zshrchoặc~/.bashrcđể giữ lâu dài). - Khởi động lại Claude Code, rồi yêu cầu ví dụ: "dùng StepFun TTS đọc câu tiếng Trung này giúp tôi".
- Kiểm tra nhanh:
python3 ~/.claude/skills/stepfun-tts/scripts/tts_generate.py --text "你好" --out /tmp/hello.mp3và mở file mp3 vừa tạo.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT