WebSocket Demo中双向流式对话上行事件chat.update的data.output_audio.emotion_config.emotion，data.output_audio.context_texts等情感语气参数传递

[KevinWangHP]

除在初始化配置中填写，目前是否支持将情感、语气参数，在每一次调用语音合成时传递？即可以随着文本改变情感语气，一个常见的思路是在bot的生成内容中添加格式化context如：[context] content，然后每次调用合成语音时传入

[coze-js-bot]

正在帮您查询中，请稍等...

问题分析与解决方案

根据对扣子API文档的分析，目前已经支持在每次语音合成时动态传递情感语气参数，无需仅在初始化时配置。以下是具体的实现方案：

1. 功能支持情况

根据扣子API的更新日志和文档，在2025年8月4日的更新中，已经为双向流式对话上行事件chat.update添加了data.output_audio.emotion_config参数，用于设置多情感音色的情感类型和情感值。同时，data.output_audio.context_texts参数也支持在每次调用时传递，用于控制合成语音的整体情绪、语气等。

2. 具体实现方案

方案一：通过chat.update事件动态配置

在每次需要进行语音合成前，发送chat.update事件，在data.output_audio中配置情感语气参数：

{
  "id": "event_id",
  "event_type": "chat.update",
  "data": {
    "output_audio": {
      "voice_id": "多情感音色ID",
      "context_texts": "用低沉沙哑的语气、带着沧桑与绝望地说",
      "emotion_config": {
        "emotion": "sad",
        "emotion_scale": 4.0
      }
    }
  }
}

参数说明：

• context_texts：用于控制合成语音的整体情绪、方言、语气等，仅当voice_id为豆包语音合成大模型2.0音色时支持
• emotion_config.emotion：设置多情感音色的情感类型，支持happy、sad、angry等9种情感
• emotion_config.emotion_scale：情感值，取值范围1.0~5.0，数值越高情感表达越强烈

方案二：在消息内容中嵌入情感标记（自定义实现）

如果需要更灵活地根据文本内容动态调整情感，可以在智能体生成的文本中嵌入情感标记，然后在客户端解析这些标记并转换为对应的语音合成参数。

例如：

1. 智能体回复：[emotion:sad][context:用低沉沙哑的语气说]今天的天气真糟糕
2. 客户端解析出情感参数：emotion=sad，context_texts="用低沉沙哑的语气说"
3. 客户端发送chat.update事件配置语音合成参数
4. 客户端发送对话内容进行语音合成

3. 注意事项

• context_texts参数仅当voice_id为豆包语音合成大模型2.0音色时支持
• emotion_config参数仅当voice_id为多情感音色时支持
• 可以通过查看音色列表API查看当前可用的所有音色ID及其支持的参数
• 在发送chat.update事件后，需要等待chat.updated下行事件确认配置更新成功后再发送对话内容

4. 完整示例代码

const url = `wss://ws.coze.cn/v1/chat?bot_id=你的bot_id&authorization=Bearer 你的access_token`;
const ws = new WebSocket(url);

ws.addEventListener('open', function () {
  console.log('Connected to server.');
  
  // 第一次配置：开心的语气
  const happyConfig = {
    "id": "config_1",
    "event_type": "chat.update",
    "data": {
      "output_audio": {
        "voice_id": "多情感音色ID",
        "emotion_config": {
          "emotion": "happy",
          "emotion_scale": 4.0
        }
      }
    }
  };
  ws.send(JSON.stringify(happyConfig));
});

ws.addEventListener('message', function (message) {
  const data = JSON.parse(message.data.toString());
  
  if (data.event_type === 'chat.updated') {
    console.log('配置更新成功');
    
    // 发送对话内容
    const messageData = {
      "id": "msg_1",
      "event_type": "conversation.message.create",
      "data": {
        "role": "user",
        "content_type": "text",
        "content": "今天天气真好！"
      }
    };
    ws.send(JSON.stringify(messageData));
  } else if (data.event_type === 'conversation.message.created') {
    console.log('消息发送成功');
    
    // 第二次配置：悲伤的语气
    const sadConfig = {
      "id": "config_2",
      "event_type": "chat.update",
      "data": {
        "output_audio": {
          "voice_id": "多情感音色ID",
          "emotion_config": {
            "emotion": "sad",
            "emotion_scale": 3.5
          }
        }
      }
    };
    ws.send(JSON.stringify(sadConfig));
  }
});

通过以上方案，可以实现每次语音合成时动态传递情感语气参数，满足不同文本内容对应不同情感表达的需求。> 正在帮您查询中，请稍等...

问题分析与解决方案

根据对扣子API文档的分析，目前已经支持在每次语音合成时动态传递情感语气参数，无需仅在初始化时配置。以下是具体的实现方案：

1. 功能支持情况

根据扣子API的更新日志和文档，在2025年8月4日的更新中，已经为双向流式对话上行事件chat.update添加了data.output_audio.emotion_config参数，用于设置多情感音色的情感类型和情感值。同时，data.output_audio.context_texts参数也支持在每次调用时传递，用于控制合成语音的整体情绪、语气等。

2. 具体实现方案

方案一：通过chat.update事件动态配置

在每次需要进行语音合成前，发送chat.update事件，在data.output_audio中配置情感语气参数：

{
  "id": "event_id",
  "event_type": "chat.update",
  "data": {
    "output_audio": {
      "voice_id": "多情感音色ID",
      "context_texts": "用低沉沙哑的语气、带着沧桑与绝望地说",
      "emotion_config": {
        "emotion": "sad",
        "emotion_scale": 4.0
      }
    }
  }
}

参数说明：

• context_texts：用于控制合成语音的整体情绪、方言、语气等，仅当voice_id为豆包语音合成大模型2.0音色时支持
• emotion_config.emotion：设置多情感音色的情感类型，支持happy、sad、angry等9种情感
• emotion_config.emotion_scale：情感值，取值范围1.0~5.0，数值越高情感表达越强烈

方案二：在消息内容中嵌入情感标记（自定义实现）

如果需要更灵活地根据文本内容动态调整情感，可以在智能体生成的文本中嵌入情感标记，然后在客户端解析这些标记并转换为对应的语音合成参数。

例如：

1. 智能体回复：[emotion:sad][context:用低沉沙哑的语气说]今天的天气真糟糕
2. 客户端解析出情感参数：emotion=sad，context_texts="用低沉沙哑的语气说"
3. 客户端发送chat.update事件配置语音合成参数
4. 客户端发送对话内容进行语音合成

3. 注意事项

• context_texts参数仅当voice_id为豆包语音合成大模型2.0音色时支持
• emotion_config参数仅当voice_id为多情感音色时支持
• 可以通过查看音色列表API查看当前可用的所有音色ID及其支持的参数
• 在发送chat.update事件后，需要等待chat.updated下行事件确认配置更新成功后再发送对话内容

4. 完整示例代码

const url = `wss://ws.coze.cn/v1/chat?bot_id=你的bot_id&authorization=Bearer 你的access_token`;
const ws = new WebSocket(url);

ws.addEventListener('open', function () {
  console.log('Connected to server.');
  
  // 第一次配置：开心的语气
  const happyConfig = {
    "id": "config_1",
    "event_type": "chat.update",
    "data": {
      "output_audio": {
        "voice_id": "多情感音色ID",
        "emotion_config": {
          "emotion": "happy",
          "emotion_scale": 4.0
        }
      }
    }
  };
  ws.send(JSON.stringify(happyConfig));
});

ws.addEventListener('message', function (message) {
  const data = JSON.parse(message.data.toString());
  
  if (data.event_type === 'chat.updated') {
    console.log('配置更新成功');
    
    // 发送对话内容
    const messageData = {
      "id": "msg_1",
      "event_type": "conversation.message.create",
      "data": {
        "role": "user",
        "content_type": "text",
        "content": "今天天气真好！"
      }
    };
    ws.send(JSON.stringify(messageData));
  } else if (data.event_type === 'conversation.message.created') {
    console.log('消息发送成功');
    
    // 第二次配置：悲伤的语气
    const sadConfig = {
      "id": "config_2",
      "event_type": "chat.update",
      "data": {
        "output_audio": {
          "voice_id": "多情感音色ID",
          "emotion_config": {
            "emotion": "sad",
            "emotion_scale": 3.5
          }
        }
      }
    };
    ws.send(JSON.stringify(sadConfig));
  }
});

通过以上方案，可以实现每次语音合成时动态传递情感语气参数，满足不同文本内容对应不同情感表达的需求。{"msg_type":"empty result","data":"empty result","from_module":null,"from_unit":null}{"msg_type":"generate_answer_finish","data":"","from_module":null,"from_unit":null}{"msg_type":"generate_answer_finish","data":"{"finish_reason":0,"FinData":""}","from_module":null,"from_unit":null}