千问语音合成技能 (qwen-tts)

⚠️ 环境变量配置

基础配置（使用任何脚本都需要）

飞书配置（仅 speak_and_send.py 需要）

speak.sh 只需要 DASHSCOPE_API_KEY。如果需要发送语音到飞书，还需配置：

最小配置（只需 DASHSCOPE_API_KEY）：

export DASHSCOPE_API_KEY="sk-xxxxx"

完整配置（包含飞书发送）：

export DASHSCOPE_API_KEY="sk-xxxxx"
export FEISHU_APP_ID="cli_xxxxx"
export FEISHU_APP_SECRET="xxxxx"
export FEISHU_USER_ID="ou_xxxxx"

快速使用

基本语音合成（同步接口）

使用 curl 调用千问 TTS：

curl -X POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "qwen3-tts-flash",
    "input": {
      "text": "要转换的文本内容",
      "voice": "Cherry",
      "language_type": "Chinese"
    }
  }'

常用模型

常用音色（voice 参数）

> 更多音色请参见 references/voices.md

常用参数

输出格式

音频 URL 有效期 24小时，返回格式为 wav。

执行流程

1. 检查环境变量：确保 DASHSCOPE_API_KEY 已设置
2. 构建请求：根据文本和音色参数构建 JSON
3. 调用 API：POST 到千问 TTS 接口
4. 下载音频：从响应中提取 URL 并下载
5. 返回结果：音频文件路径或发送给你

示例：中文朗读

curl -X POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "qwen3-tts-flash",
    "input": {
      "text": "你好，我是千问语音助手，今天天气真不错。",
      "voice": "Cherry",
      "language_type": "Chinese"
    }
  }'

脚本说明

本技能包含两个脚本，按需使用：

scripts/speak.sh

纯 Bash 脚本，仅生成本地音频文件，不需要飞书凭证

# 只需要 DASHSCOPE_API_KEY
./speak.sh "要转换的文本" [音色]
# 输出: /tmp/qwen_tts_xxx.ogg

scripts/speak_and_send.py

Python 脚本，生成 TTS 并发送到飞书，需要配置飞书凭证

# 需要 DASHSCOPE_API_KEY + FEISHU_* 环境变量
python3 speak_and_send.py "要说的文本" [音色]
# 自动发送到配置的 FEISHU_USER_ID

参考资料

完整音色列表和 API 文档请参见：

• references/voices.md - 全部音色列表
• references/api.md - 详细 API 说明

依赖说明

• ffmpeg - 音频格式转换（脚本需要）
• jq - JSON 处理（speak.sh 需要）
• python3 + requests - speak_and_send.py 需要