通过 C# SDK 调用 Qwen-Audio-TTS / CosyVoice 合成语音并接收音频分片。
快速开始
按安装 SDK安装 SDK 并配置 API Key。
- Qwen-Audio-TTS
- CosyVoice
用
longanfengyue_v3.1 音色分段合成两句话,将收到的音频依次写入 output.wav。运行后即可播放该文件。调用步骤
- 创建
CosyVoiceSpeechSynthesizer实例,选择与模型匹配的音色和输出格式,并按需订阅AudioReceived、SentenceProgress等事件。 - 使用
SendTextAsync时,调用StartAsync建立连接并发送run-task。 - 调用
SendTextAsync分段发送文本;若已有完整分段文本,也可直接调用StreamAudioAsync或SynthesizeAsync,无需先调用StartAsync。 - 在
AudioReceived中接收音频分片,在SentenceProgress中获取句级进度与时间戳(使用StreamAudioAsync时直接按顺序读取返回的音频分片)。 - 使用
SendTextAsync时,文本发送完毕后调用StopAsync,等待task-finished(即SynthesisCompleted)。 - 如需中断当前合成任务但保留连接,可调用
CancelSynthesisKeepConnectionAsync;不再使用时调用DisposeAsync释放连接。
参数说明
创建 CosyVoiceSpeechSynthesizer 时传入 CosyVoiceSynthesizerOptions。EnableSsml、WordTimestampEnabled、EnableAigcTag 和 EnableMarkdownFilter 为 null 时,SDK 仍会将其作为 false 发送。
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
Model | string | qwen-audio-3.1-tts-flash | 模型 ID;显式指定本系列模型。 |
Voice | string | longanfengyue_v3.1 | 与所选模型匹配的音色 ID,参见 Qwen-Audio-TTS 可用音色或 CosyVoice 可用音色。 |
Format | string | pcm | 音频格式。 |
SampleRate | int | 22050 | 音频采样率,单位 Hz。 |
Volume | int? | null | 音量,取值 0 至 100。 |
Rate | double? | null | 语速倍率。 |
Pitch | double? | null | 语调倍率。 |
BitRate | int? | null | 输出码率,取值 6 至 510 kbps,仅在 Format 为 opus 或 mp3 时生效。 |
Seed | int? | null | 随机种子。 |
EnableSsml | bool? | null | 是否开启 SSML 解析。 通过一次 continue-task 发送完整的 SSML 文本;使用 SynthesizeAsync 时只传入一个文本分段。音频可流式接收。 |
WordTimestampEnabled | bool? | null | 是否返回字词级时间戳。 |
LanguageHints | IList<string>? | null | 在 qwen-audio-3.1-tts-flash 的多语种或方言音色上,设置方法见 Qwen-Audio-TTS。CosyVoice 用此字段指定合成目标语言,只处理第一个值,取值见 CosyVoice · 客户端事件。 |
Instruction | string? | null | 音色指令。 |
EnableAigcTag | bool? | null | 是否嵌入 AIGC 隐性标识(wav、mp3、opus 格式生效)。在 CosyVoice 系列中,仅 cosyvoice-v3-flash、cosyvoice-v3-plus、cosyvoice-v2 支持此参数。 |
AigcPropagator | string? | null | AIGC 内容传播者标识。 仅在 EnableAigcTag 为 true 时下发;在 CosyVoice 系列中,仅 cosyvoice-v3-flash、cosyvoice-v3-plus、cosyvoice-v2 支持。 |
AigcPropagateId | string? | null | AIGC 内容传播行为标识。 仅在 EnableAigcTag 为 true 时下发;在 CosyVoice 系列中,仅 cosyvoice-v3-flash、cosyvoice-v3-plus、cosyvoice-v2 支持。 |
HotFixJson | string? | null | 文本热修复配置,传入包含 pronunciation 和 replace 规则的 JSON 对象字符串。cosyvoice-v2 不支持此参数。 |
ExtraParametersJson | string? | null | JSON 对象字符串,合并到协议的 parameters 对象。 |
EnableMarkdownFilter | bool? | null | 是否过滤输入中的 Markdown 标记。cosyvoice-v2 不支持此参数。 |