添加录音内容

最后更新：2026/10/22

调用方可提交音频、转写文本，或同时提交两者。仅提交音频时，系统会自动发起转写；创建成功只表示请求已受理，媒体转存、ASR 和 AI 分析均为异步处理。

请求方式： POST（HTTPS）

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

Query参数：

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

Body参数：

{
  "external_recording_id": "client-recording-001",
  "title": "客户咨询录音",
  "userid": "zhangsan",
  "recording_start_time": 1780000000000,
  "recording_end_time": 1780000060000,
  "duration": 60000,
  "media_segments": [
    {
      "segment_index": 1,
      "is_last": true,
      "media_type": 1,
      "file_url": "https://example.com/recording.mp3",
      "file_name": "recording.mp3",
      "file_size": 102400,
      "duration": 60000
    }
  ],
  "relation": {
    "relation_type": 1,
    "external_userid": "wo123"
  }
}

参数	类型	必填	说明
external_recording_id	string	是	调用方录音 ID；同一应用内唯一，最长 128 字符
title	string	否	标题，最长 255 字符；不传时按录音开始时间生成
userid	string	是	录音所属员工 ID
recording_start_time	long	是	录音开始时间，毫秒时间戳
recording_end_time	long	否	录音结束时间，不能早于开始时间
duration	long	否	总时长（毫秒），大于 0
media_segments	object[]	条件必填	媒体片段；与 `transcript_segments` 至少传一个
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[]	条件必填	调用方转写时间轴；传入后不走服务端 ASR
segment_index	int	是	片段序号
speaker_id	int	是	对应 `speakers` 中的发言人 ID
start_ms	long	是	片段开始时间，毫秒；必须小于 `end_ms`
end_ms	long	是	片段结束时间，毫秒
text	str	是	转写文本；片段须按 `start_ms` 升序
result_detail	object	上传转写时必填	原始转写结果，原样留存
relation	object	否	初始客户关联；不创建跟进记录
relation_type	int	是	`1` 企微客户，`2` CRM 联系人
external_userid	str	条件必填	`relation_type=1` 时必填，企微客户 ID
contact_id	long	条件必填	`relation_type=2` 时必填，CRM 联系人 ID

返回结果：

{
  "code": 0,
  "sub_code": "OK",
  "msg": "请求成功",
  "data": {
    "recording_id": "123456789",
    "external_recording_id": "client-recording-001",
    "recording_status": 1,
    "created_time": 1780000000000
  }
}

参数说明：

参数	类型	说明
code	int	返回码，`0` 表示成功
msg	str	对返回码的文本描述内容
data	object	返回数据
recording_id	str	平台录音 ID；用于后续查询、编辑和关联
external_recording_id	str	调用方提交的录音 ID
recording_status	int	`1` 处理中、`2` 完成、`3` 失败；创建受理后通常为 `1`
created_time	long	创建时间，毫秒时间戳
sub_code	str	业务异常返回码；成功时为 `OK`

添加录音内容

添加录音内容

results matching ""

No results matching ""