feat: support voice emotions

Author: duwenhan2byte

common/changes/@coze/api/feat-voice-emotion_2025-08-12-08-11.json

@@ -0,0 +1,11 @@
+{
+  "changes": [
+    {
+      "packageName": "@coze/api",
+      "comment": "support voice emotions",
+      "type": "minor"
+    }
+  ],
+  "packageName": "@coze/api",
+  "email": "[email protected]"
+}

common/changes/@coze/api/feat-voice-emotion_2025-08-12-08-14.json

@@ -0,0 +1,11 @@
+{
+  "changes": [
+    {
+      "packageName": "@coze/api",
+      "comment": "support voice emotions",
+      "type": "minor"
+    }
+  ],
+  "packageName": "@coze/api",
+  "email": "[email protected]"
+}

packages/coze-js/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coze/api",
-  "version": "1.3.5",
+  "version": "1.3.6",
   "description": "Official Coze Node.js SDK for seamless AI integration into your applications | 扣子官方 Node.js SDK，助您轻松集成 AI 能力到应用中",
   "keywords": [
     "coze",
@@ -35,6 +35,7 @@
     "node-fetch": false,
     "ws": false
   },
+  "types": "dist/types/index.d.ts",
   "typesVersions": {
     "*": {
       ".": [
@@ -116,4 +117,4 @@
       "agora-rtc-sdk-ng": "$agora-rtc-sdk-ng"
     }
   }
-}
+}

packages/coze-js/src/resources/audio/speech/speech.ts

@@ -43,4 +43,8 @@ export interface CreateSpeechReq {
   /** Sample rate, default is 24000, supports 8000, 16000, 24000, 32000, 44100, 48000
    * | 采样率，默认是24000，支持8000, 16000, 24000, 32000, 44100, 48000 */
   sample_rate?: number;
+  /** 情感，默认为空 */
+  emotion?: string;
+  /** 情感强度，[1,5]，默认为4，通常保留一位小数即可 */
+  emotion_scale?: number;
 }

packages/coze-js/src/resources/audio/voices/voices.ts

@@ -103,6 +103,18 @@ export interface ListVoicesData {
   has_more: boolean;
 }
 
+export interface Interval {
+  min?: number;
+  max?: number;
+  default?: number;
+}
+
+export interface EmotionInfo {
+  emotion?: string;
+  display_name?: string;
+  emotion_scale_interval?: Interval;
+}
+
 export interface Voice {
   /** Whether it is a system voice | 是否为系统音色 */
   is_system_voice: boolean;
@@ -125,4 +137,6 @@ export interface Voice {
   available_training_times: number;
   /** Preview audio | 预览音频 */
   preview_audio: string;
+  /** 支持的情感列表 */
+  support_emotions?: EmotionInfo[];
 }

packages/coze-js/src/resources/websockets/types.ts

@@ -518,6 +518,13 @@ interface OutputAudio {
   /**输出音频的语速，取值范围 [-50, 100]，默认为 0。-50 表示 0.5 倍速，100 表示 2 倍速。 */
   speech_rate?: number;
   voice_id?: string;
+  /** 输出语音的情感配置 */
+  emotion_config?: {
+    /** 情感 */
+    emotion?: string;
+    /** 情绪值 */
+    emotion_scale?: number;
+  };
 }
 
 export interface TurnDetection {