图像审核接口
更新时间:2021-12-29
接口说明
此接口用于请求图像审核服务。图像审核服务是百度智能云对外提供的图像智能审核服务,支持对图像的多个维度进行审核,包括色情识别、暴恐识别、政治敏感识别、恶心图识别、广告识别等。
说明: 使用本接口需要先在控制台开通图像审核服务。 url:固定取值为 $(img-censor),不需要修改。 parameters:此项值是对图像审核功能参数进行 base64 编码而成。图像审核功能参数依然是个 json 字符串。
图像审核服务支持的子服务列表有:
- ocr:通用文字识别
- face:人脸探测
- antiporn:色情识别
- politician:政治人物识别
- terror:暴恐识别
- public: 公众人物识别
- disgust: 恶心图识别
- watermark:水印二维码识别
- quality:图像质量识别 value 为各底层服务参数,参照河图 OCR 通用文字识别服务入参。
详细的子服务请求参数及返回参数解释参见下文详细解释。
请求URI
POST /v1/{bucketName}/{objectKey}?process
参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 | 参数位置 |
---|---|---|---|---|---|
bucketName | String | 是 | bucket的名称 | "bucketName_example" | Path |
objectKey | String | 是 | object的名称 | "objectKey_example" | Path |
请求体参数
请求体字段数据结构说明
参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
---|---|---|---|---|
action | Action | 否 |
Action字段数据结构说明
参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
---|---|---|---|---|
sync | List<Sync> | 否 |
Sync字段数据结构说明
参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
---|---|---|---|---|
url | String | 否 | 固定取值为 $(img-censor),不需要修改 | $(img-censor) |
parameters | String | 否 | 此项值是对图像审核功能参数进行 base64 编码而成。图像审核功能参数依然是个 json 字符串 | <base64_encode(param)> |
响应体参数
响应体字段数据结构说明
请求示例
POST /v1/bucketName_example/objectKey_example?process
<公共请求头>
{
"action" : {
"sync" : [ {
"parameters" : "<base64_encode(param)>",
"url" : "$(img-censor)"
} ]
}
}
响应示例
HTTP/1.1 200 OK
<公共响应头>
{ }
错误码
请参考通用错误码