内容审核-图像

本章节提供了通过Postman调用“内容审核-图像”的样例，帮助您快速体验并熟悉使用本服务，具体步骤如下：

步骤一：开通服务，用户在“服务列表”或“服务管理”页面选择内容审核-图像服务申请开通。

步骤二：对象存储服务OBS授权（可选），如果需要对OBS中的数据进行内容审核请开通对象存储服务OBS授权。

步骤三：配置审核规则（可选），可对涉黄内容进行不同场景的检测。

步骤四：配置环境，把准备的配置文件导入到开发环境中。

步骤五：Token认证鉴权，用户调用API接口时，需要使用Token进行鉴权。

步骤六：调用服务，调用API接口使用服务，使用过程中可以随时查看状态码与错误码。

步骤七：查看调用次数（可选），在控制台查看调用详情和调用次数统计。

步骤一：开通服务

内容审核-图像服务开通步骤请参考开通服务步骤说明。

步骤二：对象存储服务OBS授权（可选）

如果您需要对OBS中的数据进行内容审核，请开通对象存储服务OBS授权。具体操作步骤如下：

登录华为云内容审核管理控制台，单击进入“服务管理”页面。
打开对象存储服务OBS授权的按钮，完成授权操作。
- Moderation不支持跨区域OBS，OBS的区域需要和服务保持一致。
- OBS授权需要使用IAM主账号进行授权，不支持使用子账号进行授权。
- 授权完成后，不支持取消授权操作。

步骤三：配置审核规则（可选）

如果您需要对涉黄内容进行不同场景的检测，可进行审核规则的配置。具体操作步骤请参考配置审核规则。

步骤四：配置环境

下载并安装Postman。Postman建议使用7.24.0版本。

步骤五：Token认证鉴权

在Postman界面，选择“New > Collection”，设置相应的名称并单击“Create”完成创建。
选择创建的Collection，单击鼠标右键，选择“Add Request”，设置Request name并单击“Save”。
请求方式修改为"POST"，输入URL。
例如，以ap-southeast-1为例，URL为“https://iam.ap-southeast-1.myhuaweicloud.com/v3/auth/tokens”。
在“Headers”列表中添加“KEY”为“Content-Type”，“VALUE”为“application/json”。

选中“Body”的配置项，选中“raw”，在空白处添加以下代码。

图1 Token认证鉴权

图中代码红框内加粗的蓝色字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号名称，********为用户登录密码，project name为服务的部署区域，获取方法请登录我的凭证获取。

内容审核服务部署的区域必须与调用的服务所在区域一致，本示例中为ap-southeast-1。

{
    "auth": {
        "identity": {
            "methods": [
                "password"
            ],
            "password": {
                "user": {
                    "name": "username",
                    "password": "**********",
                    "domain": {
                        "name": "domainname"
                    }
                }
            }
        },
        "scope": {
            "project": {
                "name": "ap-southeast-1"
            }
        }
    }
}

单击右上角“Send”按钮发送请求。获取返回结果中的Token值（Token有效期为24小时）。

步骤六：调用服务

新建请求，请求方式为修改"POST"，按要求填写URL。
例如护照识别服务部署在“中国-香港”区域，请求URL为“https://ocr.ap-southeast-1.myhuaweicloud.com/v2/{project_id}/ocr/passport”。

选中“Headers”配置项，复制Token值到“X-Auth-Token”。

登录我的凭证，查询隶属于“中国-香港”的项目ID，替换URI中的{project_id}
单击“Body”，将待检测的文本填入到“text”参数中。关于body体中其他参数说明，请参考图像内容审核API。
图2 修改参数
单击右上角“Send”按钮发送请求，查看识别结果。

步骤七：查看调用次数（可选）

内容审核-图像API接口，分析并识别用户上传的图像内容是否有敏感内容（如色情等），并将识别结果返回给用户。

调用内容审核-图像API接口，您可以按照如下步骤操作：

进入内容审核管理控制台。
在左侧导航栏中选择“服务列表>图像审核”，可以查看识别统计详情，如图3所示。您可以设置时间范围，策略（事件类型）来观察这段时间内的调用次数变化情况。

图3 识别统计
- 识别结果统计：显示一段时间范围，内容审核的调用总数，拒绝数，疑似数和通过数，帮助您更好了解服务的调用情况和审核情况。
  - 总数：指的是审核调用总次数。
  - 拒绝数：指的是block总数，即文本中包含敏感信息，审核不通过的次数。
  - 疑似数：指的是review总数，即人工复查审核的次数。
  - 通过数：指的是pass总数，即通过审核的次数。
- 数据趋势：显示您设置的这段时间范围内，总数，拒绝数，疑似数和通过数的变化趋势。
  图4 原因分布
- 拒绝数据原因分布：显示您设置的这段时间范围内，审核不通过的检测场景占比数。
- 疑似数据原因分布：显示您设置的这段时间范围内，需要人工复查的检测场景占比数。
查看监控数据。您可以单击“查看监控指标”在云监控控制台查看服务调用成功和失败的次数等历史数据，如图5所示。

图5 监控数据