qianwen-audio-tts

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Agent setup: If your agent doesn't auto-load skills (e.g. Claude Code), see agent-compatibility.md once per session.

Agent 设置：如果你的Agent不会自动加载技能（例如Claude Code），请在每个会话中查看agent-compatibility.md。

Qwen Audio TTS (Text-to-Speech)

Synthesize natural speech from text using Qwen TTS models. This skill is part of QianWen-AI/qianwen-ai.

借助Qwen TTS模型将文本合成为自然语音。此技能属于QianWen-AI/qianwen-ai项目。

Skill directory

技能目录

Use this skill's internal files to execute and learn. Load reference files on demand when the default path fails or you need details.

Location	Purpose
`scripts/tts.py`	Qwen TTS (HTTP API) — qwen3-tts-flash, qwen3-tts-instruct-flash
`scripts/tts_cosyvoice.py`	CosyVoice (WebSocket API) — requires `dashscope` SDK
`references/cosyvoice-guide.md`	CosyVoice setup, voices, examples, errors
`references/execution-guide.md`	Fallback: curl (standard, instruct, streaming), code generation
`references/prompt-guide.md`	Text formatting for speech, instructions templates, voice selection
`references/api-guide.md`	API supplement
`references/sources.md`	Official documentation URLs
`references/agent-compatibility.md`	Agent self-check: register skills in project config for agents that don't auto-load

使用此技能的内部文件来执行操作和学习。当默认路径失效或需要详细信息时，按需加载参考文件。

位置	用途
`scripts/tts.py`	Qwen TTS（HTTP API）—— qwen3-tts-flash、qwen3-tts-instruct-flash
`scripts/tts_cosyvoice.py`	CosyVoice（WebSocket API）—— 需要 `dashscope` SDK
`references/cosyvoice-guide.md`	CosyVoice设置、语音选项、示例、错误处理
`references/execution-guide.md`	备选方案：curl（标准、指令式、流式）、代码生成
`references/prompt-guide.md`	语音文本格式、指令模板、语音选择
`references/api-guide.md`	API补充说明
`references/sources.md`	官方文档URL
`references/agent-compatibility.md`	Agent自检：对于不会自动加载技能的Agent，需在项目配置中注册技能

Security

安全注意事项

NEVER output any API key or credential in plaintext. Always use variable references (

$DASHSCOPE_API_KEY

in shell,

os.environ["DASHSCOPE_API_KEY"]

in Python). Any check or detection of credentials must be non-plaintext: report only status (e.g. "set" / "not set", "valid" / "invalid"), never the value. Never display contents of

.env

or config files that may contain secrets.

When the API key is not configured, NEVER ask the user to provide it directly. Instead, help create a

.env

file with a placeholder (

DASHSCOPE_API_KEY=sk-your-key-here

) and instruct the user to replace it with their actual key from the QianWen Console. Only write the actual key value if the user explicitly requests it.

绝对不要以明文形式输出任何API密钥或凭证。请始终使用变量引用（Shell中用

$DASHSCOPE_API_KEY

，Python中用

os.environ["DASHSCOPE_API_KEY"]

）。任何对凭证的检查或检测都必须非明文：仅报告状态（例如“已设置”/“未设置”、“有效”/“无效”），绝不能泄露密钥值。永远不要显示

.env

或可能包含机密信息的配置文件内容。

当未配置API密钥时，绝对不要直接要求用户提供密钥。相反，应帮助用户创建一个带有占位符的

.env

文件（

DASHSCOPE_API_KEY=sk-your-key-here

），并指导用户从QianWen控制台获取实际密钥后替换占位符。仅当用户明确要求时，才写入实际密钥值。

Key Compatibility

密钥兼容性

Scripts require a standard QianWen API key (

sk-...

). Token Plan 团队版 keys (

sk-sp-...

) target a different endpoint (

token-plan.cn-beijing.maas.aliyuncs.com

) and do not include TTS models. Standard

sk-

key required for TTS. The script detects

sk-sp-

keys at startup and prints a warning. If qianwen-ops-auth is installed, see its

references/tokenplan.md

for full details.

脚本需要标准QianWen API密钥（

sk-...

格式）。Token Plan团队版密钥（

sk-sp-...

格式）针对不同的端点（

token-plan.cn-beijing.maas.aliyuncs.com

），且不包含TTS模型。使用TTS必须使用标准的

sk-

格式密钥。脚本在启动时会检测

sk-sp-

格式的密钥并打印警告。如果已安装qianwen-ops-auth，请查看其

references/tokenplan.md

获取详细信息。

Model Selection

模型选择

Qwen TTS (HTTP API) — use

scripts/tts.py

Qwen TTS（HTTP API）—— 使用

scripts/tts.py

Model	Use Case	Notes
`qwen3-tts-flash`	Recommended (standard) — fast, multi-language	Cost-effective, widely available
`qwen3-tts-instruct-flash`	Instruction-guided style control	Tone/emotion via instructions

模型	使用场景	说明
`qwen3-tts-flash`	推荐（标准款）——快速、多语言	性价比高、广泛可用
`qwen3-tts-instruct-flash`	指令引导的风格控制	通过指令调整语气/情感

CosyVoice (WebSocket API) — use

scripts/tts_cosyvoice.py

CosyVoice（WebSocket API）—— 使用

scripts/tts_cosyvoice.py

Model	Use Case
`cosyvoice-v3-flash`	High quality, fast
`cosyvoice-v3-plus`	Highest quality

Note: CosyVoice requires
dashscope
SDK and uses different voices. See cosyvoice-guide.md.

User specified a model → use the appropriate script:

```
qwen3-tts-*
```
→
```
scripts/tts.py
```
```
cosyvoice-*
```
→
```
scripts/tts_cosyvoice.py
```

Consult the qianwen-model-selector skill when model choice depends on capability, scenario, or pricing.
No signal, clear task →
```
qwen3-tts-flash
```
via
```
tts.py
```
(default for standard tasks).

⚠️ Important: The model list above is a point-in-time snapshot and may be outdated. Model availability changes frequently. Always check the official model list for the authoritative, up-to-date catalog before making model decisions.

Model details: For more information about a specific model, direct the user to its detail page:
https://www.qianwenai.com/models/<model-name>
(replace
<model-name>
with the exact model ID, e.g.
qwen3-tts-flash
→ https://www.qianwenai.com/models/qwen3-tts-flash). NEVER modify or guess the model name in the URL.

Dynamic model queries: If the qianwen-model-selector skill or QianWen CLI (
qianwen models info <model>
) is available, use it for real-time model data. CLI requires authentication — see the qianwen-usage skill for login flow.

模型	使用场景
`cosyvoice-v3-flash`	高质量、快速
`cosyvoice-v3-plus`	最高质量

注意：CosyVoice需要
dashscope
SDK，且使用不同的语音选项。请查看cosyvoice-guide.md。

用户指定模型 → 使用对应的脚本：

```
qwen3-tts-*
```
→
```
scripts/tts.py
```
```
cosyvoice-*
```
→
```
scripts/tts_cosyvoice.py
```

当模型选择取决于能力、场景或定价时，请咨询qianwen-model-selector技能。
无指定模型但任务明确 → 通过
```
tts.py
```
使用
```
qwen3-tts-flash
```
（标准任务的默认选择）。

⚠️ 重要提示：上述模型列表是当前时间点的快照，可能已过时。模型可用性会频繁变化。在做出模型选择前，请务必查看官方模型列表获取权威的最新目录。

模型详情：如需了解特定模型的更多信息，请引导用户访问其详情页面：
https://www.qianwenai.com/models/<model-name>
（将
<model-name>
替换为确切的模型ID，例如
qwen3-tts-flash
→ https://www.qianwenai.com/models/qwen3-tts-flash）。绝对不要修改或猜测URL中的模型名称。

动态模型查询：如果qianwen-model-selector技能或QianWen CLI（
qianwen models info <model>
）可用，请使用它们获取实时模型数据。CLI需要身份验证——请查看qianwen-usage技能了解登录流程。

Available Voices

可用语音

Voice	Description	Script
Cherry, Ethan, Serena	Qwen TTS system voices	`tts.py`
longanyang, longanhuan, longhuhu_v3	CosyVoice verified voices	`tts_cosyvoice.py`

Full lists: api-guide.md (Qwen TTS) · cosyvoice-guide.md (CosyVoice)

语音	描述	脚本
Cherry, Ethan, Serena	Qwen TTS系统语音	`tts.py`
longanyang, longanhuan, longhuhu_v3	CosyVoice认证语音	`tts_cosyvoice.py`

完整列表：api-guide.md（Qwen TTS）· cosyvoice-guide.md（CosyVoice）

Execution

执行说明

⚠️ Multiple artifacts: When generating multiple files in a single session, you MUST append a numeric suffix to each filename (e.g.
out_1.wav
,
out_2.wav
) to prevent overwrites.

⚠️ 多文件生成：当在单个会话中生成多个文件时，必须为每个文件名添加数字后缀（例如
out_1.wav
、
out_2.wav
）以防止覆盖。

Qwen TTS (HTTP API) —

tts.py

Qwen TTS（HTTP API）——

tts.py

Prerequisites

前置条件

API Key: Check that
```
DASHSCOPE_API_KEY
```
(or
```
QIANWEN_API_KEY
```
) is set using a non-plaintext check only (e.g. in shell:
```
[ -n "$DASHSCOPE_API_KEY" ]
```
; report only "set" or "not set", never the key value). If not set: run the qianwen-ops-auth skill if available; otherwise guide the user to obtain a key from QianWen Console and set it via
```
.env
```
file (
```
echo 'DASHSCOPE_API_KEY=sk-your-key-here' >> .env
```
in project root or current directory) or environment variable. The script searches for
```
.env
```
in the current working directory and the project root. Skills may be installed independently — do not assume qianwen-ops-auth is present.
Python 3.9+ (stdlib only, no pip install needed)

API密钥：仅通过非明文方式检查
```
DASHSCOPE_API_KEY
```
（或
```
QIANWEN_API_KEY
```
）是否已设置（例如在Shell中：
```
[ -n "$DASHSCOPE_API_KEY" ]
```
；仅报告“已设置”或“未设置”，绝不能泄露密钥值）。如果未设置：如果qianwen-ops-auth技能可用，则运行该技能；否则引导用户从QianWen控制台获取密钥，并通过
```
.env
```
文件（在项目根目录或当前目录执行
```
echo 'DASHSCOPE_API_KEY=sk-your-key-here' >> .env
```
）或环境变量进行设置。脚本会在当前工作目录和项目根目录中查找
```
.env
```
文件。技能可能独立安装——不要假设qianwen-ops-auth已存在。
Python 3.9+（仅需标准库，无需pip安装）

Environment Check

环境检查

Before first execution, verify Python is available:

bash

python3 --version  # must be 3.9+

python3

is not found, try

python --version

py -3 --version

. If Python is unavailable or below 3.9, skip to Path 2 (curl) in execution-guide.md.

首次执行前，验证Python是否可用：

bash

python3 --version  # 必须为3.9+

如果找不到

python3

，尝试

python --version

或

py -3 --version

。如果Python不可用或版本低于3.9，请跳转到execution-guide.md中的路径2（curl）。

Default: Run Script

默认方式：运行脚本

Script path: Scripts are in the

scripts/

subdirectory of this skill's directory (the directory containing this SKILL.md). You MUST first locate this skill's installation directory, then ALWAYS use the full absolute path to execute scripts. Do NOT assume scripts are in the current working directory. Do NOT use

cd

to switch directories before execution.

Execution note: Run all scripts in the foreground — wait for stdout; do not background.

Discovery: Run

python3 <this-skill-dir>/scripts/tts.py --help

first to see all available arguments.

bash

python3 <this-skill-dir>/scripts/tts.py \
  --request '{"text":"Hello, this is a test.","voice":"Cherry"}' \
  --output output/qianwen-audio-tts/ \
  --print-response

Argument	Description
`--request '{...}'`	JSON request body
`--file path.json`	Load request from file
`--output dir/`	Save audio and response JSON to directory
`--print-response`	Print response to stdout
`--model ID`	Override model
`--voice NAME`	Override voice

脚本路径：脚本位于此技能目录（包含此SKILL.md的目录）的

scripts/

子目录中。必须先找到此技能的安装目录，然后始终使用完整绝对路径执行脚本。不要假设脚本在当前工作目录中。执行前不要使用

cd

切换目录。

执行注意：所有脚本都要在前台运行——等待标准输出；不要后台运行。

查看帮助：先运行

python3 <this-skill-dir>/scripts/tts.py --help

查看所有可用参数。

bash

python3 <this-skill-dir>/scripts/tts.py \
  --request '{"text":"Hello, this is a test.","voice":"Cherry"}' \
  --output output/qianwen-audio-tts/ \
  --print-response

参数	描述
`--request '{...}'`	JSON请求体
`--file path.json`	从文件加载请求
`--output dir/`	将音频和响应JSON保存到指定目录
`--print-response`	将响应打印到标准输出
`--model ID`	覆盖默认模型
`--voice NAME`	覆盖默认语音

Verify Result

验证结果

Exit code
```
0
```
+ output contains valid JSON with
```
output.audio
```
field → success
Non-zero exit, HTTP error, empty response, or error JSON → fail
Post-execution check: Verify the output audio file exists and has non-zero size (
```
ls -la <output_dir>
```
)
MANDATORY — stderr signal check: After confirming the result, scan the command's stderr output for
```
[ACTION_REQUIRED]
```
or
```
[UPDATE_AVAILABLE]
```
. If either signal is present, you MUST follow the instructions in Update Check below before responding to the user.

退出码
```
0
```
+ 输出包含带有
```
output.audio
```
字段的有效JSON → 成功
非零退出码、HTTP错误、空响应或错误JSON → 失败
执行后检查：验证输出音频文件是否存在且大小非零（
```
ls -la <output_dir>
```
）
必须执行——标准错误信号检查：确认结果后，扫描命令的标准错误输出中是否包含
```
[ACTION_REQUIRED]
```
或
```
[UPDATE_AVAILABLE]
```
。如果存在其中任一信号，必须按照下面更新检查中的说明操作后再回复用户。

On Failure

失败处理

If the script fails, match the error output against the diagnostic table below to determine the resolution. If no match, read execution-guide.md for alternative paths: curl commands (Path 2 — standard, instruct, streaming), code generation (Path 3), and autonomous resolution (Path 5).

If Python is not available at all → skip directly to Path 2 (curl) in execution-guide.md.

如果脚本执行失败，请将错误输出与下面的诊断表匹配以确定解决方案。如果无匹配项，请阅读execution-guide.md了解备选路径：curl命令（路径2——标准、指令式、流式）、代码生成（路径3）和自主解决（路径5）。

如果完全没有Python环境 → 直接跳转到execution-guide.md中的路径2（curl）。

CosyVoice —

tts_cosyvoice.py

CosyVoice ——

tts_cosyvoice.py

CosyVoice requires

dashscope

SDK. Quick start:

bash

pip install dashscope>=1.24.6
python3 <this-skill-dir>/scripts/tts_cosyvoice.py --text "Hello"

Full guide: cosyvoice-guide.md (setup, voices, examples, errors)

Error Pattern	Diagnosis	Resolution
`command not found: python3`	Python not on PATH	Try `python` or `py -3` ; install Python 3.9+ if missing
`Python 3.9+ required`	Script version check failed	Upgrade Python to 3.9+
`SyntaxError` near type hints	Python < 3.9	Upgrade Python to 3.9+
`QIANWEN_API_KEY/DASHSCOPE_API_KEY not found`	Missing API key	Obtain key from QianWen Console; add to `.env` : `echo 'DASHSCOPE_API_KEY=sk-...' >> .env` ; or run qianwen-ops-auth if available
`HTTP 401`	Invalid or mismatched key	Run qianwen-ops-auth (non-plaintext check only); verify key is valid
`SSL: CERTIFICATE_VERIFY_FAILED`	SSL cert issue (proxy/corporate)	macOS: run `Install Certificates.command` ; else set `SSL_CERT_FILE` env var
`URLError` / `ConnectionError`	Network unreachable	Check internet; set `HTTPS_PROXY` if behind proxy
`HTTP 429`	Rate limited	Wait and retry with backoff
`HTTP 5xx`	Server error	Retry with backoff
`PermissionError`	Can't write output	Use `--output` to specify writable directory

CosyVoice需要

dashscope

SDK。快速开始：

bash

pip install dashscope>=1.24.6
python3 <this-skill-dir>/scripts/tts_cosyvoice.py --text "Hello"

完整指南：cosyvoice-guide.md（设置、语音选项、示例、错误处理）

错误模式	诊断	解决方案
`command not found: python3`	Python不在PATH中	尝试 `python` 或 `py -3` ；如果缺失则安装Python 3.9+
`Python 3.9+ required`	脚本版本检查失败	将Python升级到3.9+
`SyntaxError` near type hints	Python版本低于3.9	将Python升级到3.9+
`QIANWEN_API_KEY/DASHSCOPE_API_KEY not found`	缺少API密钥	从QianWen控制台获取密钥；添加到 `.env` 文件： `echo 'DASHSCOPE_API_KEY=sk-...' >> .env` ；如果可用则运行qianwen-ops-auth技能
`HTTP 401`	密钥无效或不匹配	如果可用则运行qianwen-ops-auth技能（仅非明文检查）；验证密钥是否有效
`SSL: CERTIFICATE_VERIFY_FAILED`	SSL证书问题（代理/企业环境）	macOS：运行 `Install Certificates.command` ；其他系统设置 `SSL_CERT_FILE` 环境变量
`URLError` / `ConnectionError`	网络不可达	检查网络；如果在代理后设置 `HTTPS_PROXY`
`HTTP 429`	请求频率受限	等待后重试并使用退避策略
`HTTP 5xx`	服务器错误	等待后重试并使用退避策略
`PermissionError`	无法写入输出	使用 `--output` 指定可写入的目录

Quick Reference

快速参考

Request Fields

请求字段

Field	Type	Description
`text`	string	Required — text to synthesize (max 600 chars)
`voice`	string	Required — voice ID (e.g. `Cherry` , `Ethan` )
`model`	string	Model ID (default: `qwen3-tts-flash` )
`language_type`	string	`Auto` , `Chinese` , `English` , `Japanese` , `Korean` , `French` , `German` , etc.
`instructions`	string	Tone/style instructions (instruct model only)
`stream`	bool	Enable streaming (Base64 chunks)

字段	类型	描述
`text`	string	必填——待合成的文本（最多600字符）
`voice`	string	必填——语音ID（例如 `Cherry` 、 `Ethan` ）
`model`	string	模型ID（默认： `qwen3-tts-flash` ）
`language_type`	string	`Auto` 、 `Chinese` 、 `English` 、 `Japanese` 、 `Korean` 、 `French` 、 `German` 等
`instructions`	string	语气/风格指令（仅适用于指令式模型）
`stream`	bool	启用流式传输（Base64分块）

Response Fields

响应字段

Field	Description
`audio_url`	URL of generated audio (valid 24h)
`audio_format`	Format (e.g. wav)
`sample_rate`	Sample rate (e.g. 24000)
`usage`	Character usage

字段	描述
`audio_url`	生成的音频URL（有效期24小时）
`audio_format`	音频格式（例如wav）
`sample_rate`	采样率（例如24000）
`usage`	字符使用量

Important Notes

重要说明

text: Max 600 characters per request.
instructions: Only works with
```
qwen3-tts-instruct-flash
```
.
language_type:
```
Auto
```
for mixed language; specify for better pronunciation.
audio_url: Valid for 24 hours — download promptly.
Real-time/streaming TTS: For WebSocket-based real-time TTS (CosyVoice, qwen3-tts-flash-realtime), a WebSocket client is required. This skill covers the HTTP-based non-real-time API. For real-time streaming use cases, refer to the official docs in sources.md.

text：每个请求最多600字符。
instructions：仅适用于
```
qwen3-tts-instruct-flash
```
模型。
language_type：混合语言使用
```
Auto
```
；指定语言可获得更好的发音效果。
audio_url：有效期24小时——请及时下载。
实时/流式TTS：对于基于WebSocket的实时TTS（CosyVoice、qwen3-tts-flash-realtime），需要WebSocket客户端。此技能覆盖基于HTTP的非实时API。如需实时流式传输用例，请参考sources.md中的官方文档。

Cross-Skill Chaining

跨技能联动

When passing generated audio to another skill (e.g., video-gen audio overlay):

Pass
audio_url
directly — scripts detect URL prefixes and pass through without re-upload
Use
```
audio_file
```
only for local playback or non-API operations

当将生成的音频传递给其他技能（例如视频生成的音频叠加）时：

直接传递
audio_url
——脚本会检测URL前缀并直接传递，无需重新上传
仅在本地播放或非API操作时使用
```
audio_file
```

Error Handling

错误处理

Error	Cause	Action
`401 Unauthorized`	Invalid or missing API key	Run qianwen-ops-auth if available; else prompt user to set key (non-plaintext check only)
`400`	Invalid parameters (missing text/voice)	Validate request body
`429` / `5xx`	Rate limit or server error	Retry with backoff

Usage & billing: Use the qianwen-usage skill to check usage, free tier quota, and billing directly. Alternatively, the user can visit the QianWen console: Usage Analytics | Pay-as-you-go Billing | Token Plan 团队版 Subscription

NEVER fabricate, guess, or construct usage/billing/console URLs. Only provide the exact links listed in this skill. If a URL is not listed here, do not invent one.

错误	原因	操作
`401 Unauthorized`	API密钥无效或缺失	如果可用则运行qianwen-ops-auth技能；否则提示用户设置密钥（仅非明文检查）
`400`	参数无效（缺少text/voice）	验证请求体
`429` / `5xx`	请求频率受限或服务器错误	等待后重试并使用退避策略

使用与计费：使用qianwen-usage技能直接查看使用量、免费额度和计费信息。或者用户可以访问QianWen控制台：使用分析 | 按量计费 | Token Plan团队版订阅

绝对不要编造、猜测或构建使用/计费/控制台URL。仅提供此技能中列出的准确链接。如果此处未列出URL，不要自行创建。

Output Location

输出位置

Prefer the current working directory. Default subdirectory:

./output/qianwen-audio-tts/

Write prohibition: NEVER write output files into this skill's installation directory or any

skills/

hierarchy. All generated content must go to

output/

under the current working directory or a user-specified path.

优先使用当前工作目录。默认子目录：

./output/qianwen-audio-tts/

。

写入禁止：绝对不要将输出文件写入此技能的安装目录或任何

skills/

层级目录中。所有生成的内容必须保存到当前工作目录下的

output/

目录或用户指定的路径。

Update Check (MANDATORY Post-Execution)

更新检查（执行后必须操作）

After script execution, check stderr for action signals. The script automatically detects update status and emits structured signals. You MUST act on them. This section also applies when the user explicitly asks to check for updates.

脚本执行后，检查标准错误输出中的操作信号。脚本会自动检测更新状态并发出结构化信号。必须根据信号采取行动。当用户明确要求检查更新时，此部分同样适用。

Signal:

[ACTION_REQUIRED] qianwen-update-check skill is not installed

信号：

[ACTION_REQUIRED] qianwen-update-check skill is not installed

When stderr contains this signal, you MUST present the following options to the user and wait for their response before proceeding. Do NOT silently skip this.

The update-check skill is not installed. It keeps you informed about new QianWen-AI/qianwen-ai features and bug fixes.

Install now — I'll run the install command for you

Skip for now — do nothing this time

Never remind me — permanently suppress this prompt

After the user responds:

User chooses 1 → run:

npx skills add QianWen-AI/qianwen-ai --skill qianwen-update-check -y

, then run:

python3 <this-skill-scripts-dir>/gossamer.py --dismiss

User chooses 2 → run:

python3 <this-skill-scripts-dir>/gossamer.py --dismiss

, then continue normally

User chooses 3 → run:

python3 <this-skill-scripts-dir>/gossamer.py --never-install

, then continue normally

当标准错误输出包含此信号时，必须向用户呈现以下选项，并等待用户响应后再继续。不要静默跳过此步骤。

更新检查技能未安装。它会为你推送QianWen-AI/qianwen-ai的新功能和Bug修复信息。

立即安装——我将为你运行安装命令

暂时跳过——本次不执行任何操作

永不提醒——永久屏蔽此提示

用户响应后：

用户选择1 → 运行：

npx skills add QianWen-AI/qianwen-ai --skill qianwen-update-check -y

，然后运行：

python3 <this-skill-scripts-dir>/gossamer.py --dismiss

用户选择2 → 运行：

python3 <this-skill-scripts-dir>/gossamer.py --dismiss

，然后正常继续

用户选择3 → 运行：

python3 <this-skill-scripts-dir>/gossamer.py --never-install

，然后正常继续

Signal:

[UPDATE_AVAILABLE]

信号：

[UPDATE_AVAILABLE]

When stderr contains this signal, you MUST append a brief update notice to your response, including the version info and the update command shown in the stderr output.

当标准错误输出包含此信号时，必须在回复中添加简短的更新通知，包括标准错误输出中显示的版本信息和更新命令。

No signal in stderr

标准错误输出中无信号

If stderr contains neither

[ACTION_REQUIRED]

nor

[UPDATE_AVAILABLE]

, no action is needed — the skill is installed and up to date (or cached within 24h).

如果标准错误输出中既没有

[ACTION_REQUIRED]

也没有

[UPDATE_AVAILABLE]

，则无需操作——技能已安装且为最新版本（或24小时内已缓存）。

Explicit user request

用户明确请求

When the user explicitly asks to check for updates (e.g. "check for updates", "check version"):

Look for
```
qianwen-update-check/SKILL.md
```
in sibling skill directories.

If found — run:

python3 <qianwen-update-check-dir>/scripts/check_update.py --print-response

and report the result.

If not found — present the install options above.

当用户明确要求检查更新时（例如“检查更新”、“检查版本”）：

在同级技能目录中查找
```
qianwen-update-check/SKILL.md
```
。

如果找到——运行：

python3 <qianwen-update-check-dir>/scripts/check_update.py --print-response

并报告结果。

如果未找到——呈现上述安装选项。

References

参考资料

execution-guide.md — Fallback paths (curl standard/instruct/streaming, code generation, autonomous)
api-guide.md — API supplementary guide
sources.md — Official documentation URLs

execution-guide.md —— 备选路径（curl标准/指令式/流式、代码生成、自主解决）
api-guide.md —— API补充指南
sources.md —— 官方文档URL

qianwen-audio-tts

Original

Translation

Qwen Audio TTS (Text-to-Speech)

Qwen Audio TTS (Text-to-Speech)

Skill directory

技能目录

Security

安全注意事项

Key Compatibility

密钥兼容性

Model Selection

模型选择

Qwen TTS (HTTP API) — use scripts/tts.py

Qwen TTS（HTTP API）—— 使用scripts/tts.py

CosyVoice (WebSocket API) — use scripts/tts_cosyvoice.py

CosyVoice（WebSocket API）—— 使用scripts/tts_cosyvoice.py

Available Voices

可用语音

Execution

执行说明

Qwen TTS (HTTP API) — tts.py

Qwen TTS（HTTP API）—— tts.py

Prerequisites

前置条件

Environment Check

环境检查

Default: Run Script

默认方式：运行脚本

Verify Result

验证结果

On Failure

失败处理

CosyVoice — tts_cosyvoice.py

CosyVoice —— tts_cosyvoice.py

Quick Reference

快速参考

Request Fields

请求字段

Response Fields

响应字段

Important Notes

重要说明

Cross-Skill Chaining

跨技能联动

Error Handling

错误处理

Output Location

输出位置

Update Check (MANDATORY Post-Execution)

更新检查（执行后必须操作）

Signal: [ACTION_REQUIRED] qianwen-update-check skill is not installed

信号：[ACTION_REQUIRED] qianwen-update-check skill is not installed

Signal: [UPDATE_AVAILABLE]

信号：[UPDATE_AVAILABLE]

No signal in stderr

标准错误输出中无信号

Explicit user request

用户明确请求

References

参考资料

Qwen TTS (HTTP API) — use
`scripts/tts.py`

Qwen TTS（HTTP API）—— 使用
`scripts/tts.py`

CosyVoice (WebSocket API) — use
`scripts/tts_cosyvoice.py`

CosyVoice（WebSocket API）—— 使用
`scripts/tts_cosyvoice.py`

Qwen TTS (HTTP API) —
`tts.py`

Qwen TTS（HTTP API）——
`tts.py`

CosyVoice —
`tts_cosyvoice.py`

CosyVoice ——
`tts_cosyvoice.py`

Signal:
`[ACTION_REQUIRED] qianwen-update-check skill is not installed`

信号：
`[ACTION_REQUIRED] qianwen-update-check skill is not installed`

Signal:
`[UPDATE_AVAILABLE]`

信号：
`[UPDATE_AVAILABLE]`