控制指令

全局情绪

使用 emotion 字段为整次文字转语音请求指定统一情绪。

全局情绪

全局情绪用于调整整次文字转语音请求的主要表达方式。它不会改变音色本身，而是在模型支持的范围内控制整段内容的情绪。

全局情绪 `emotion`

在 TTS 请求体中传入 emotion，可以为整段文本指定一种全局情绪：

{
  "text": "今天终于完成了这个项目，真的很开心。",
  "voiceId": "YOUR_MINIMAX_VOICE_ID",
  "modelId": "minimax-2.8-turbo",
  "emotion": "happy"
}

可用值：

值	含义	适用表达
`happy`	开心	明亮、积极、愉快
`sad`	悲伤	低落、克制、伤感
`angry`	生气	强烈、有压迫感
`surprised`	惊讶	意外、语调上扬
`fearful`	害怕	紧张、担忧、略带颤抖
`calm`	平静	舒缓、稳定、自然
`disgusted`	厌恶	不满、排斥、反感

支持的模型

全局 emotion 支持以下 MiniMax 模型：

minimax-2.8-turbo
minimax-2.8-hd
minimax-2.6-turbo
minimax-2.6-hd

其他模型不支持全局 emotion。需要在文本内局部切换表达时，请使用精细情绪。

默认行为

不传 emotion 时，模型会根据文本和音色自然表达。
情绪 ID 区分拼写，请使用表格中的小写英文值。
emotion 作用于一次请求中的整段文本，不适合在同一段文本里频繁切换情绪。
传入表格以外的值可能导致请求失败。
情绪表现会受文本和音色影响，同一个值在不同音色上的强度可能不同。

你也可以通过 GET /api/openapi.json 查看最新可用值。模型选择方式见配音模型。

接口示例

控制指令

选择全局情绪或文本内精细情绪控制方式。

Kitta Audio S2

使用开放域行内标签，在词或短语级别控制情绪、节奏和声音动作。

本页内容

全局情绪全局情绪 emotion支持的模型默认行为接口示例