使用PHP SDK文本反垃圾接口对文本内容进行色情、暴恐、涉政等风险进行识别。

说明 目前仅支持同步检测。一次请求可以检测多条文本,也可以检测单条文本;按实际检测的文本条数进行计费,具体请参考计费说明

准备工作

在进行具体的服务调用之前,请参考以下步骤,完成准备工作:
  1. 创建阿里云AccessKeyId和AccessKeySecret。具体请参考创建AccessKey
  2. 安装PHP依赖。具体请参考安装PHP依赖

文本内容检测

文本垃圾检测支持自定义关键词,例如添加一些竞品关键词等。如果被检测的文本中包含您添加的关键词,算法会返回您suggestion=block。

您可以前往云盾内容安全控制台添加关键词,也可以通过API接口添加关键词。关键词编码请使用UTF-8,接口说明请参考文本反垃圾API文档

接口描述
接口 功能 支持的Region 描述
TextScanRequest 文本扫描接口 cn-shanghaicn-beijing 检测场景传递antispam(scene=antispam) 。
示例代码
<?php

include_once 'aliyuncs/aliyun-php-sdk-core/Config.php';
use Green\Request\V20180509 as Green;

$iClientProfile = DefaultProfile::getProfile("cn-shanghai", "您自己的AccessKeyId", "您自己的AccessKeySecret");
DefaultProfile::addEndpoint("cn-shanghai", "cn-shanghai", "Green", "green.cn-shanghai.aliyuncs.com");
$client = new DefaultAcsClient($iClientProfile);
$request = new Green\TextScanRequest();
$request->setMethod("POST");
$request->setAcceptFormat("JSON");
$task1 = array('dataId' =>  uniqid(),
    'content' => '需要检测的文本内容'
);

/**
 * 文本垃圾检测: antispam
 **/
$request->setContent(json_encode(array("tasks" => array($task1),
    "scenes" => array("antispam"))));
try {
    $response = $client->getAcsResponse($request);
    print_r($response);
    if(200 == $response->code){
        $taskResults = $response->data;
        foreach ($taskResults as $taskResult) {
            if(200 == $taskResult->code){
                $sceneResults = $taskResult->results;
                foreach ($sceneResults as $sceneResult) {
                    $scene = $sceneResult->scene;
                    $suggestion = $sceneResult->suggestion;
                    //根据scene和suggetion做相关处理
                    //do something
                }
            }else{
                print_r("task process fail:" + $response->code);
            }
        }
    }else{
        print_r("detect not success. code:" + $response->code);
    }
} catch (Exception $e) {
    print_r($e);
}

文本反垃圾结果反馈

如果您认为我们的文本检测结果与您的期望不符,您可以通过文本垃圾结果反馈接口纠正算法检测结果。

系统会将您反馈的结果添加进相似文本黑库或相似文本白库,在您下次提交相似的内容进行检测时,以您通过反馈接口传递的label作为结果返回。具体接口说明请参考文本反垃圾结果反馈API文档

接口描述
接口 功能 支持的Region 描述
TextFeedbackRequest 文本反垃圾结果反馈。 cn-shanghaicn-beijing 通过反馈检测的结果将原有检测结果进行纠正。
示例代码
<?php

include_once 'aliyuncs/aliyun-php-sdk-core/Config.php';
use Green\Request\V20180509 as Green;

$iClientProfile = DefaultProfile::getProfile("cn-shanghai", "您自己的AccessKeyId", "您自己的AccessKeySecret");
DefaultProfile::addEndpoint("cn-shanghai", "cn-shanghai", "Green", "green.cn-shanghai.aliyuncs.com");
$client = new DefaultAcsClient($iClientProfile);
$request = new Green\TextFeedbackRequest();
$request->setMethod("POST");
$request->setAcceptFormat("JSON");
$task1 = array('dataId' =>  uniqid(),
    'content' => '需要检测的文本内容'
);

/**
 * 文本垃圾检测: antispam
 **/
$request->setContent(json_encode(array("taskId" => 'test taskId',  "content" => "需要检测的文本内容",
    "label" => 'spam')));
try {
    $response = $client->getAcsResponse($request);
    print_r($response);
} catch (Exception $e) {
    print_r($e);
}