编辑录音内容

最后更新：2026/10/22

请求方式： POST（HTTPS）

请求地址： https://open.wshoto.com/openapi/ai_recording/update?access_token=ACCESS_TOKEN

Query参数：

参数	类型	必填	说明
access_token	string	是	调用接口凭证

Body参数：

{
  "recording_id": "123456789",
  "title": "客户咨询录音",
  "speakers": [
    {
      "speaker_id": 1,
      "speaker_name": "张三",
      "role": "employee"
    }
  ],
  "transcript_segments": [
    {
      "segment_index": 1,
      "speaker_id": 1,
      "start_ms": 0,
      "end_ms": 1200,
      "text": "您好"
    }
  ]
}

参数	类型	必填	说明
recording_id	string	是	平台录音 ID
title	string	否	新标题；显式传空字符串表示恢复为录音时间标题
media_segments	object[]	否	替换媒体源；仅 COS 转存前允许
segment_index	int	是	从 `1` 连续递增
is_last	bool	是	仅最后一个分段为 `true`
media_type	int	是	固定为 `1`（录音）
file_url	str	是	服务端可下载的 HTTPS 地址
file_name	str	是	仅支持 `.mp3` 或带音轨的 `.mp4`
file_size	long	否	大于 `0`，单位字节
duration	long	否	大于 `0`，单位毫秒
speakers	object[]	更新转写时必填	发言人定义
speaker_id	int	是	发言人 ID，数组内唯一
speaker_name	str	是	发言人名称
role	str	是	仅支持 `employee`、`customer`、`unknown`
transcript_segments	object[]	否	新转写时间轴；仅完成或失败状态允许重新提交
segment_index	int	是	片段序号
speaker_id	int	是	对应 `speakers` 中的发言人 ID
start_ms	long	是	片段开始时间，毫秒；必须小于 `end_ms`
end_ms	long	是	片段结束时间，毫秒
text	str	是	转写文本；片段须按 `start_ms` 升序

注：一次请求不能同时更新 media_segments 和 transcript_segments。仅传 recording_id、或单独传 speakers 均为参数错误。

返回结果：

{
  "code": 0,
  "sub_code": "OK",
  "msg": "请求成功",
  "data": { "recording_id": "123456789", "modified_time": 1780000080000 }
}

参数说明：

参数	类型	说明
code	int	返回码，`0` 表示成功
msg	str	对返回码的文本描述内容
data	object	返回数据
recording_id	str	被编辑的录音 ID
modified_time	long	编辑后的最近修改时间，毫秒时间戳
sub_code	str	业务异常返回码；成功时为 `OK`

编辑录音内容

编辑录音内容

results matching ""

No results matching ""