tencent cloud

文档反馈

文本审核

最后更新时间:2024-03-13 15:17:11

    简介

    内容审核功能是由 数据万象(Cloud Infinite,CI)提供的,数据万象将处理能力与 COS SDK 完全结合,您可以直接按照本篇文档指引进行使用。
    说明:
    使用内容审核服务需拥有数据万象使用权限:
    主账号请 单击此处 进行角色授权。
    子账号请参见 授权子账号接入数据万象服务 文档。
    本文档提供关于文本审核接口的 API 概览以及 SDK 示例代码。
    API
    操作名
    操作描述
    提交文本审核任务
    用于提交文本审核任务
    查询文本审核任务结果
    用于查询文本审核任务结果

    SDK API 参考

    SDK 所有接口的具体参数与方法说明,请参考 SDK API 参考

    提交文本审核任务

    功能说明

    用于提交文本审核任务。
    注意:
    COS Android SDK 版本需要大于等于 v5.8.7。

    示例代码

    // 存储桶名称,格式为 BucketName-APPID
    String bucket = "examplebucket-1250000000";
    // 对象键,是对象在 COS 上的完整路径,如果带目录的话,格式为 "dir1/object1"
    String cosPath = "dir1/exampleobject.txt";
    //文本的链接地址,Object 和 Url 只能选择其中一种
    String url = "https://myqcloud.com/%205text.txt";
    //当传入的内容为纯文本信息,需要先经过 base64 编码,文本编码前的原文长度不能超过10000个 utf8 编码字符。若超出长度限制,接口将会报错。
    String content = Base64.encodeToString("测试文本".getBytes(Charset.forName("UTF-8")), Base64.NO_WRAP);
    PostTextAuditRequest request = new PostTextAuditRequest(bucket);
    request.setObject(cosPath);
    request.setUrl(url);
    request.setContent(content);
    //设置原始内容,长度限制为512字节,该字段会在响应中原样返回
    request.setDataId("DataId");
    //回调地址,以http://或者https://开头的地址。
    request.setCallback("https://github.com");
    //回调内容的结构,有效值:Simple(回调内容包含基本信息)、Detail(回调内容包含详细信息)。默认为 Simple。
    request.setCallbackVersion("Detail");
    //审核的场景类型,有效值:Porn(涉黄)、Ads(广告),可以传入多种类型,不同类型以逗号分隔,例如:Porn,Ads。
    request.setDetectType("Porn,Ads");
    
    // CIService 是 CosXmlService 的子类,初始化方法和 CosXmlService 一致
    ciService.postTextAuditAsync(request, new CosXmlResultListener() {
    @Override
    public void onSuccess(CosXmlRequest request, CosXmlResult cosResult) {
    // result 提交文本审核任务的结果
    // 详细字段请查看api文档或者SDK源码
    TextAuditResult result = (TextAuditResult) cosResult;
    }
    
    @Override
    public void onFail(CosXmlRequest request, CosXmlClientException clientException, CosXmlServiceException serviceException) {
    if (clientException != null) {
    clientException.printStackTrace();
    } else {
    serviceException.printStackTrace();
    }
    }
    });
    说明:
    更多完整示例,请前往 GitHub 查看。

    查询文本审核任务结果

    功能说明

    用于查询文本审核任务结果。
    注意:
    COS Android SDK 版本需要大于等于 v5.8.7。

    示例代码

    // 存储桶名称,格式为 BucketName-APPID
    String bucket = "examplebucket-1250000000";
    // 审核任务的 ID
    String jobId = "iab1ca9fc8a3ed11ea834c525400863904";
    GetTextAuditRequest request = new GetTextAuditRequest(bucket, jobId);
    // CIService 是 CosXmlService 的子类,初始化方法和 CosXmlService 一致
    ciService.getTextAuditAsync(request, new CosXmlResultListener() {
    @Override
    public void onSuccess(CosXmlRequest request, CosXmlResult cosResult) {
    // result 查询文本审核任务的结果
    // 详细字段请查看api文档或者SDK源码
    TextAuditResult result = (TextAuditResult) cosResult;
    }
    
    @Override
    public void onFail(CosXmlRequest request, CosXmlClientException clientException, CosXmlServiceException serviceException) {
    if (clientException != null) {
    clientException.printStackTrace();
    } else {
    serviceException.printStackTrace();
    }
    }
    });
    说明:
    更多完整示例,请前往 GitHub 查看。
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持