SuperAPI AI 工具集

aliyun-qwen-tts

智能体与模型

查看项目

更新于 10-15 17:34

技能介绍

用途:调用阿里云 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,流式返回 Base64 编码的 24kHz PCM 分块,采样率 24000,格式为 wav 或 pcm,流结束时 finish_reason 为 stop。

使用方式:先安装 SDK,建议在虚拟环境中执行 python3 -m venv .venv、. .venv/bin/activate、python -m pip install dashscope;再设置 DASHSCOPE_API_KEY 环境变量,或在 ~/.alibabacloud/credentials 中配置 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,读取 response.output.audio.url。

适用场景:需要批量或按需生成语音音频、对语气风格有控制需求、或需要流式播放的场景。

限制与建议:请求应保持简短,遇到体积或超时错误时拆分长文本;language_type 应与文本一致以改善发音;仅在需要明确风格时使用 instruction;可按 (text, voice, language_type) 缓存以避免重复费用。默认输出目录为 output/aliyun-qwen-tts/audio/,可用 OUTPUT_DIR 覆盖。实时模式、声音克隆与声音设计分别由其他技能提供。验证命令为 mkdir -p output/aliyun-qwen-tts 与 python -m py_compile skills/ai/audio/aliyun-qwen-tts/scripts/generate_tts.py,通过标准为退出码 0 且生成 validate.txt。