请求说明
更新时间:2024-09-26
调用审核接口
如果您是第一次使用百度AI服务,请先参照新手指南完成账号创建、应用创建、获取密钥
如果您对内容审核平台的功能、如何配置策略等还不了解,请先查阅接口简介
内容审核平台-长视频(提交任务)
接口地址:
https://aip.baidubce.com/rest/2.0/solution/v1/video_censor/v1/video/submit
请求方式:POST
请求体格式化:content-type:application/x-www-form-urlencoded
注意事项
请求体格式化: Content-Type为application/x-www-form-urlencoded
,然后通过urlencode
格式化请求体
视频格式支持:mp4、avi、flv、mov、wmv、ts、mpeg、3gpp、asf、f4v、mkv、m4a、mp3、mp2、mpg、ogg、mts、wma、webm
编码格式支持:H.264、H.263、H.263+、MPEG-1/2/4、VP8/9、Quicktime、WMV、MJPEG
视频时长/大小限制:视频时长建议不超过3小时,大小建议在2G以内
请求参数说明
URL参数:
参数 | 值 |
---|---|
access_token | 通过API Key和Secret Key获取的access_token,参考“Access Token获取” |
Header如下:
参数 | 值 |
---|---|
Content-Type | application/x-www-form-urlencoded |
Body中放置请求参数,参数详情如下:
参数名称 | 数据类型 | 描述 | 是否必须 |
---|---|---|---|
appid | Long | 应用ID | N |
strategyid | Long | 策略ID | N |
url | String | 视频地址 | Y |
noticeUrl | String | 通知地址,用于用户接收百度推送的审核结果。用户调用接收结果接口以接收审核结果时必填,调用获取结果接口以获取审核结果时无需填写 | N |
frequency | Integer | 抽帧频率,默认 5s一帧,抽帧频率可在内容审核平台-策略中心配置 | N |
extId | String | 用户侧视频唯一标识 | Y |
userId | String | 用户自定义参数Id,可在内容审核平台-数据统计-用户风险统计使用 | N |
userIp | String | 用户自定义参数Ip | N |
subEvents | String | 接收通知的审核结论数据【1是合规、2是违规、3是疑似、4是审核失败】,之间用英文逗号分隔,默认是2,3【代表通知推送审核结论是违规和疑似的数据】 | N |
priority | Integer | 账户下任务优先级,1-10,数字越小优先级越高,默认10 | N |
extraInfo | String | 额外信息,支持客户自定义的透传信息 | N |
detectType | Integer | 视频的审核类型,0视频、音频同时过审,1仅视频过审,2仅音频过审,默认是1 | N |
请求示例代码
提示一:使用示例代码前,请记得替换其中的示例Token、文件地址等信息
提示二:部分语言依赖的类或库,请在代码注释中查看下载地址
长视频审核任务提交接口 Bash调用
curl -i -k '替换url?access_token=【调用鉴权接口获取的token】' --data 'strategyId=策略Id&url=待审核视频url¬iceUrl=审核结论通知地址&frequency=抽帧频率&extId=用户定义唯一标识' -H 'Content-Type:application/x-www-form-urlencoded'
JAVA调用
import com.baidu.ai.platform.solution.common.utils.HttpUtil;
public class AsyncVideoCensorDemo {
/**
* 重要提示代码中所需工具类
* FileUtil,Base64Util,HttpUtil,GsonUtils请从
* https://ai.baidu.com/file/658A35ABAB2D404FBF903F64D47C1F72
* https://ai.baidu.com/file/C8D81F3301E24D2892968F09AE1AD6E2
* https://ai.baidu.com/file/544D677F5D4E4F17B4122FBD60DB82B3
* https://ai.baidu.com/file/470B3ACCA3FE43788B5A963BF0B625F3
* 下载
*/
public static String asyncVideoTaskSubmit() {
// 请求url
// TODO: 2021/8/19 映射外网url后填充
String url = "";
try {
String param = "strategyId=" + "策略Id(可选)" + "&url=" + "待审核视频url(必填)"
+ "¬iceUrl=" + "审核结论通知地址(必填有效地址)" + "&frequency=" + "抽帧频率(可选)"
+"&extId=" + "用户定义唯一标识(必填)" ;
// 注意这里仅为了简化编码每一次请求都去获取access_token,线上环境access_token有过期时间, 客户端可自行缓存,过期后重新获取。
String accessToken = "[调用鉴权接口获取的token]";
String result = HttpUtil.post(url, accessToken, param);
System.out.println(result);
return result;
} catch (Exception e) {
e.printStackTrace();
}
return null;
}
public static void main(String[] args) {
AsyncVideoCensorDemo.asyncVideoTaskSubmit();
}
}