图像审核接口
更新时间：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)> |
响应体参数
响应体字段数据结构说明
请求示例
JSON
1POST /v1/bucketName_example/objectKey_example?process
2<公共请求头>
3
4
5{
6 "action" : {
7 "sync" : [ {
8 "parameters" : "<base64_encode(param)>",
9 "url" : "$(img-censor)"
10 } ]
11 }
12}响应示例
JSON
1HTTP/1.1 200 OK
2<公共响应头>
3
4{ }错误码
请参考通用错误码