Category: provider

Model Studio Qwen TTS

Validation

CODEBLOCK0

Pass criteria: command exits 0 and output/aliyun-qwen-tts/validate.txt is generated.

Output And Evidence

• - Save generated audio links, sample audio files, and request payloads to output/aliyun-qwen-tts/.
• Keep one validation log per execution.

Critical model names

Use one of the recommended models:

• - INLINECODE2
• INLINECODE3
• INLINECODE4

Prerequisites

• - Install SDK (recommended in a venv to avoid PEP 668 limits):

CODEBLOCK1

• - 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)
• INLINECODE9 (string, required)
• INLINECODE10 (string, optional; default Auto)
• INLINECODE12 (string, optional; recommended for instruct models)
• INLINECODE13 (bool, optional; default false)

Response

• - audio_url (string, when stream=false)
• INLINECODE15 (string, when stream=true)
• INLINECODE16 (int, 24000)
• INLINECODE17 (string, wav or pcm depending on mode)

Quick start (Python + DashScope SDK)

CODEBLOCK2

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: INLINECODE23
• Override base dir with OUTPUT_DIR.

Workflow

1) Confirm user intent, region, identifiers, and whether the operation is read-only or mutating.
2) Run one minimal read-only query first to verify connectivity and permissions.
3) Execute the target operation with explicit parameters and bounded scope.
4) 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/aliyun-qwen-tts-realtime/.
• Voice cloning/design are provided by skills/ai/audio/aliyun-qwen-tts-voice-clone/ and skills/ai/audio/aliyun-qwen-tts-voice-design/.

• - Source list: INLINECODE29