智能多媒体服务

  • 智能多媒体 > API Reference > Open API >阿里图片广告审核服务

    阿里图片广告审核服务

    最近更新时间:2019-10-23 15:34:36

    图片广告审核(ali_ad)能够有效帮助您检测出您的图片中是否存在违规的风险内容,识别图片中的广告以及文字违规信息。

    本服务由阿里云计算有限公司(以下简称阿里云)提供。启用服务后,您存储在七牛云空间的文件将在您主动请求的情况下被提供给阿里云以供其计算使用。七牛不能保证鉴别结果的正确性,请您自行评估后选择是否启用。服务价格请您参考具体的服务价格,您使用本服务产生的费用由七牛代收。启用服务则表示您知晓并同意以上内容。

    注意

    • 单张图片大小不超过 10MB。
    • 资源的 Mime 文件格式仅支持图片类型:image/*,如:image/jpeg、image/png。
    • 请求接口的并发(qps)不超过100。
    • 请求接口为标准的HTTP/HTTPS 协议。

    如何开启

    进入七牛开发者平台第三方数据处理,找到 阿里图片广告审核 点击并开始使用。

    请求

    请求语法

    GET <scanRquestUrl>?ali_ad
    Host: <BucketHost>
    

    请求参数

    字段 类型 是否必选 说明
    scanRquestUrl string N 用于检测广告的图片链接

    响应

    响应语法

    HTTP/1.1 200 OK
    X-Reqid: <reqid>
    Date: <respTime>
    Content-Length: <contentLength>
    Content-Type: text/plain; charset=utf-8
    {
        // respDate
    }
    

    示例

    在Web浏览器中输入以下视频地址:

    http://7xlv47.com0.z0.glb.clouddn.com/upload.jpg?ali_ad
    
    

    返回结果

    HTTP/1.1 200 OK
    X-Reqid: _YEBAICNYlSPpbQV
    Date: Thu, 25 Jul 2019 12:16:45 GMT
    Content-Length: 266
    Content-Type: application/json; charset=utf-8
    {
        "code": 200,
        "data": [
            {
                "code": 200,
                "msg": "OK",
                "results": [
                    {
                        "label": "normal",
                        "rate": 99.91,
                        "scene": "ad",
                        "suggestion": "pass"
                    }
                ],
                "taskId": "txt4CP9r0g5XdV74qlfLV6gNO-1r7hCy"
            }
        ],
        "msg": "OK",
        "requestId": "D10CC413-03E1-44E1-B1C9-D1CC49D8FD78"
    }
    

    公共头响应头参数说明

    字段 类型 是否必选 说明
    code 整型 Y 错误码,和HTTP状态码一致(但有扩展)。
    • 2xx 表示成功。
    • 4xx 表示请求有误。
    • 5xx 表示后端有误。
    具体参照公共错误码说明
    msg 字符串 Y 错误的进一步描述。
    requestId 字符串 Y 唯一标识该请求的ID,可用于定位问题。
    data JSON对象 Y API(业务)相关的返回数据。出错情况下,该字段可能为空。一般来说,该字段为一个JSON结构体或数组,参见下表

    响应返回的data参数说明

    字段 类型 是否必选 说明
    code 整型 Y 错误码,和HTTP的status code一致。
    msg 字符串 Y 错误的进一步描述。
    taskId 字符串 Y 该检测任务的ID。
    results JSON数组 N 返回结果。调用成功时(code=200),返回结果中包含一个或多个元素。每个元素是个结构体,具体结构描述见result结构表。

    响应返回的results中JSON对象结构说明

    字段 类型 是否必选 说明
    label 字符串 Y 检测结果的分类,与具体的scene对应。取值范围参考scene和label说明。
    scene 字符串 Y 检测场景,和调用请求中的场景对应(ad)。
    suggestion 字符串 Y 建议的结果,取值范围:
    • pass:正常
    • review:疑似违规
    • block:确认违规
    rate 浮点数 Y 结果为该分类的概率,取值范围为[0.00-100.00]。值越高,表示越有可能属于该分类。 说明 分值仅供参考,建议关注label和suggestion内容。

    detail结构体说明

    字段 类型 是否必选 说明
    label 字符串 Y 图片的分类,与具体的scene对应。取值范围参考scene和label说明。
    contexts 数组 N 命中该风险的上下文信息。具体结构描述见context说明。

    scene和label说明

    功能 scene label
    图片广告检测 ad • normal:正常图片
    • politics:文字含涉政内容
    • porn:文字含涉黄内容
    • abuse:文字含辱骂内容
    • terrorism:文字含暴恐内容
    • contraband:文字含违禁内容
    • spam:文字含其他垃圾内容
    • npx:牛皮藓广告
    • qrcode:包含二维码
    • programCode:包含小程序码
    • ad:其他广告

    服务价格

    1元/千次

    计费示例

    某公司2019年5月使用该服务,共发起10万次请求,则当月使用该服务的费用为100*1=100.0元

    以上内容是否对您有帮助?
  • Icon helper
    Icon free helper
    Close