ada20204/qwen-voice
Overview
This skill provides ASR and TTS capabilities using Qwen (DashScope) for handling voice in chat flows. It converts user audio into text and can synthesize natural-sounding voice replies as .ogg voice notes suitable for Telegram. The tool supports chunk-based coarse timestamps and optional custom voice cloning for personalized TTS.
How this skill works
For ASR, the skill converts input audio to mono 16 kHz WAV and sends it to the qwen3-asr-flash model; timestamps are produced by fixed-length chunking when enabled. For TTS, text is sent to qwen3-tts-flash and returned as an Opus .ogg file (default voice: Cherry). Voice cloning is supported by creating a reusable voice profile and then synthesizing with that profile.
When to use it
- Automatically transcribing incoming voice messages or uploaded audio files.
- Providing spoken replies when users request a voice response.
- Generating coarse timestamps for long recordings to quickly locate content.
- Creating a branded or personalized voice via the cloning workflow.
- Preparing Telegram-compatible .ogg voice notes for chat bots or services.
Best practices
- Set DASHSCOPE_API_KEY in the environment to avoid interactive prompts and ensure stable access.
- Use the chunk-based timestamps only when coarse timing is acceptable; it is not word-level alignment.
- Send clean, reasonably paced audio (sample rate conversion is handled, but quality affects accuracy).
- Reuse cloned voice profiles for consistent TTS output instead of recloning for every request.
- Keep TTS output as Opus .ogg for seamless Telegram voice note delivery.
Example use cases
- Transcribe a Telegram .ogg voice message to text for moderation, indexing, or reply drafting.
- Reply to a user with a spoken message by synthesizing text to .ogg using the Cherry voice.
- Produce timestamped transcriptions for meeting recordings or lecture segments using chunking.
- Create a custom assistant persona by cloning a brand voice and generating responses in that voice.
- Batch-process uploaded mp3 or wav files to generate searchable transcripts and optional audio responses.
FAQ
Set the DASHSCOPE_API_KEY environment variable. If not set, the scripts attempt to read a shell config file.
Are timestamps word-accurate?
No. Timestamps are produced by fixed-length chunking and provide coarse segment boundaries, not word-level alignment.
What audio format is produced for TTS?
TTS outputs Opus .ogg files suitable for Telegram voice notes. Use the default Cherry voice or supply a cloned voice profile.
