Skip to main content
Qwen-Audio-TTS

Qwen-Audio-TTS服务端事件

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": "床前明月光,"
    }
  }
}

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": {}
}
文本生成
图像生成
视频生成
世界模型
3D模型生成
音频
Realtime API
  • 概述
向量与排序
决策模型
TokenPlan
模型生产