What problem does it solve?
Producing narration audio for videos and content fragments requires a text-to-speech service with proper credentials, voice selection, and quality verification. This Skill wraps the Volcengine Doubao Speech Synthesis 2.0 (seed-tts-2.0) unidirectional streaming API into a single CLI command, handling authentication, voice routing, output placement, and an automatic ASR-based quality self-check.
Core Features & Use Cases
- Text-to-speech synthesis: Convert inline text, UTF-8 text files, or fragment
tts_requirement.md files into MP3/PCM/WAV/OGG_OPUS audio with configurable voice, sample rate, speech rate, loudness, and emotional context.
- Voice and model routing: Automatically routes official 2.0 voices, cloned voices (S_xxx), and legacy 1.0 voices to the correct Volcengine resource ID, with dual-header or single-key console authentication.
- ASR self-check: After synthesis, transcribes the audio with Volcengine ASR and compares it to the source text using Jaccard similarity (0.5 threshold), printing PASS or WARN.
- Use Case: While producing a short video, point the command at
fragments/01-hook/ to read the voiceover copy and voice settings from tts_requirement.md and write speech.mp3 plus a duration metadata JSON into the fragment's artifacts/ directory.
Quick Start
Ask the agent to synthesize the voiceover text in your fragment directory into an MP3 using the default Chinese voice, for example: run awk-tts on fragments/01-hook/ to generate the narration audio.