generate_ai_voice

生成 AI 语音。

此接口在已认证的服务连接中调用，账号须属于当前框架且处于在线状态。self_id 与 protocol_id 共同选择账号。

调用 QQ 的 AI 语音生成服务。此上游生成动作可能向群发送语音，不能当作纯下载接口。返回 generated 表示取得真实生成资源，不会返回伪造的 message_id。

适用协议

Android（手机 / 平板）/ Linux QQ。

调用方式

向已认证的 WebSocket 连接发送：

json

{
  "type": "action",
  "id": "example-1",
  "action": "generate_ai_voice",
  "params": {
    "self_id": 123456789,
    "protocol_id": 0,
    "group_id": 987654321,
    "character": "example",
    "text": "你好"
  }
}

响应通过相同 id 对应请求。连接、HTTP 调用与错误处理见通信协议。

参数

参数	类型	必填	说明
`self_id`	`integer`	是	当前框架内的账号 QQ 号
`protocol_id`	`integer`	是	账号协议配置 ID；从 get_protocol_list 获取，必须显式传入，0 也是有效 ID
`group_id`	`integer`	是	目标群号
`character`	`string`	是	AI 音色角色标识，来自 get_ai_characters
`text`	`string`	是	文本内容
`chat_type`	`integer`	否	上游聊天类型参数

返回值

以下为成功响应的 data，错误通过 ok: false 与 error 返回。

字段	类型	说明
`status`	`string`	处理状态
`url`	`string`	资源地址
`file_id`	`string`	上传接口返回的文件标识
`duration`	`integer`	时长，单位依接口的语音或视频资源约定

generate_ai_voice ​

调用方式 ​

参数 ​

返回值 ​

generate_ai_voice

调用方式

参数

返回值