用途:将文本转换为类人语音音频,使用阿里云 Model Studio DashScope 的 Qwen TTS 模型。
主要能力:支持推荐模型 qwen3-tts-flash、qwen3-tts-instruct-flash、qwen3-tts-instruct-flash-2026-01-26。接口 tts.generate 接受 text(必填)、voice(必填)、language_type(可选,默认 Auto)、instruction(可选,建议 instruct 模型使用)、stream(可选,默认 false)。返回 audio_url(非流式)、audio_base64_pcm(流式)、sample_rate(24000)、format(wav 或 pcm)。
使用方式:安装 SDK:python3 -m venv .venv;. .venv/bin/activate;python -m pip install dashscope。设置 DASHSCOPE_API_KEY 环境变量,或在 ~/.alibabacloud/credentials 的 [default] 下添加 dashscope_api_key(环境变量优先)。北京区域使用 https://dashscope.aliyuncs.com/api/v1,新加坡区域使用 https://dashscope-intl.aliyuncs.com/api/v1。通过 dashscope.MultiModalConversation.call 调用,传入 model、api_key、text、voice、language_type、instruction、stream 等参数。
验证:mkdir -p output/alicloud-ai-audio-tts 后执行 python -m py_compile skills/ai/audio/alicloud-ai-audio-tts/scripts/generate_tts.py 并生成 validate.txt,命令退出码为 0 即通过。
输出:默认保存到 output/alicloud-ai-audio-tts/audio/,可用 OUTPUT_DIR 覆盖;保存音频链接、样例文件与请求负载,每次执行保留一份验证日志。
限制与建议:保持请求简洁,过长文本拆分为多次调用;language_type 与文本一致以改善发音;仅在需要风格控制时使用 instruction;可按 (text, voice, language_type) 缓存以减少重复开销。流式返回 24kHz Base64 编码 PCM 分块,结束标志为 finish_reason 等于 stop。实时模式、声音克隆与声音设计由其他技能提供。收费、价格等细节暂未提供。