task-started
当客户端发送 run-task 指令后，服务端返回 task-started 事件，标志任务已成功开启。只有在接收到该事件后，客户端才能继续发送后续指令。
header.task_id string 客户端生成的任务 ID。 header.event string 事件类型，固定为 task-started。 payload object 无内容，为空对象。 | {
"header": {
"task_id": "2bf83b9a-baeb-4fda-8d9a-xxxxxxxxxxxx",
"event": "task-started",
"attributes": {}
},
"payload": {}
}
|
result-generated
客户端发送文本后，服务端持续返回 result-generated 事件。该事件返回句子元信息。
header.task_id string 客户端生成的任务 ID。 header.event string 事件类型，固定为 result-generated。 payload.output object 输出信息。 属性 type string 子事件类型，取值：
sentence-begin：句子开始，返回待合成的文本内容sentence-synthesis：标识音频数据块，每个事件后立即通过 WebSocket binary 通道传输一个音频数据帧sentence-end：句子结束，返回文本内容和用量信息（usage） sentence.index integer 句子编号，从 0 开始。 sentence.words array 字级别时间戳信息数组。 words 元素属性 text string 字的文本内容。 begin_index integer 字在句子中的开始位置索引，从 0 开始。 end_index integer 字在句子中的结束位置索引，从 1 开始。 begin_time integer 字对应音频的开始时间戳，单位：毫秒。 end_time integer 字对应音频的结束时间戳，单位：毫秒。 original_text string 分句后的句子文本内容。 payload.usage object 计费用量，在 sentence-end 事件中返回。 属性 input_tokens integer 本次请求的输入 Token 数。 说明适用于 qwen-audio-3.1-tts-flash。 output_tokens integer 本次请求的输出 Token 数。 说明适用于 qwen-audio-3.1-tts-flash。 total_tokens integer 输入和输出 Token 数之和。 说明适用于 qwen-audio-3.1-tts-flash。 characters integer 累计计费字符数。 说明适用于 qwen-audio-3.0-tts-plus、qwen-audio-3.0-tts-flash。 | {
"header": {
"task_id": "3f2d5c86-0550-45c0-801f-xxxxxxxxxx",
"event": "result-generated",
"attributes": {}
},
"payload": {
"output": {
"sentence": {
"index": 0,
"words": []
},
"type": "sentence-begin",
"original_text": "床前明月光，"
}
}
}
{
"header": {
"task_id": "3f2d5c86-0550-45c0-801f-xxxxxxxxxx",
"event": "result-generated",
"attributes": {}
},
"payload": {
"output": {
"sentence": {
"index": 0,
"words": []
},
"type": "sentence-synthesis"
}
}
}
{
"header": {
"task_id": "3f2d5c86-0550-45c0-801f-xxxxxxxxxx",
"event": "result-generated",
"attributes": {}
},
"payload": {
"output": {
"sentence": {
"index": 0,
"words": [
{
"text": "床",
"begin_index": 0,
"end_index": 1,
"begin_time": 0,
"end_time": 263
}
]
},
"type": "sentence-end",
"original_text": "床前明月光，"
},
"usage": {
"characters": 6
}
}
}
|
task-finished
服务端返回 task-finished 事件，标志任务已结束。客户端可以关闭 WebSocket 连接或复用连接开启新任务。
header.task_id string 客户端生成的任务 ID。 header.event string 事件类型，固定为 task-finished。 payload.usage object 字段含义与 result-generated 的 usage 相同。 | {
"header": {
"task_id": "2bf83b9a-baeb-4fda-8d9a-xxxxxxxxxxxx",
"event": "task-finished",
"attributes": {
"request_uuid": "0a9dba9e-d3a6-45a4-be6d-xxxxxxxxxxxx"
}
},
"payload": {
"usage": {
"characters": 13
}
}
}
|
task-failed
当任务失败时，服务端返回 task-failed 事件。客户端需要关闭 WebSocket 连接并处理错误。
header.task_id string 客户端生成的任务 ID。 header.event string 事件类型，固定为 task-failed。 header.error_code string 错误码。 header.error_message string 具体错误信息。 | {
"header": {
"task_id": "2bf83b9a-baeb-4fda-8d9a-xxxxxxxxxxxx",
"event": "task-failed",
"error_code": "InvalidParameter",
"error_message": "[tts:]Engine return error code: 418",
"attributes": {}
},
"payload": {}
}
|