语音合成插件

text

必选

要合成音频的文本内容。长度不超过 1024 个字节，约 340 个汉字。

voice_id

可选

扣子编程音色 ID，支持扣子编程系统预置的音色或资源库中复刻的音色。
你可以通过系统音色列表或调用查看音色列表 API，查看音色 ID。

emotion

可选

设置多情感音色的情感类型，仅当 voice_id 为多情感音色时才支持设置情感类型。不同音色支持的情感范围不同，可以通过系统音色列表查看各音色支持的情感。默认为空。枚举值如下：

• happy：开心。
• sad：悲伤。
• angry：愤怒。
• surprised：惊讶。
• fear：恐惧。
• hate：厌恶。
• excited：兴奋。
• coldness：冷漠。
• neutral：中性。

emotion_scale

可选

情感值用于量化情感的强度。数值越高，情感表达越强烈，例如： “开心” 的情感值 5 比 1 更显兴奋。
取值范围：1.0~5.0，默认值：4.0。

speed_ratio

可选

语速，数值越大，语速越快。例如，2 表示 2 倍速，即语速是正常速度的两倍。
大模型音色的取值范围为 0.5~2，小模型音色的取值范围为 0.2~3，通常保留一位小数即可。
默认值为 1，表示 1 倍速。

language

可选

音色的语种，所有中文音色支持中英文混合场景。可参考系统音色列表查看各音色支持的语种。

speaker_id

可选

预留参数，即将下线，推荐使用 voice_id 参数设置音色。

code

返回状态码，0 表示成功，非 0 表示失败。

data

合成音频的在线文件链接。

log_id

日志 ID，用于问题排查和调试。

msg

执行插件时的状态描述或错误提示信息。