Category: provider Model Studio Qwen TTS Validation mkdir -p output/alicloud-ai-audio-tts python -m py_compile skills/ai/audio/alicloud-ai-audio-tts/scripts/generate_tts.py && echo "py_compile_ok"

output/alicloud-ai-audio-tts/validate.txt Pass criteria: command exits 0 and output/alicloud-ai-audio-tts/validate.txt is generated. Output And Evidence Save generated audio links, sample audio files, and request payloads to output/alicloud-ai-audio-tts/ . Keep one validation log per execution. Critical model names Use one of the recommended models: qwen3-tts-flash qwen3-tts-instruct-flash qwen3-tts-instruct-flash-2026-01-26 Prerequisites Install SDK (recommended in a venv to avoid PEP 668 limits): python3 -m venv .venv . .venv/bin/activate python -m pip install dashscope Set DASHSCOPE_API_KEY in your environment, or add dashscope_api_key to ~/.alibabacloud/credentials (env takes precedence). Normalized interface (tts.generate) Request text (string, required) voice (string, required) language_type (string, optional; default Auto ) instruction (string, optional; recommended for instruct models) stream (bool, optional; default false) Response audio_url (string, when stream=false) audio_base64_pcm (string, when stream=true) sample_rate (int, 24000) format (string, wav or pcm depending on mode) Quick start (Python + DashScope SDK) import os import dashscope

Prefer env var for auth: export DASHSCOPE_API_KEY=...

Or use ~/.alibabacloud/credentials with dashscope_api_key under [default].

Beijing region; for Singapore use: https://dashscope-intl.aliyuncs.com/api/v1

dashscope . base_http_api_url = "https://dashscope.aliyuncs.com/api/v1" text = "Hello, this is a short voice line." response = dashscope . MultiModalConversation . call ( model = "qwen3-tts-instruct-flash" , api_key = os . getenv ( "DASHSCOPE_API_KEY" ) , text = text , voice = "Cherry" , language_type = "English" , instruction = "Warm and calm tone, slightly slower pace." , stream = False , ) audio_url = response . output . audio . url print ( audio_url ) Streaming notes stream=True returns Base64-encoded PCM chunks at 24kHz. Decode chunks and play or concatenate to a pcm buffer. The response contains finish_reason == "stop" when the stream ends. Operational guidance Keep requests concise; split long text into multiple calls if you hit size or timeout errors. Use language_type consistent with the text to improve pronunciation. Use instruction only when you need explicit style/tone control. Cache by (text, voice, language_type) to avoid repeat costs. Output location Default output: output/alicloud-ai-audio-tts/audio/ Override base dir with OUTPUT_DIR . Workflow Confirm user intent, region, identifiers, and whether the operation is read-only or mutating. Run one minimal read-only query first to verify connectivity and permissions. Execute the target operation with explicit parameters and bounded scope. Verify results and save output/evidence files. References references/api_reference.md for parameter mapping and streaming example. Realtime mode is provided by skills/ai/audio/alicloud-ai-audio-tts-realtime/ . Voice cloning/design are provided by skills/ai/audio/alicloud-ai-audio-tts-voice-clone/ and skills/ai/audio/alicloud-ai-audio-tts-voice-design/ . Source list: references/sources.md