简介
内容审核功能是由 数据万象（Cloud Infinite，CI）提供的，数据万象将处理能力与 COS SDK 完全结合，您可以直接按照本篇文档指引进行使用。说明使用内容审核服务需拥有数据万象使用权限：主账号请 单击此处 进行角色授权。子账号请参见 授权子账号接入数据万象服务 文档。本文档提供关于文本审核的 API 概览和 SDK 示例代码。注意 COS Node.js SDK 版本需要大于等于 v2.11.2。
| API | 操作描述 |
| 提交文本审核任务 | 用于提交一个文本审核任务 |
| 查询文本审核任务结果 | 用于查询指定的文本审核任务 |
提交文本审核任务
功能说明
用于提交一个文本审核任务。
请求示例
var config = { // 需要替换成您自己的存储桶信息 Bucket: 'examplebucket-1250000000', /* 存储桶，必须 */ Region: 'COS_REGION', /* 存储桶所在地域，必须字段 */};function postTextAuditing() { var host = config.Bucket + '.ci.' + config.Region + '.myqcloud.com'; var url = 'https://' + host + '/text/auditing'; var body = COS.util.json2xml({ Request: { Input: { Content: Buffer.from('hello').toString('base64'), /* 需要审核的文本内容 */ // Object: 'hello.txt', /* COS 存储桶中的文本文件 */ // Url: 'https://www.test.com/test.txt', /* 文本文件的完整链接 */ }, Conf: { BizType: '', } } }); cos.request({ Bucket: config.Bucket, Region: config.Region, Method: 'POST', Url: url, Key: '/text/auditing', /** 固定值，必须 */ ContentType: 'application/xml', /** 固定值，必须 */ Body: body }, function(err, data){ console.log(err || data); });}
参数说明
Request 中的具体数据描述如下：
| 节点名称（关键字） | 父节点 | 描述 | 类型 | 是否必选 |
| Request | 无 | 文本审核的具体配置项。 | Container | 是 |
Container 类型 Request 的具体数据描述如下：
| 节点名称（关键字） | 父节点 | 描述 | 类型 | 是否必选 |
| Input | Request | 需要审核的内容。 | Container | 是 |
| Conf | Request | 审核规则配置。 | Container | 是 |
Container 类型 Input 的具体数据描述如下：
| 节点名称（关键字） | 父节点 | 描述 | 类型 | 是否必选 |
| Object | Request.Input | 当前 COS 存储桶中的文本文件名称，例如在目录 test 中的文件 img.jpg，则文件名称为 test/img.jpg，文本文件仅支持 UTF8 编码和 GBK 编码的内容，且文件大小不得超过1MB。 | String | 否 |
| Content | Request.Input | 当传入的内容为纯文本信息，需要先经过 base64 编码，文本编码前的原文长度不能超过10000个 UTF8 编码字符。若超出长度限制，接口将会报错。 | String | 否 |
| Url | Request.Input | 文本文件的完整链接，例如：https://www.test.com/test.txt。 |
String | 否 |
注意不可同时输入 Object、Url、Content。当选择 Object 或 Url 时，审核结果为异步返回，可通过 查询文本审核任务结果 API 接口获取返回结果。当选择 Content 时，审核结果为同步返回，可通过查看响应体 TextAuditingResponse 获取返回结果。目前仅支持中文、英文、阿拉伯数字的检测与审核。Container 类型 Conf 的具体数据描述如下：
| 节点名称（关键字） | 父节点 | 描述 | 类型 | 是否必选 |
| Callback | Request.Conf | 审核结果可以回调形式发送至您的回调地址，支持以 http:// 或者 https:// 开头的地址，例如：http://www.callback.com。 |
String | 否 |
| BizType | Request.Conf | 审核策略，不填写则使用默认策略。可在控制台进行配置，详情请参见 设置公共审核策略。 | String | 否 |
返回结果说明
详情请参见 提交文本审核任务。
查询文本审核任务
功能说明
用于查询文本审核任务执行情况和结果。
请求示例
var config = { // 需要替换成您自己的存储桶信息 Bucket: 'examplebucket-1250000000', /* 存储桶，必须 */ Region: 'COS_REGION', /* 存储桶所在地域，必须字段 */};function getTextAuditingResult() { var jobId = 'st8d88c664aff511ecb23352540078cxxx'; // jobId可以通过提交文本审核任务返回（Input传入Object） var host = config.Bucket + '.ci.' + config.Region + '.myqcloud.com'; var url = 'https://' + host + '/text/auditing/' + jobId; cos.request({ Bucket: config.Bucket, Region: config.Region, Method: 'GET', Key: '/text/auditing/' + jobId, Url: url, }, function(err, data){ console.log(err || data); });}
参数说明
| 参数名称 | 描述 | 类型 | 是否必选 |
| jobId | 需要查询的任务 ID。 | String | 是 |
返回结果说明
详情请参见 查询文本审核任务结果。
对象存储官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠
转转请注明出处：https://www.yunxiaoer.com/145903.html
