用途:面向需要低延迟、流式语音输出的交互场景,使用阿里云百炼 Qwen TTS Realtime 系列模型进行实时语音合成。
模型(须使用以下精确字符串之一):qwen3-tts-flash-realtime、qwen3-tts-instruct-flash-realtime、qwen3-tts-instruct-flash-realtime-2026-01-22、qwen3-tts-vd-realtime-2026-01-15、qwen3-tts-vc-realtime-2026-01-15。
前置条件:在虚拟环境中安装 SDK——python3 -m venv .venv;. .venv/bin/activate;python -m pip install dashscope。并设置环境变量 DASHSCOPE_API_KEY,或在 ~/.alibabacloud/credentials 中添加 dashscope_api_key。
规范化接口 tts.realtime:请求字段为 text(字符串,必填)、voice(字符串,必填)、instruction(字符串,可选)、sample_rate(整数,可选);响应包含 audio_base64_pcm_chunks(数组)、sample_rate(整数)、finish_reason(字符串)。
使用方式:实时模式使用 websocket 或流式端点;为降低延迟,每次输入文本保持简短;使用指令类模型时,指令应明确简洁。部分 SDK/运行时组合可能拒绝通过 MultiModalConversation 调用实时模型,可用探测脚本验证兼容性。
本地演示脚本:.venv/bin/python skills/ai/audio/alicloud-ai-audio-tts-realtime/scripts/realtime_tts_demo.py --text "This is a realtime speech demo." --fallback --output output/ai-audio-tts-realtime/audio/fallback-demo.wav;严格模式(用于 CI/门禁):.venv/bin/python skills/ai/audio/alicloud-ai-audio-tts-realtime/scripts/realtime_tts_demo.py --text "realtime health check" --strict。
输出位置:默认输出到 output/ai-audio-tts-realtime/audio/,可用 OUTPUT_DIR 覆盖基础目录。
验证:编译脚本目录下所有 .py(python3 -m py_compile),通过标准为命令退出码为 0 且生成 output/alicloud-ai-audio-tts-realtime/validate.txt。
工作流:确认用户意图、地域、标识符及操作是只读还是变更;先执行一次最小只读查询验证连通性与权限;以显式参数和有界范围执行目标操作;验证结果并保存 output/evidence 文件。产物、命令输出与 API 响应摘要保存在 output/alicloud-ai-audio-tts-realtime/ 下,证据文件应包含关键参数(地域/资源 id/时间范围)以便复现。
限制:以上为资料提供的全部事实,收费、价格、具体延迟指标及更详细的平台信息暂未提供。
参考:references/sources.md。