调用该接口开启离线转写服务。该接口支持通过 AI 技术实现声纹识别（区分发言人）、字幕生成以及智能内容摘要。

• 该功能需要开通 音视频 2.0 和 点播 能力。
• 该接口为异步处理，结果将通过消息抄送返回。请在云信控制台 配置音视频通话的抄送地址（抄送类型 602），或联系网易云信技术支持开通。

请求信息

调用时机

建议在会议开始前就启动该任务。

请求 URL

• 请求方法：POST
• URL：https://rtc.yunxinapi.com/v2/api/task/create

请求头参数

请求头部的参数说明请参考 请求结构。

请求体参数

参数名称	类型	是否必选	取值示例	说明
requestId	String	否	f8f274c1-0e9f-***-c61c06a19475	随机字符串，用于问题排查。
taskType	Number	是	102	服务器任务类型。如果是文件声纹字幕，取值固定为 102。
taskId	String	是	task_id	自定义的任务 ID。请保证此 ID 唯一，为字母数字下划线组成的 64 位以内的字符串。
- data	Object	是	-	离线转写的具体信息。
streamUrl	String	是	https://xxx.com/record_rtmp/output.mp3	点播录制文件地址。支持如下协议和格式： 协议：HTTP、HTTPS 格式：FLV、MP4、MPEG-TS、Matroska (MKV)、MP3、wav、AAC 等
summary	Bool	否	true	是否需要生成摘要，默认 true。
summarizeFormat	String	否	-	自定义摘要格式。

请求体示例

JSON{
    "taskType": 102,
    "taskId": "task_id",
    "requestId": "f8f274c1-0e9f-4583-a243-c61c06a19475",
    "data": {
        "streamUrl": "https://yunxin-sre.nos-jd.163yun.com/record_rtmp/output.mp3",
        "summary": true,   // 是否需要摘要。 默认缺省true
        "summarizeFormat": "请根据会议记录，按参会人分别总结。【输出格式】姓名：- 核心立场：[一句话概括]- 主要情绪：[开心/平和/焦虑/激进/愤怒等]- 核心期望：[一句话概括] 要求：每人总结控制在100字以内，简明扼要。"
    }
}

响应信息

响应参数

参数名称	类型	示例	说明
code	Number	200	状态码，200 表示成功，具体请参考下文状态码。
request_id	String	f8f274c1-0e9f-***-c61c06a19475	请求的唯一标识。
- result	Object	-	调用结果。
taskId	String	2a784467***f6fa56333	任务唯一标识符，房间内唯一。

响应体示例

JSON{
    "code": 200,
    "requestId": "2025",
    "result": {
        "taskId": "task_id"
    }
}

状态码

• 成功返回 code：返回内容中，code 为 200 表示调用正常。
• 异常返回 code：若 code 为其他值，请根据 code 与 errMsg 在 错误码和状态码 查看问题原因。

相关抄送

离线转写返回的抄送，请参考 媒体处理事件抄送（eventType = 602）。