短视频文案解析接口开发文档
一、接口概述
接口能力:输入音视频链接,识别语音提取文案,支持短视频链接转文案、音频转文本。
计费说明:需实名认证后按量计费,单价0.01元/分钟;免费额度10次;无每日请求限制。
支持部署:公有云调用、私有化部署。
二、基础信息
请求方式:GET / POST
返回格式:JSON
请求头:Content-Type: application/x-www-form-urlencoded;charset=utf-8;
三、请求参数
key(必填,字符串):接口密钥,控制台密钥管理获取,用于权限校验
content(必填,字符串):音视频资源链接。支持mp3、mp4、wav、webm、aac、flac、m4a、mov、mkv、ogg、amr、avi、flv格式等url链接;单文件最大2GB,最长12小时。**请保证内容版权,不可解析无授权视频**
taskId(必填,字符串):任务ID。不传代表提交新任务;传入taskId代表查询已有任务结果
language(选填,字符串):识别语种,默认自动识别。支持中文、英文、日语、粤语、韩语、德语、法语、俄语等
四、返回参数
code:int,状态码,200代表成功
msg:string,状态描述信息
data:object,解析结果数据集
debug:string/array,调试数据
exec_time:float,接口执行耗时
user_ip:string,客户端请求IP
data内部字段:
taskId:任务唯一编号
resultText:提取出来的文案文本
seconds:音视频总时长(秒)
status:任务状态,completed=解析完成
五、返回示例
```json
{
"code": 200,
"msg": "success",
"data": {
"taskId": "3c1d56f8-bd7e-4d15-8112-f212222cd4a6",
"resultText": "本宫主要带你们回家。",
"seconds": 12.38,
"status": "completed"
},
"exec_time": 2.705944,
"user_ip": "220.172.50.48"
}
```
六、错误说明
400:参数缺失、参数错误、格式不对
403:密钥错误、未实名认证、无访问权限
七、对接提示
1. 提交任务拿到taskId后,轮询查询任务直到状态为completed获取文案
2. 支持Python、PHP、Java、JS等各类语言调用
3. 计费按音视频时长计算,无每日调用上限
来源:酷虎api开放平台