跳到主要内容

创建驱动音频

1.接口说明​

音频驱动场景中，用户可以上传一段音频做为驱动内容，制作视/音频。

为了满足制作视频时的字幕需要，驱动音频在上传成功后，会自动进行语音识别，生成字幕内容。

请求该接口，提供驱动音频素材信息，创建驱动音频，获取音频文件上传地址。

2.请求地址​

https://digitbot.bokecc.com/api/scene/audio/create

3.请求方式​

POST application/json

4.请求参数​

(1).公共参数，参考服务说明。​

(2).接口参数​

①.Query参数：通过URL参数传递。​

参数名类型必需说明
versionString是接口版本号，当前支持版本：1.0.0。

②.Body参数：通过请求Body传递，json格式。​

参数名类型必需说明
filenameString是音频文件名，最多100个字符，要求文件名带扩展名(后缀名)。
sizeLong是音频文件大小，单位：B(字节)。最大支持1GB。
md5String是音频文件md5。
callbackUrlString否语音转写结果回调地址。不传值或地址无效，不发送回调。

5.请求示例​

POST https://digitbot.bokecc.com/api/scene/audio/create?accountId=xxx&version=1.0.0&hash=xxx&time=xxx HTTP/1.1
{
    "filename": "xxx讲义.mp3",
	"size": 92345670,
	"md5": "xxxxxxxxxxxxxxxx"
}

6.响应示例​

{
  "id": "xxx",
  "uploadUrl": "https://xxxx.xxxx/xxxx"
}

7.响应说明​

字段名类型说明
idString音频ID。
uploadUrlString音频文件上传地址。
  • uploadUrl：使用该驱动音频文件上传地址，以PUT方式，将音频文件发送到该地址即可。
    • 上传时需要设置Content-Type请求头。
    • 该地址上传失败时，可以重新从头开始上传。
    • 上传成功后，该地址不再接收数据，不可重新上传。
    • 地址有效时间2小时。
    • 可参考上传示例。