'1.0', 'info' => [ 'style' => 'RPC', 'product' => 'imageaudit', 'version' => '2019-12-30', ], 'directories' => [ [ 'id' => 64301, 'title' => '内容审核', 'type' => 'directory', 'children' => [ 'ScanImage', 'ScanText', ], ], ], 'components' => [ 'schemas' => [], ], 'apis' => [ 'ScanImage' => [ 'summary' => '本文介绍图片内容安全ScanImage的语法及示例。', 'methods' => [ 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'paid', ], 'parameters' => [ [ 'name' => 'Task', 'in' => 'formData', 'style' => 'repeatList', 'schema' => [ 'description' => '1', 'type' => 'array', 'items' => [ 'description' => '1', 'type' => 'object', 'properties' => [ 'ImageTimeMillisecond' => [ 'description' => '图片创建或编辑时间，单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1', ], 'Interval' => [ 'description' => '截帧频率，GIF图或者长图检测专用。GIF图可理解为图片数组，每**interval**张图片抽取一张进行检测。只有该值存在时，才会对GIF进行截帧。长图同时支持长竖图和长横图。'."\n" ."\n" .'- 长竖图（高大于400像素，高宽比大于2.5），会按照`高/宽`取整来计算总图数，并进行切割。'."\n" ."\n" .'- 长横图（宽大于400像素，宽高比大于2.5），会按照`宽/高`取整来计算总图数，并进行切割。'."\n" ."\n" .'> 默认只会检测GIF图或长图的第一帧，interval参数用于指示后台在检测时可按照该间隔跳着检测，以节省检测成本。需要与maxFrames参数组合使用。例如，设置interval为2，maxFrames为100，检测长图或GIF图时，将每间隔1帧检测一次，最多检测100帧，计费则按照实际检测的数量计算。'."\n", 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1', ], 'ImageURL' => [ 'description' => '待检测图像的URL地址。支持HTTP和HTTPS协议。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" ."\n" .'> 如果使用上海地域的OSS链接，系统会自动将OSS链接地址转成内网地址然后再下载文件，所以调用该接口并不会产生OSS流量计费。', 'type' => 'string', 'required' => true, 'example' => 'http://xxx.xxx.com/xxx.jpg', 'isFileTransferUrl' => true, ], 'MaxFrames' => [ 'description' => '最大截帧数量，GIF图或长图检测专用，默认值为1。'."\n" .'当interval*maxFrames小于该图片所包含的图片数量时，截帧间隔会自动修改为`该图片所包含的图片数/maxFrames`，以提高整体检测效果。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1', ], 'DataId' => [ 'description' => '数据ID。需要保证在一次请求中所有的ID不重复。', 'type' => 'string', 'required' => false, 'example' => 'uuid-xxxx-xxxx-1234', ], ], 'required' => false, ], 'required' => true, 'maxItems' => 10, ], ], [ 'name' => 'Scene', 'in' => 'formData', 'style' => 'repeatList', 'schema' => [ 'description' => '1', 'type' => 'array', 'items' => [ 'description' => '指定图片检测的应用场景，可选值包括：'."\n" ."\n" .'- porn：图片智能鉴黄'."\n" ."\n" .'- terrorism：图片敏感内容识别、图片风险人物识别'."\n" ."\n" .'- ad：图片垃圾广告识别'."\n" ."\n" .'- live：图片不良场景识别'."\n" ."\n" .'- logo：图片Logo识别'."\n" ."\n" .'> 支持多场景（scenes）一起检测。例如`scenes=[“porn”, “terrorism”]`，即对一张图片同时进行鉴黄和涉恐识别，此时也会按照两个场景计费。', 'type' => 'string', 'required' => false, 'example' => 'porn', ], 'required' => true, 'example' => 'porn', 'maxItems' => 6, ], ], ], 'responses' => [ 200 => [ 'headers' => [], 'schema' => [ 'description' => '1', 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => '69B41AE8-1234-1234-1234-12D395695D2D', ], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ 'Results' => [ 'description' => '图片检测结果。', 'type' => 'array', 'items' => [ 'description' => '1', 'type' => 'object', 'properties' => [ 'ImageURL' => [ 'description' => '图像URL地址。', 'type' => 'string', 'example' => 'http://xxx.xxx.xxx/xxx.jpg', ], 'DataId' => [ 'description' => '数据ID。', 'type' => 'string', 'example' => 'uuid-xxxx-xxx-1234', ], 'SubResults' => [ 'description' => '单张图片的检测结果。', 'type' => 'array', 'items' => [ 'description' => '1', 'type' => 'object', 'properties' => [ 'SfaceDataList' => [ 'description' => '图片中包含暴恐敏感内容时，返回识别出来的暴恐敏感信息。'."\n" ."\n" .'> 仅适用于terrorism和sface场景。关于该参数在sface场景中的具体内容，请参见敏感人脸检测。', 'type' => 'array', 'items' => [ 'description' => '1', 'type' => 'object', 'properties' => [ 'Width' => [ 'description' => '人脸区域宽度。', 'type' => 'number', 'format' => 'float', 'example' => '97', ], 'Faces' => [ 'description' => '识别出的人脸信息。', 'type' => 'array', 'items' => [ 'description' => '1', 'type' => 'object', 'properties' => [ 'Name' => [ 'description' => '相似人物的名称。', 'type' => 'string', 'example' => 'abc', ], 'Id' => [ 'description' => '人脸ID。', 'type' => 'string', 'example' => 'AliFace_0001234', ], 'Rate' => [ 'description' => '相似概率。', 'type' => 'number', 'format' => 'float', 'example' => '91.54', ], ], ], ], 'Height' => [ 'description' => '人脸区域高度。', 'type' => 'number', 'format' => 'float', 'example' => '131', ], 'Y' => [ 'description' => '以图片左上角为坐标原点，人脸区域左上角到x轴距离。', 'type' => 'number', 'format' => 'float', 'example' => '39', ], 'X' => [ 'description' => '以图片左上角为坐标原点，人脸区域左上角到y轴距离。', 'type' => 'number', 'format' => 'float', 'example' => '49', ], ], ], ], 'HintWordsInfoList' => [ 'description' => '图片中含有广告时，返回图片中广告文字命中的风险关键词信息。格式为数组。'."\n" ."\n" .'> 仅适用于ad场景。示例值：`”hintWordsInfo”:[{“context”:”敏感词”}]`。', 'type' => 'array', 'items' => [ 'description' => '1', 'type' => 'object', 'properties' => [ 'Context' => [ 'description' => '图片中文字命中的风险关键词内容。', 'type' => 'string', 'example' => 'abc', ], ], ], ], 'Suggestion' => [ 'description' => '建议您执行的操作。'."\n" ."\n" .'- pass：图片正常，无需进行其余操作；或者未识别出目标对象。'."\n" ."\n" .'- review：检测结果不确定，需要进行人工审核；或者未识别出目标对象。'."\n" ."\n" .'- block：图片违规，建议执行进一步操作（如直接删除或做限制处理）。', 'type' => 'string', 'example' => 'block', ], 'ProgramCodeDataList' => [ 'description' => '图片中含有小程序码时，返回小程序码的位置信息。'."\n" ."\n" .'> 仅适用于qrcode场景，且已通过钉钉群（23109592）联系我们开通了小程序码识别。', 'type' => 'array', 'items' => [ 'description' => '1', 'type' => 'object', 'properties' => [ 'Width' => [ 'description' => '小程序码区域宽度。', 'type' => 'number', 'format' => 'float', 'example' => '402.0', ], 'Height' => [ 'description' => '小程序码区域高度。', 'type' => 'number', 'format' => 'float', 'example' => '413.0', ], 'Y' => [ 'description' => '以图片左上角为坐标原点，小程序码区域左上角到x轴距离。', 'type' => 'number', 'format' => 'float', 'example' => '0.0', ], 'X' => [ 'description' => '以图片左上角为坐标原点，小程序码区域左上角到y轴距离。', 'type' => 'number', 'format' => 'float', 'example' => '11.0', ], ], ], ], 'OCRDataList' => [ 'description' => '1', 'type' => 'array', 'items' => [ 'description' => '识别到的图片中的完整文字信息。', 'type' => 'string', 'example' => 'abc', ], ], 'Frames' => [ 'description' => '如果待检测图片因为过长被截断，该参数返回截断后的每一帧图像的临时访问地址供您参考。', 'type' => 'array', 'items' => [ 'description' => '1', 'type' => 'object', 'properties' => [ 'URL' => [ 'description' => '被截断的图片的临时访问URL，地址有效期是5分钟。', 'type' => 'string', 'example' => 'http://xxx.xxx.com/xxx-0.jpg', ], 'Rate' => [ 'description' => '结果为该分类的概率，取值范围为0~100。值越高，表示越有可能属于该分类。', 'type' => 'number', 'format' => 'float', 'example' => '89.85', ], ], ], ], 'LogoDataList' => [ 'description' => '图片中含有Logo时，返回识别出来的Logo信息。'."\n" ."\n" .'> 仅适用于Logo场景。', 'type' => 'array', 'items' => [ 'description' => '1', 'type' => 'object', 'properties' => [ 'Type' => [ 'description' => '识别出的logo类型，取值为TV（台标）。', 'type' => 'string', 'example' => 'TV', ], 'Width' => [ 'description' => 'Logo区域宽度。', 'type' => 'number', 'format' => 'float', 'example' => '106', ], 'Height' => [ 'description' => 'Logo区域高度。', 'type' => 'number', 'format' => 'float', 'example' => '106', ], 'Y' => [ 'description' => '以图片左上角为坐标原点，Logo区域左上角到x轴距离。', 'type' => 'number', 'format' => 'float', 'example' => '68', ], 'Name' => [ 'description' => '识别出的Logo名称。', 'type' => 'string', 'example' => 'abc', ], 'X' => [ 'description' => '以图片左上角为坐标原点，Logo区域左上角到y轴距离。', 'type' => 'number', 'format' => 'float', 'example' => '140', ], ], ], ], 'Label' => [ 'description' => '检测结果的分类，与具体的scene对应。取值范围参见scene和label对应关系说明。', 'type' => 'string', 'example' => 'normal', ], 'Scene' => [ 'description' => '图片检测场景，和调用请求中的场景（scenes）对应。', 'type' => 'string', 'example' => 'ad', ], 'Rate' => [ 'description' => '结果为该分类的概率，取值范围为0~100。值越高，表示越有可能属于该分类。', 'type' => 'number', 'format' => 'float', 'example' => '99.91', ], ], ], ], 'TaskId' => [ 'description' => '任务ID。', 'type' => 'string', 'example' => 'img4wlJcb7p4wH4lAP3111111-123456', ], ], ], ], ], ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"69B41AE8-1234-1234-1234-12D395695D2D\\",\\n \\"Data\\": {\\n \\"Results\\": [\\n {\\n \\"ImageURL\\": \\"http://xxx.xxx.xxx/xxx.jpg\\",\\n \\"DataId\\": \\"uuid-xxxx-xxx-1234\\",\\n \\"SubResults\\": [\\n {\\n \\"SfaceDataList\\": [\\n {\\n \\"Width\\": 97,\\n \\"Faces\\": [\\n {\\n \\"Name\\": \\"abc\\",\\n \\"Id\\": \\"AliFace_0001234\\",\\n \\"Rate\\": 91.54\\n }\\n ],\\n \\"Height\\": 131,\\n \\"Y\\": 39,\\n \\"X\\": 49\\n }\\n ],\\n \\"HintWordsInfoList\\": [\\n {\\n \\"Context\\": \\"abc\\"\\n }\\n ],\\n \\"Suggestion\\": \\"block\\",\\n \\"ProgramCodeDataList\\": [\\n {\\n \\"Width\\": 402,\\n \\"Height\\": 413,\\n \\"Y\\": 0,\\n \\"X\\": 11\\n }\\n ],\\n \\"OCRDataList\\": [\\n \\"abc\\"\\n ],\\n \\"Frames\\": [\\n {\\n \\"URL\\": \\"http://xxx.xxx.com/xxx-0.jpg\\",\\n \\"Rate\\": 89.85\\n }\\n ],\\n \\"LogoDataList\\": [\\n {\\n \\"Type\\": \\"TV\\",\\n \\"Width\\": 106,\\n \\"Height\\": 106,\\n \\"Y\\": 68,\\n \\"Name\\": \\"abc\\",\\n \\"X\\": 140\\n }\\n ],\\n \\"Label\\": \\"normal\\",\\n \\"Scene\\": \\"ad\\",\\n \\"Rate\\": 99.91\\n }\\n ],\\n \\"TaskId\\": \\"img4wlJcb7p4wH4lAP3111111-123456\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n \\n 200\\n OK\\n uuid-xxxx-xxx-1234\\n \\n 99.63\\n block\\n sexy\\n porn\\n \\n \\n politics\\n 91.54\\n terrorism\\n \\n \\n AliFace_0001234\\n 命中人名\\n 91.54\\n \\n 131\\n 97\\n 49\\n 39\\n \\n block\\n \\n \\n \\n 402\\n 413\\n 11\\n 0\\n \\n \\n 89.85\\n http://xxx.xxx.com/xxx-0.jpg\\n \\n \\n 68.06\\n http://xxx.xxx.com/xxx-1.jpg\\n \\n 99.91\\n block\\n ad\\n ad\\n \\n \\n 99.91\\n block\\n drug\\n live\\n \\n \\n \\n xxx台\\n TV\\n 140\\n 68\\n 106\\n 106\\n \\n 99.9\\n block\\n TV\\n logo\\n \\n img4wlJcb7p4wH4lAP3111111-123456\\n http://xxx.xxx.xxx/xxx.jpg\\n \\n\\n69B41AE8-1234-1234-1234-12D395695D2D","errorExample":""}]', 'title' => '图片内容安全', 'description' => '## 功能描述'."\n" .'图片内容安全结合行为、内容，采用多维度、多模型、多检测手段，识别图片中的敏感信息，规避图片中存在敏感人物照片、敏感事件等内容风险。'."\n" .'支持检测的场景包括：图片智能鉴黄、图片敏感内容识别、图片风险人物识别、图片垃圾广告识别、图片不良场景识别、图片Logo识别。'."\n" .'在提交检测任务时，您需要指定scenes参数，并且支持组合使用，即可对同一张图片的多种风险进行检测。'."\n" ."\n" .'> - 在同时检测多个scene的情况下，将按照每个场景的检测图片数量×每个场景的单价进行累加计费。而在检测返回结果中，则包含了您指定的scenes对应的label。您可以根据参数的返回值判断风险的具体类型。然后对图片进行处理。'."\n" .'- 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n\n" .'在图片审核中，scene与label的对应关系如下： '."\n" .'| scene | 描述 | label |'."\n" .'| --------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |'."\n" .'| porn | 图片智能鉴黄：适用于图片涉及色情、低俗内容检测。 | normal（正常图片）、sexy（性感图片）、porn（色情图片） |'."\n" .'| terrorism | 图片敏感内容识别：适用于图片涉及敏感事件、暴力、武器、恐怖、血腥、爆炸等内容识别。
图片风险人物识别：适用于图片涉及敏感人物、明星的识别。 | normal（正常图片）、bloody（血腥）、explosion（爆炸烟光）、outfit（特殊装束）、logo（特殊标识）、weapon（武器）、politics（敏感内容）、violence（打斗）、crowd（聚众）、parade（游行）、carcrash（车祸现场）、flag（旗帜）、location（地标）、drug（涉毒）、gamble（赌博）、others（其他） |'."\n" .'| ad | 图片垃圾广告识别：适用于图片中含有广告信息的识别，特別是针对于类似牛皮癣的文字广告有较好的识别效果。 | normal（正常图片）、politics（文字含敏感内容）、porn（文字含涉黄内容）、abuse（文字含辱骂内容）、terrorism（文字含涉恐内容）、contraband（文字含违禁内容）、spam（文字含其他垃圾内容）、npx（牛皮癣广告）、qrcode（包含二维码）、programCode（包含小程序码）、ad（其他广告） |'."\n" .'| live | 图片不良场景识别：适用于图片中涉及毒品、赌博、画中画等内容的识别。 | normal（正常图片）、meaningless（无意义图片）、PIP（画中画）、smoking（吸烟）、drivelive（车内直播）、drug（涉毒）、gamble（赌博） |'."\n" .'| logo | 图片Logo识别：适用于图片中含有台标、水印、商标等内容的检测。 | normal（正常图片）、TV（带有管控logo的图片）、trademark（商标） |'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[内容审核服务](https://vision.aliyun.com/imageaudit)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_imageaudit_public_cn#/open)。'."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/imageaudit/2019-12-30/ScanImage?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为内容审核（imageaudit）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" .'6. 示例代码：该能力常用语言的示例代码，请参见[图片内容安全示例代码](~~478892~~)。'."\n" ."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" ."\n" .'- 图像格式：PNG、JPG、JPEG、BMP、GIF、WEBP。'."\n" .'- 图像大小：不超过9 MB。'."\n" .'- 图像分辨率：建议大于256×256像素，像素过低可能会影响识别效果。超长图的分辨率长或宽不能超过30000像素。GIF图总像素（长x宽）不超过4194304像素，超过该总像素值会报InvalidFile.Download（文件无法下载）错误。'."\n" .'- URL地址中不能包含中文字符。'."\n" ."\n" .'## 检测说明'."\n" ."\n" .'- 最长检测时间是6秒，如果在该时间范围内没有完成检测，系统会返回超时错误码。'."\n" ."\n" .'- 图片下载时间限制为3秒，如果下载时间超过3秒，则会返回下载超时。'."\n" ."\n" .'- 图片检测接口响应时间依赖图片的下载时间。请确保被检测图片所在的存储服务稳定可靠，建议您使用阿里云OSS存储或者CDN缓存。'."\n" ."\n" .'## 计费说明'."\n" .'关于图片内容安全的计费方式及报价，请参见[计费介绍](~~202478~~)。'."\n" ."\n" .'> 下方调试接口为付费接口，如需免费体验调试请前往体验中心，对应体验入口如下表所示。'."\n" ."\n\n" .'| 能力 | 体验中心 |'."\n" .'| ---------------- | ------------------------------------------------------------ |'."\n" .'| 图片智能鉴黄 | [免费调试入口](https://vision.aliyun.com/experience/detail?&tagName=imageaudit&children=IdentifyPorn) |'."\n" .'| 图片敏感内容识别 | [免费调试入口](https://vision.aliyun.com/experience/detail?&tagName=imageaudit&children=IdentifyTerrorism) |'."\n" .'| 图片Logo识别 | [免费调试入口](https://vision.aliyun.com/experience/detail?&tagName=imageaudit&children=IdentifyLogo) |'."\n" .'| 图片垃圾广告识别 | [免费调试入口](https://vision.aliyun.com/experience/detail?&tagName=imageaudit&children=IdentifyAdvertisement) |'."\n" .'| 图片不良场景识别 | [免费调试入口](https://vision.aliyun.com/experience/detail?&tagName=imageaudit&children=IdentifyUnhealthyScene) |'."\n" .'| 图片风险人物识别 | [免费调试入口](https://vision.aliyun.com/experience/detail?&tagName=imageaudit&children=IdentifySensitiveFace) |'."\n" ."\n\n", 'requestParamsDescription' => '> 最多指定10个检测对象，即最多同时对10张图片进行检测。', 'responseParamsDescription' => '## SDK参考'."\n" .'阿里云视觉AI内容审核类目下的图片内容安全能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为内容审核（imageaudit）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" .'该能力常用语言的示例代码，请参见[图片内容安全示例代码](~~478892~~)。', 'extraInfo' => '## 错误码'."\n" .'关于图片内容安全的错误码，详情请参见[常见错误码](~~146773~~)。'."\n" ."\n" .'## 开源模型体验'."\n" .'更多开源免费模型体验及下载，详见魔搭社区：[内容审核模型-鉴黄](https://modelscope.cn/models/damo/cv_resnet50_image-classification_cc/summary)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', ], 'ScanText' => [ 'methods' => [ 'post', ], 'schemes' => [ 'http', 'https', ], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'Tasks', 'in' => 'formData', 'style' => 'repeatList', 'schema' => [ 'description' => '1', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Content' => [ 'description' => '指定检测的对象，JSON数组中的每个元素是一个文字检测任务结构体。'."\n" ."\n" .'> - N个Task会折算为N次调用进行计费。'."\n" .'- 算法识别效果问题请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。', 'type' => 'string', 'required' => true, 'example' => '维修管道，联系weixin', ], ], 'required' => false, ], 'required' => true, 'maxItems' => 10, ], ], [ 'name' => 'Labels', 'in' => 'formData', 'style' => 'repeatList', 'schema' => [ 'description' => '1', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Label' => [ 'description' => '指定文本检测的应用场景，可选值包括：'."\n" ."\n" .'- spam：文字垃圾内容识别'."\n" ."\n" .'- politics：文字敏感内容识别'."\n" ."\n" .'- abuse：文字辱骂内容识别'."\n" ."\n" .'- terrorism：文字暴恐内容识别'."\n" ."\n" .'- porn：文字鉴黄内容识别'."\n" ."\n" .'- flood：文字灌水内容识别'."\n" ."\n" .'- contraband：文字违禁内容识别'."\n" ."\n" .'- ad：文字广告内容识别', 'type' => 'string', 'required' => true, 'example' => 'ad', ], ], 'required' => false, ], 'required' => true, 'maxItems' => 10, ], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => [ 'description' => '请求ID。', 'type' => 'string', 'example' => 'C7CD87E3-57A5-4E2F-8A44-809F3554692C', ], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ 'Elements' => [ 'description' => '检测结果的各个子元素。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'TaskId' => [ 'description' => '任务ID。', 'type' => 'string', 'example' => 'txt6Vh5Fv0DAFy5hgdVRt3pqf-1s82jj', ], 'Results' => [ 'description' => '检测结果。如果返回为空，表示系统识别命中了其他Label，扩大Label重新发起请求。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Suggestion' => [ 'description' => '建议您执行的操作，取值包括：'."\n" ."\n" .'- pass：文本正常。'."\n" ."\n" .'- review：需要人工审核。'."\n" ."\n" .'- block：文本违规，可以直接删除或者做限制处理。', 'type' => 'string', 'example' => 'block', ], 'Label' => [ 'description' => '检测结果的分类。', 'type' => 'string', 'example' => 'ad', ], 'Rate' => [ 'description' => '结果为该分类的概率，取值范围为`[0.00-100.00]`。值越高，表示越有可能属于该分类。', 'type' => 'number', 'format' => 'float', 'example' => '99.91', ], 'Details' => [ 'description' => '文本的检测结果。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Label' => [ 'description' => '命中风险文本的分类。', 'type' => 'string', 'example' => 'ad', ], 'Contexts' => [ 'description' => '命中该风险的信息。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Context' => [ 'description' => '检测文本命中的风险内容。', 'type' => 'string', 'example' => '联系weixin', ], ], ], ], ], ], ], ], ], ], ], ], ], ], ], ], ], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"C7CD87E3-57A5-4E2F-8A44-809F3554692C\\",\\n \\"Data\\": {\\n \\"Elements\\": [\\n {\\n \\"TaskId\\": \\"txt6Vh5Fv0DAFy5hgdVRt3pqf-1s82jj\\",\\n \\"Results\\": [\\n {\\n \\"Suggestion\\": \\"block\\",\\n \\"Label\\": \\"ad\\",\\n \\"Rate\\": 99.91,\\n \\"Details\\": [\\n {\\n \\"Label\\": \\"ad\\",\\n \\"Contexts\\": [\\n {\\n \\"Context\\": \\"联系weixin\\"\\n }\\n ]\\n }\\n ]\\n }\\n ]\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 4FCBCC61-6264-56DE-9CF3-44C014F63B75\\n \\n \\n txt4OFqbn2s4WQ6kVA$dQGn9X-1vvHuZ\\n \\n block\\n

\\n ad\\n \\n 联系weixin \\n \\n

\\n 99.91\\n ad\\n \\n \\n \\n","errorExample":""}]', 'title' => '文本内容安全', 'summary' => '本文为您介绍文本内容安全ScanText的语法及示例。', 'description' => '## 功能描述'."\n" .'文本内容安全结合行为、内容，采用多维度、多模型、多检测手段，识别文本中的敏感信息，规避敏感人物姓名、敏感事件描述、敏感言论等内容风险。'."\n" .'支持检测的场景包括：文字垃圾内容识别、文字广告内容识别、文字敏感内容识别、文字暴恐内容识别、文字辱骂内容识别、文字鉴黄内容识别、文字灌水内容识别、文字违禁内容识别。'."\n" .'在提交检测任务时，您需要指定Labels参数，并且支持组合使用，即可对同一段文字进行多种风险检测。如果接口返回结果为空，表示未检测到Labels中的风险点。'."\n" ."\n" .'> - 在同时检测多个Task的情况下，将按照Task的个数进行累计计费。'."\n" .'- 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[内容审核服务](https://vision.aliyun.com/imageaudit)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_imageaudit_public_cn#/open)。'."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/imageaudit/2019-12-30/ScanText?lang=JAVA&sdkStyle=dara¶ms=%7B%22Tasks%22%3A%5B%7B%22Content%22%3A%22%E6%9C%AC%E6%A0%A1%E5%B0%8F%E9%A2%9D%E8%B4%B7%E6%AC%BE%EF%BC%8C%E5%AE%89%E5%85%A8%E3%80%81%E5%BF%AB%E6%8D%B7%E3%80%81%E6%96%B9%E4%BE%BF%E3%80%81%E6%97%A0%E6%8A%B5%E6%8A%BC%EF%BC%8C%E9%9A%8F%E6%9C%BA%E9%9A%8F%E8%B4%B7%EF%BC%8C%E5%BD%93%E5%A4%A9%E6%94%BE%E6%AC%BE%EF%BC%8C%E4%B8%8A%E9%97%A8%E6%9C%8D%E5%8A%A1%E3%80%82%E8%81%94%E7%B3%BBweixin%20123456%22%7D%5D%2C%22Labels%22%3A%5B%7B%22Label%22%3A%22spam%22%7D%2C%7B%22Label%22%3A%22politics%22%7D%2C%7B%22Label%22%3A%22abuse%22%7D%2C%7B%22Label%22%3A%22terrorism%22%7D%2C%7B%22Label%22%3A%22porn%22%7D%2C%7B%22Label%22%3A%22flood%22%7D%2C%7B%22Label%22%3A%22contraband%22%7D%2C%7B%22Label%22%3A%22ad%22%7D%5D%7D&tab=DEBUG)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为内容审核（imageaudit）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" .'6. 示例代码：该能力常用语言的示例代码，请参见[文本内容安全示例代码](~~477836~~)。'."\n" ."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 限制说明'."\n" .'该接口每次可以检测的文本字符数最大为10000。'."\n" ."\n" .'## 计费说明'."\n" .'关于文本内容安全的计费方式及报价，请参见[计费介绍](~~202478~~)。'."\n" ."\n" .'> 下方调试接口为付费接口，如需免费体验调试请前往体验中心，对应体验入口如下表所示。'."\n" ."\n" .'| 能力 | 体验中心 |'."\n" .'| ---------------- | ------------------------------------------------------------ |'."\n" .'| 文字垃圾内容识别 | [免费调试入口](https://vision.aliyun.com/experience/detail?&tagName=imageaudit&children=RecognizeSpamText) |'."\n" .'| 文字广告内容识别 | [免费调试入口](https://vision.aliyun.com/experience/detail?&tagName=imageaudit&children=RecognizeAdvertisingText) |'."\n" .'| 文字敏感内容识别 | [免费调试入口](https://vision.aliyun.com/experience/detail?&tagName=imageaudit&children=RecognizePoliticsText) |'."\n" .'| 文字暴恐内容识别 | [免费调试入口](https://vision.aliyun.com/experience/detail?&tagName=imageaudit&children=RecognizeTerrorismText) |'."\n" .'| 文字辱骂内容识别 | [免费调试入口](https://vision.aliyun.com/experience/detail?&tagName=imageaudit&children=RecognizeAbuseText) |'."\n" .'| 文字鉴黄内容识别 | [免费调试入口](https://vision.aliyun.com/experience/detail?&tagName=imageaudit&children=RecognizePornText) |'."\n" .'| 文字灌水内容识别 | [免费调试入口](https://vision.aliyun.com/experience/detail?&tagName=imageaudit&children=RecognizeFloodText) |'."\n" .'| 文字违禁内容识别 | [免费调试入口](https://vision.aliyun.com/experience/detail?&tagName=imageaudit&children=RecognizeContrabandText) |', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" .'阿里云视觉AI内容审核类目下的文本内容安全能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为内容审核（imageaudit）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" .'该能力常用语言的示例代码，请参见[文本内容安全示例代码](~~477836~~)。', 'extraInfo' => '## 错误码'."\n" .'关于文本内容安全的错误码，详情请参见[常见错误码](~~146773~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', ], ], 'endpoints' => [ [ 'regionId' => 'cn-shanghai', 'endpoint' => 'imageaudit.cn-shanghai.aliyuncs.com', ], ], ];