如何使用PHP SDK视频审核接口_内容安全(Content Moderation)-阿里云帮助中心

本文介绍了如何使用PHP SDK视频审核接口，检测视频中是否包含风险内容。

功能描述

视频审核接口支持同步检测和异步检测两种方式。

同步检测只支持传递视频的截帧图片序列。关于参数的详细介绍，请参见同步检测。
（推荐）异步检测支持对原始视频或视频的截帧图片序列进行检测。关于参数的详细介绍，请参见异步检测。

前提条件

已安装PHP依赖。关于安装PHP依赖的具体操作，请参见安装PHP依赖。

说明

请一定按照安装PHP依赖页面中的版本安装，否则会导致调用失败。

（推荐）提交视频异步检测任务

接口	描述	支持的地域
VideoAsyncScanRequest	提交视频异步检测任务，对视频进行多个风险场景的识别，包括色情、暴恐涉政、广告、不良场景、Logo（商标台标）识别。	cn-shanghai：华东2（上海） cn-beijing：华北2（北京） cn-shenzhen：华南1（深圳） ap-southeast-1：新加坡

示例代码

<?php

use AlibabaCloud\Client\AlibabaCloud;
use AlibabaCloud\Client\Exception\ClientException;
use AlibabaCloud\Client\Exception\ServerException;
use AlibabaCloud\Green\Green;

try {
    /**
     * 注意：此处实例化的client尽可能重复使用，提升检测性能。避免重复建立连接。
     * 常见获取环境变量方式：
     * 获取RAM用户AccessKey ID：getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
     * 获取RAM用户AccessKey Secret：getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
     */
    AlibabaCloud::accessKeyClient('建议从环境变量中获取RAM用户AccessKey ID', '建议从环境变量中获取RAM用户AccessKey Secret')
        ->timeout(10) // 超时10秒，使用该客户端且没有单独设置的请求都使用此设置。
        ->connectTimeout(3) // 连接超时3秒，当单位小于1，则自动转换为毫秒，使用该客户端且没有单独设置的请求都使用此设置。
        ->regionId('cn-shanghai')
        ->asDefaultClient();
    
    $task1 = array('dataId' => '业务数据ID',
        'url' => '待检测视频链接地址',
    );

    // scenes：检测场景，支持指定多个场景。
    // callback、seed：用于回调通知，可选参数。
    $result = Green::v20180509()->videoAsyncScan()
        ->timeout(10) // 超时10秒，request超时设置，仅对当前请求有效。
        ->connectTimeout(3) // 连接超时3秒，当单位小于1，则自动转换为毫秒，request超时设置，仅对当前请求有效。
        ->body(json_encode(array("tasks" => array($task1),
            "scenes" => array("porn", "terrorism"),
            'callback' => '回调地址',
            'seed' => '随机字符串')))
        ->request();
    print_r($result->toArray());
} catch (ClientException $exception) {
    echo $exception->getMessage() . PHP_EOL;
} catch (ServerException $exception) {
    echo $exception->getMessage() . PHP_EOL;
    echo $exception->getErrorCode() . PHP_EOL;
    echo $exception->getRequestId() . PHP_EOL;
    echo $exception->getErrorMessage() . PHP_EOL;
}

查询视频异步检测结果

接口	描述	支持的地域
VideoAsyncScanResultsRequest	查询视频异步检测任务的结果。说明该方法需要轮询结果，建议使用callback的方式获取结果。	cn-shanghai：华东2（上海） cn-beijing：华北2（北京） cn-shenzhen：华南1（深圳） ap-southeast-1：新加坡

示例代码

<?php

use AlibabaCloud\Client\AlibabaCloud;
use AlibabaCloud\Client\Exception\ClientException;
use AlibabaCloud\Client\Exception\ServerException;
use AlibabaCloud\Green\Green;

try {
    /**
     * 注意：此处实例化的client尽可能重复使用，提升检测性能。避免重复建立连接。
     * 常见获取环境变量方式：
     * 获取RAM用户AccessKey ID：getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
     * 获取RAM用户AccessKey Secret：getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
     */
    AlibabaCloud::accessKeyClient('建议从环境变量中获取RAM用户AccessKey ID', '建议从环境变量中获取RAM用户AccessKey Secret')
        ->timeout(10) // 超时10秒，使用该客户端且没有单独设置的请求都使用此设置。
        ->connectTimeout(3) // 连接超时3秒，当单位小于1，则自动转换为毫秒，使用该客户端且没有单独设置的请求都使用此设置。
        ->regionId('cn-shanghai')
        ->asDefaultClient();

    $result = Green::v20180509()->videoAsyncScanResults()
        ->timeout(10) // 超时10秒，request超时设置，仅对当前请求有效。
        ->connectTimeout(3) // 连接超时3秒，当单位小于1，则自动转换为毫秒，request超时设置，仅对当前请求有效。
        ->body(json_encode(array('视频检测任务ID')))
        ->request();
    print_r($result->toArray());
} catch (ClientException $exception) {
    echo $exception->getMessage() . PHP_EOL;
} catch (ServerException $exception) {
    echo $exception->getMessage() . PHP_EOL;
    echo $exception->getErrorCode() . PHP_EOL;
    echo $exception->getRequestId() . PHP_EOL;
    echo $exception->getErrorMessage() . PHP_EOL;
}

视频截帧同步检测

接口	描述	支持的地域
VideoSyncScanRequest	提交视频同步检测任务，同步检测视频中的风险内容。说明同步检测只支持传递视频帧序列，不支持检测视频文件，推荐使用异步检测接口。	cn-shanghai：华东2（上海） cn-beijing：华北2（北京） cn-shenzhen：华南1（深圳） ap-southeast-1：新加坡

示例代码

<?php

use AlibabaCloud\Client\AlibabaCloud;
use AlibabaCloud\Client\Exception\ClientException;
use AlibabaCloud\Client\Exception\ServerException;
use AlibabaCloud\Green\Green;

try {
    /**
     * 注意：此处实例化的client尽可能重复使用，提升检测性能。避免重复建立连接。
     * 常见获取环境变量方式：
     * 获取RAM用户AccessKey ID：getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
     * 获取RAM用户AccessKey Secret：getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
     */
    AlibabaCloud::accessKeyClient('建议从环境变量中获取RAM用户AccessKey ID', '建议从环境变量中获取RAM用户AccessKey Secret')
        ->timeout(10) // 超时10秒，使用该客户端且没有单独设置的请求都使用此设置。
        ->connectTimeout(3) // 连接超时3秒，当单位小于1，则自动转换为毫秒，使用该客户端且没有单独设置的请求都使用此设置。。
        ->regionId('cn-shanghai')
        ->asDefaultClient();


    $task1 = array('frames' => array(['offset' => '0', 'url' => '视频截帧链接地址1'],
        ['offset' => '1', 'url' => '视频截帧链接地址2'],
        ['offset' => '2', 'url' => '视频截帧链接地址3']));

    // scenes：检测场景，支持指定多个场景。
    $result = Green::v20180509()->videoSyncScan()
        ->timeout(10) // 超时10秒，request超时设置，仅对当前请求有效。
        ->connectTimeout(3) // 连接超时3秒，当单位小于1，则自动转换为毫秒，request超时设置，仅对当前请求有效
        ->body(json_encode(array('tasks' => array($task1),
            'scenes' => array('porn', 'terrorism'),
            'bizType' => '业务场景')))
        ->request();
    print_r($result->toArray());
} catch (ClientException $exception) {
    echo $exception->getMessage() . PHP_EOL;
} catch (ServerException $exception) {
    echo $exception->getMessage() . PHP_EOL;
    echo $exception->getErrorCode() . PHP_EOL;
    echo $exception->getRequestId() . PHP_EOL;
    echo $exception->getErrorMessage() . PHP_EOL;
}

视频检测结果反馈

如果您认为视频检测结果与您的预期不符，可以通过视频检测结果反馈接口，对检测结果进行纠正（系统会根据您反馈的结果，将视频截帧添加到相似图片的黑名单库或者白名单库）。当您再次提交相似的内容进行检测时，以您反馈的label返回结果。

关于接口的说明，请参见检测结果反馈。

接口	描述	支持的Region
VideoFeedbackRequest	提交视频检测结果的反馈，以人工反馈的检测结果纠正算法检测结果。	cn-shanghai：华东2（上海） cn-beijing：华北2（北京） cn-shenzhen：华南1（深圳） ap-southeast-1：新加坡

示例代码

<?php

use AlibabaCloud\Client\AlibabaCloud;
use AlibabaCloud\Client\Exception\ClientException;
use AlibabaCloud\Client\Exception\ServerException;
use AlibabaCloud\Green\Green;

try {
    /**
     * 注意：此处实例化的client尽可能重复使用，提升检测性能。避免重复建立连接。
     * 常见获取环境变量方式：
     * 获取RAM用户AccessKey ID：getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
     * 获取RAM用户AccessKey Secret：getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
     */
    AlibabaCloud::accessKeyClient('建议从环境变量中获取RAM用户AccessKey ID', '建议从环境变量中获取RAM用户AccessKey Secret')
        ->timeout(10) // 超时10秒，使用该客户端且没有单独设置的请求都使用此设置。
        ->connectTimeout(3) // 连接超时3秒，当单位小于1，则自动转换为毫秒，使用该客户端且没有单独设置的请求都使用此设置。
        ->regionId('cn-shanghai')
        ->asDefaultClient();

    // scenes：检测场景，支持指定多个场景。
    // suggestion：期望的检测结果；pass：正常；block：违规。
    $task1 = array("taskId" => '视频检测任务ID',
        "dataId" => "业务数据ID",
        "url" => "视频链接地址",
        "frames" => array(array("url" => "视频截帧图片链接地址_1", "offset" => "100"), array("url" => "视频截帧图片链接地址_2", "offset" => "200")),
        "suggestion" => 'block',
        "scenes" => array("ad", "terrorism"),
        "note" => "备注信息");

    $result = Green::v20180509()->videoFeedback()
        ->timeout(10) // 超时10秒，request超时设置，仅对当前请求有效。
        ->connectTimeout(3) // 连接超时3秒，当单位小于1，则自动转换为毫秒，request超时设置，仅对当前请求有效。
        ->body(json_encode($task1))
        ->request();
    print_r($result->toArray());
} catch (ClientException $exception) {
    echo $exception->getMessage() . PHP_EOL;
} catch (ServerException $exception) {
    echo $exception->getMessage() . PHP_EOL;
    echo $exception->getErrorCode() . PHP_EOL;
    echo $exception->getRequestId() . PHP_EOL;
    echo $exception->getErrorMessage() . PHP_EOL;
}