'1.0', 'info' => ['style' => 'RPC', 'product' => 'imagerecog', 'version' => '2019-09-30'], 'directories' => [ [ 'children' => ['GetAsyncJobResult', 'EvaluateCertificateQuality'], 'type' => 'directory', 'title' => '结果', 'id' => 357271, ], [ 'children' => ['TaggingImage'], 'type' => 'directory', 'title' => '标注', 'id' => 357274, ], [ 'children' => ['ClassifyingRubbish', 'DetectImageElements', 'RecognizeImageColor', 'RecognizeImageStyle', 'RecognizeScene'], 'type' => 'directory', 'title' => '识别', 'id' => 357276, ], [ 'children' => ['TaggingAdImage'], 'title' => '其他', 'type' => 'directory', ], ], 'components' => [ 'schemas' => [], ], 'apis' => [ 'ClassifyingRubbish' => [ 'methods' => ['post'], 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'ImageURL', 'in' => 'formData', 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imagerecog/ClassifyingRubbish/ClassifyingRubbish6.jpg', 'isFileTransferUrl' => true], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1619647E-92ED-5641-A1D9-F05C33FD294A'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ 'Sensitive' => ['description' => '图片中是否存在敏感信息。'."\n" ."\n" .'- true：存在敏感信息，不会返回具体垃圾分类信息。'."\n" ."\n" .'- false：不存在敏感信息。', 'type' => 'boolean', 'example' => 'false'], 'Elements' => [ 'description' => '输出垃圾识别结果。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'CategoryScore' => ['description' => '识别出的垃圾类别的置信度。', 'type' => 'number', 'format' => 'float', 'example' => '0.9406'], 'Rubbish' => ['description' => '具体的物品名称。', 'type' => 'string', 'example' => '纸板箱'], 'RubbishScore' => ['description' => '物品名称的置信度。', 'type' => 'number', 'format' => 'float', 'example' => '0.9406'], 'Category' => ['description' => '垃圾类别。包括可回收垃圾、干垃圾、湿垃圾、有害垃圾。', 'type' => 'string', 'example' => '可回收垃圾'], ], 'description' => '', ], ], ], ], ], 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => ''], ], 403 => [ ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => ''], ], 408 => [ ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => ''], ], 503 => [ ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => ''], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1619647E-92ED-5641-A1D9-F05C33FD294A\\",\\n \\"Data\\": {\\n \\"Sensitive\\": false,\\n \\"Elements\\": [\\n {\\n \\"CategoryScore\\": 0.9406,\\n \\"Rubbish\\": \\"纸板箱\\",\\n \\"RubbishScore\\": 0.9406,\\n \\"Category\\": \\"可回收垃圾\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 1619647E-92ED-5641-A1D9-F05C33FD294A\\n \\n false\\n \\n 纸板箱\\n 可回收垃圾\\n 0.9406\\n 0.9406\\n \\n \\n","errorExample":""}]', 'title' => '垃圾分类识别', 'summary' => '本文档介绍垃圾分类识别ClassifyingRubbish的语法及示例。', 'description' => '## 功能描述'."\n" .'垃圾分类识别能力可以对图片中的物品垃圾进行分类，并给出具体的物品名称。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=imagerecog&children=ClassifyingRubbish)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[图像识别服务](https://vision.aliyun.com/imagerecog)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_imagerecog_public_cn#/open)。'."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/imagerecog/2019-09-30/ClassifyingRubbish?lang=JAVA&sdkStyle=dara¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fimagerecog%2FClassifyingRubbish%2FClassifyingRubbish1.jpg%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为图像识别（imagerecog）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" .'6. 示例代码：该能力常用语言的示例代码，请参见[垃圾分类识别示例代码](~~601145~~)。'."\n" ."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" .'- 图像类型：JPEG、JPG、PNG。'."\n" .'- 图像大小：不大于3 MB。'."\n" .'- 图像分辨率：不限制图像分辨率，但图像分辨率太高可能会导致API识别超时，超时时间为5秒。'."\n" .'- URL地址中不能包含中文字符。'."\n" ."\n" .'## 计费说明'."\n" .'关于垃圾分类识别的计费方式及报价，请参见[计费介绍](~~202481~~)。'."\n" ."\n" .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=imagerecog&children=ClassifyingRubbish)。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## 常见垃圾输出列举值'."\n" .'- 湿垃圾：'."\n" .'八宝粥，冰激凌，冰糖葫芦，饼干，菠萝，菠萝蜜，菜根菜叶，残渣剩饭，草莓，茶叶，肠，橙子，蛋，蛋糕，蛋挞，地瓜，豆，豆腐，番茄，粉条，甘蔗，骨头，瓜子，果冻，果壳，果皮，哈密瓜，核桃，火龙果，火腿，鸡翅，坚果，秸秆杯，秸秆碗，咖啡，烤鸡，辣椒，梨，萝卜，面包，蘑菇，泡菜，苹果，巧克力，肉类，圣女果，蔬菜，薯片，薯条，水果，蒜，鱼骨。'."\n" ."\n" .'- 可回收垃圾：'."\n" .'包，保温杯，保鲜膜内芯，玻璃壶，玻璃瓶，玻璃器皿，玻璃球，玻璃制品，不锈钢制品，布制品，餐垫，餐具，插头电线，插线板，尺子，充电宝，充电头，充电线，充电牙刷，吹风机，磁铁，搓衣板，打包绳，打气筒，打印机，单车，档案袋，刀，地球仪，地铁票，灯罩，登机牌，凳子，电磁炉，电动卷发棒，电动剃须刀，电饭煲，电风扇，电话，电路板，显示器，电视机，电熨斗，电子秤，垫子，吊牌，调料瓶，钉子，订书机，豆浆机，耳机，耳套，放大镜，盖子，购物纸袋，锅，锅盖，果冻杯，过滤网，盒子，呼啦圈，护肤品瓶，话筒，计算器，键盘，金属罐，金属制品，酒瓶，卡片，空气加湿器，空气净化器，裤子，快递纸袋，拉杆箱，量杯，笼子，路由器，铝制用品，轮胎，帽子，灭火器，模具，木雕，木棍，木桶，木制切菜板，木质锅铲，木质梳子，奶粉罐，闹铃，尼龙绳，镊子，暖宝宝，盘子，泡沫板，乒乓球拍，棋子，铅球，裙子，燃气瓶，燃气灶，热水瓶，日历，扫地机器人，沙发，食用油桶，饰品，收音机，手表，手电筒，手机，手链，书，鼠标，水杯，水壶，塑料碗盆，塑料制品，台灯，太阳能热水器，毯子，体重秤，铁丝球，拖鞋，袜子，玩具，碗，网卡，望远镜，洗发水瓶，箱子，鞋，鞋子，信封，烟灰缸，遥控器，钥匙，衣服，衣架，音响，饮料瓶，鱼缸，瑜伽球，雨伞，枕头，纸牌，纸箱，纸制品，桌子。'."\n" ."\n" .'- 干垃圾：'."\n" .'百洁布，笔，便利贴，彩票，餐盒，餐巾纸，苍蝇拍，草帽，茶壶碎片，唱片，车票，除湿袋，厨房抹布，厨房手套，串串竹签，创可贴，搓澡巾，打火机，起泡网，大龙虾头，电蚊香，电影票，防霉防蛀片，干燥剂，鸡毛掸，胶带，胶水包装，酒精棉，空调滤芯，口罩，毛巾，奶茶杯，破碎陶瓷，湿纸巾，塑料袋，图钉，涂改带，卫生纸，牙签，牙刷，烟蒂，眼镜，眼镜布，验孕棒，一次性杯子，一次性棉签，竹筷，U型回形针，陶瓷。'."\n" ."\n" .'- 有害垃圾：'."\n" .'灯，电池，电池板，胶水，纽扣电池，杀虫剂，温度计，蓄电池，血压计，药膏，药片，药品包装，药瓶，指甲油。'."\n" ."\n" .'## SDK参考'."\n" .'阿里云视觉AI图像识别类目下的垃圾分类识别能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为图像识别（imagerecog）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" .'该能力常用语言的示例代码，请参见[垃圾分类识别示例代码](~~601145~~)。', 'extraInfo' => '## 错误码'."\n" .'关于垃圾分类识别的错误码，详情请参见[常见错误码](~~145022~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', 'changeSet' => [], ], 'DetectImageElements' => [ 'methods' => ['post'], 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'Url', 'in' => 'formData', 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imagerecog/DetectImageElements/DetectImageElements5.jpg', 'isFileTransferUrl' => true], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '7EE82437-AEC4-5AAF-819F-AB28C23EE0FC'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ 'Elements' => [ 'description' => '元素列表。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Type' => ['description' => '元素类型。包括：'."\n" .'UnType（未定义类型）、AllType（所有类型）、RootType（根类型）、Synthesis（组合元素图）、Embedded（所有嵌套类型）、Format（元素格式）、MajorObject（主体）、Character（文案）、Identifier（标识）、Background（背景）、Decoration（修饰）、MajorHuman（人物模特）、MajorAuction（商品）、MajorThing（物体）、MajorOther（其他主体）、CharMain（主文案）、CharSub（副文案）、CharAction（行动点文案）、CharContent（内容文案）、CharNumber（数字文案）、CharOther（其他文案）、IdentLogo（logo标识）、IdentLight（高亮标识）、IdentCode（码标识）、IdentOther（其他标识）、BackBitmap（位图背景）、BackVector（矢量图背景）、BackOther（其他背景）、DecoTile（平铺修饰）、DecoRegion（区域修饰）、DecoPieces（碎片修饰）、DecoEdge（贴边修饰）、DecoLine（线性修饰）、DecoBox（框型修饰）、DecoChar（行动点文案修饰）、DecoOther（其他修饰）、SynthMajor（主体组团）、SynthChar（文案组团）、SynthIdent（标识组团）、SynthBack（背景组团）、SynthDeco（修饰组团）、SynthOther（其他组团）、EmbedSvg（svg嵌套格式）、EmbedJson（JSON嵌套格式）、EmbedHtml（html嵌套格式）。'."\n", 'type' => 'string', 'example' => 'majorhuman'], 'Width' => ['description' => '元素宽度。', 'type' => 'integer', 'format' => 'int32', 'example' => '285'], 'Height' => ['description' => '元素高度。', 'type' => 'integer', 'format' => 'int32', 'example' => '354'], 'Y' => ['description' => '元素左上角Y轴坐标。', 'type' => 'integer', 'format' => 'int32', 'example' => '78'], 'Score' => ['description' => '置信度，置信度越高，识别结果的元素类型概率越高，取值范围[0.0, 1.0]。', 'type' => 'number', 'format' => 'float', 'example' => '0.997097373008728'], 'X' => ['description' => '元素左上角X轴坐标。', 'type' => 'integer', 'format' => 'int32', 'example' => '287'], ], 'description' => '', ], ], ], ], ], 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => ''], ], 403 => [ ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => ''], ], 408 => [ ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => ''], ], 503 => [ ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => ''], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"7EE82437-AEC4-5AAF-819F-AB28C23EE0FC\\",\\n \\"Data\\": {\\n \\"Elements\\": [\\n {\\n \\"Type\\": \\"majorhuman\\",\\n \\"Width\\": 285,\\n \\"Height\\": 354,\\n \\"Y\\": 78,\\n \\"Score\\": 0.997097373008728,\\n \\"X\\": 287\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 7EE82437-AEC4-5AAF-819F-AB28C23EE0FC\\n \\n \\n character\\n 0.999164342880249\\n 490\\n 215\\n 66\\n 380\\n \\n \\n character\\n 0.998594701290131\\n 531\\n 302\\n 38\\n 308\\n \\n \\n majorauction\\n 0.983854711055756\\n 51\\n 80\\n 392\\n 464\\n \\n \\n decoration\\n 0.915460407733917\\n 596\\n 148\\n 50\\n 170\\n \\n \\n decoration\\n 0.777607440948486\\n 649\\n 149\\n 45\\n 63\\n \\n \\n character\\n 0.712217330932617\\n 533\\n 349\\n 20\\n 297\\n \\n \\n character\\n 0.701746642589569\\n 239\\n 129\\n 36\\n 72\\n \\n \\n decoration\\n 0.598963797092438\\n 594\\n 166\\n 30\\n 67\\n \\n \\n decoration\\n 0.502112746238708\\n 703\\n 167\\n 29\\n 67\\n \\n \\n","errorExample":""}]', 'title' => '元素识别', 'summary' => '本文介绍元素识别DetectImageElements的语法及示例。', 'description' => '## 功能描述'."\n" .'元素识别能力用于识别输入图像中所包含的元素内容，用矩形框标注出其位置，并区分其对应的基本类型（人物、修饰、文案）。'."\n" ."\n" .'- 输入原图 ：'."\n" .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221108/imxc/DetectImageElements.jpg" width="500)'."\n" .'- 输出结果图 ：'."\n" .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221108/ospt/DetectImageElementsshuchu.png" width="500)'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=imagerecog&children=DetectImageElements)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[图像识别服务](https://vision.aliyun.com/imagerecog)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_imagerecog_public_cn#/open)。'."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/imagerecog/2019-09-30/DetectImageElements?lang=JAVA&sdkStyle=dara¶ms=%7B%22Url%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fimagerecog%2FDetectImageElements%2FDetectImageElements1.jpg%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为图像识别（imagerecog）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" .'6. 示例代码：该能力常用语言的示例代码，请参见[元素识别示例代码](~~601121~~)。'."\n" ."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" .'- 图像格式：JPG、JPEG、BMP、PNG。'."\n" .'- 图像大小：不超过3 MB。'."\n" .'- 图像分辨率：不超过1280×1280像素。'."\n" .'- URL地址中不能包含中文字符。'."\n" ."\n" .'## 计费说明'."\n" .'关于元素识别的计费方式及报价，请参见[计费介绍](~~202481~~)。'."\n" ."\n" .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=imagerecog&children=DetectImageElements)。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" .'阿里云视觉AI图像识别类目下的元素识别能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为图像识别（imagerecog）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" .'该能力常用语言的示例代码，请参见[元素识别示例代码](~~601121~~)。', 'extraInfo' => '## 错误码'."\n" .'关于元素识别的错误码，详情请参见[常见错误码](~~145022~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', 'changeSet' => [ ['createdAt' => '2022-03-30T03:34:17.000Z', 'description' => '错误码发生变更'], ], 'flowControl' => [ 'flowControlList' => [ ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DetectImageElements'], ], ], 'ramActions' => [ [ 'operationType' => '', 'ramAction' => [ 'action' => 'viapi-imagerecog:DetectImageElements', 'authLevel' => 'operate', 'actionConditions' => [], 'resources' => [ ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], ], ], 'EvaluateCertificateQuality' => [ 'methods' => ['post', 'get'], 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'ImageURL', 'in' => 'formData', 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'https://viapi-doc.oss-cn-shanghai.aliyuncs.com/imagerecog/xxxxx.jpg', 'isFileTransferUrl' => true], ], [ 'name' => 'Type', 'in' => 'formData', 'schema' => ['description' => '证照类型。'."\n" ."\n" .'- IDCard：身份证。'."\n" .'- BusinessLicense：电子执照。', 'type' => 'string', 'required' => true, 'example' => 'BusinessLicense'], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '656318DC-3856-43E3-9147-859532721AD6'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ 'Elements' => [ 'description' => '输出识别出的质量问题列表。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Value' => ['description' => '问题类型。'."\n" ."\n" .'- lackoffront： 缺乏正面照。'."\n" .'- copy：复印件。'."\n" .'- imageincomplete：证件图像不完整。'."\n" .'- nationalemblemincomplete：营业执照国徽不完整。'."\n" .'- lackofseal：缺乏印章。'."\n" .'- electronic：来源于电子档。'."\n" .'- reflection：反光。'."\n" ."\n" .'> - 如果请求参数**Type**为IDCard，无lackofseal（缺乏印章）。'."\n" .'- 如果请求参数**Type**为BusinessLicense，无lackoffront（缺乏正面照）。'."\n", 'type' => 'string', 'example' => 'lackoffront'], 'Pass' => ['description' => '是否通过检查。'."\n" ."\n" .'- true：通过检查。'."\n" .'- false：未通过检查。'."\n" .'- verify：无法检验证照质量，请人工确认。'."\n" .'- ERROR：该模块算法推理失败。', 'type' => 'string', 'example' => 'false'], 'Score' => ['description' => '质量问题分值，分值越高，问题越严重，取值为0~100之间的整数。'."\n" ."\n" .'- 当系统无法给出分值时，输出结果为`score`。'."\n" .'- 当**Pass**字段为`ERROR`时，输出结果为`null`。', 'type' => 'string', 'example' => '0.06514739990234375'], ], 'description' => '', ], ], ], ], ], 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => ''], ], 403 => [ ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => ''], ], 408 => [ ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => ''], ], 503 => [ ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => ''], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"656318DC-3856-43E3-9147-859532721AD6\\",\\n \\"Data\\": {\\n \\"Elements\\": [\\n {\\n \\"Value\\": \\"lackoffront\\",\\n \\"Pass\\": \\"false\\",\\n \\"Score\\": \\"0.06514739990234375\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"656318DC-3856-43E3-9147-859532721AD6\\n\\n \\n lackoffront\\n 0.06514739990234375\\n false\\n \\n","errorExample":""}]', 'title' => '证件照质量审核', 'summary' => '本文介绍证件照质量审核EvaluateCertificateQuality的语法及示例。', 'description' => '## 功能描述'."\n" .'证件照质量审核能力可以识别拍摄的证件照片是否存在质量问题，且有哪些质量问题。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 应用场景'."\n" ."\n" .'- 网络认证：在网络认证时，需要提交身份证、营业执照、护照、支票等证件照片。而拍摄的照片质量不一，部分照片由于拍摄或水印的原因，难以达到认证的清晰程度要求。证件照质量审核可以自动识别出证件图像质量问题，减少人力审核投入。'."\n" .'- 登记注册：在线下登记注册操作时，需要拍摄证件电子档照片，但拍摄条件水平不一， 部分照片质量存在问题。通过证件照质量审核可以筛选出有质量问题的照片，以免使用和识别的过程中出现操作失败和报错的情况。'."\n" ."\n" .'## 特色优势'."\n" ."\n" .'- 全方面检查：对影响认证的照片质量因素做全方面检查。检查项包括：是否目标证件类型、是否缺乏正面照、是否为复印件、证件图像是否完整、是否缺乏印章、是否来源于电子档、有无反光、有无水印覆盖、文字清晰度。从以上方面考察照片是否影响认证效力。'."\n" .'- 实际业务积累：该算法经过阿里实际业务沉淀，实际总结了诸多影响注册审核的各种质量问题，可助力业务自动化。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[图像识别服务](https://vision.aliyun.com/imagerecog)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_imagerecog_public_cn#/open)。'."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/imagerecog/2019-09-30/EvaluateCertificateQuality?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为图像识别（imagerecog）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" .'6. 示例代码：该能力常用语言的示例代码，请参见[证件照质量审核示例代码](~~601120~~)。'."\n" ."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" .'- 图像类型：JPEG、JPG、BMP、PNG。'."\n" .'- 图像大小：小于10 MB。'."\n" .'- 图像分辨率：大于100×100像素，小于5000×5000像素。'."\n" .'- URL地址中不能包含中文字符。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" .'阿里云视觉AI图像识别类目下的证件照质量审核能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为图像识别（imagerecog）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" .'该能力常用语言的示例代码，请参见[证件照质量审核示例代码](~~601120~~)。', 'extraInfo' => '## 错误码'."\n" .'关于证件照质量审核的错误码，详情请参见[常见错误码](~~145022~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', 'changeSet' => [], ], 'GetAsyncJobResult' => [ 'methods' => ['get'], 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ 'name' => 'JobId', 'in' => 'query', 'schema' => ['description' => '异步接口返回的RequestId，输入后可以查询异步接口的真实请求结果。', 'type' => 'string', 'required' => true, 'example' => '72CFDC08-3FEF-56AA-91E5-B14DE31C09C2'], ], ], 'responses' => [ 200 => [ 'schema' => [ 'description' => '1', 'type' => 'object', 'properties' => [ 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '572974F0-1014-5C60-97EE-DBFFC0FF7616'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ 'Status' => ['description' => '异步任务状态。包括：'."\n" ."\n" .'- QUEUING：任务排队中'."\n" ."\n" .'- PROCESSING：异步处理中'."\n" ."\n" .'- PROCESS_SUCCESS：处理成功'."\n" ."\n" .'- PROCESS_FAILED：处理失败'."\n" ."\n" .'- TIMEOUT_FAILED：任务超时未处理完成'."\n" ."\n" .'- LIMIT_RETRY_FAILED：超过最大重试次数', 'type' => 'string', 'example' => 'PROCESS_SUCCESS'], 'ErrorMessage' => ['description' => '异步任务错误码信息。', 'type' => 'string', 'example' => 'paramsIllegal'], 'Result' => ['description' => '异步任务返回的真实请求结果。', 'type' => 'string', 'example' => '{\\"tags\\":[{\\"confidence\\":-1,\\"value\\":\\"{\\\\\\"tagInfo\\\\\\": {\\\\\\"humanInfo\\\\\\": [[{\\\\\\"category\\\\\\": \\\\\\"human-real-normal\\\\\\", \\\\\\"score\\\\\\": 0.9690580798778683, \\\\\\"bbox\\\\\\": [77, 280, 431, 569], \\\\\\"cloth_category\\\\\\": \\\\\\"modern\\\\\\", \\\\\\"cloth_category_score\\\\\\": 0.7393399477005005}]], \\\\\\"sceneInfo\\\\\\": [[{\\\\\\"category\\\\\\": \\\\\\"gamescreen-gameeffect\\\\\\", \\\\\\"score\\\\\\": 0.44200169294841274}]], \\\\\\"objectInfo\\\\\\": [null]}}\\"}]}'], 'ErrorCode' => ['description' => '异步任务错误码。', 'type' => 'string', 'example' => 'InvalidParameter'], 'JobId' => ['description' => '异步任务ID。', 'type' => 'string', 'example' => '72CFDC08-3FEF-56AA-91E5-B14DE31C09C2'], ], ], ], ], ], ], 'errorCodes' => [ 400 => [ ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => ''], ], 403 => [ ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => ''], ], 408 => [ ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => ''], ], 503 => [ ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => ''], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"572974F0-1014-5C60-97EE-DBFFC0FF7616\\",\\n \\"Data\\": {\\n \\"Status\\": \\"PROCESS_SUCCESS\\",\\n \\"ErrorMessage\\": \\"paramsIllegal\\",\\n \\"Result\\": \\"{\\\\\\\\\\\\\\"tags\\\\\\\\\\\\\\":[{\\\\\\\\\\\\\\"confidence\\\\\\\\\\\\\\":-1,\\\\\\\\\\\\\\"value\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"{\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"tagInfo\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\": {\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"humanInfo\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\": [[{\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"category\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\": \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"human-real-normal\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\", \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"score\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\": 0.9690580798778683, \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"bbox\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\": [77, 280, 431, 569], \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"cloth_category\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\": \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"modern\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\", \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"cloth_category_score\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\": 0.7393399477005005}]], \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"sceneInfo\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\": [[{\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"category\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\": \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"gamescreen-gameeffect\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\", \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"score\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\": 0.44200169294841274}]], \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"objectInfo\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\": [null]}}\\\\\\\\\\\\\\"}]}\\",\\n \\"ErrorCode\\": \\"InvalidParameter\\",\\n \\"JobId\\": \\"72CFDC08-3FEF-56AA-91E5-B14DE31C09C2\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 572974F0-1014-5C60-97EE-DBFFC0FF7616\\n \\n PROCESS_SUCCESS\\n paramsIllegal\\n {\\\\\\"tags\\\\\\":[{\\\\\\"confidence\\\\\\":-1,\\\\\\"value\\\\\\":\\\\\\"{\\\\\\\\\\\\\\"tagInfo\\\\\\\\\\\\\\": {\\\\\\\\\\\\\\"humanInfo\\\\\\\\\\\\\\": [[{\\\\\\\\\\\\\\"category\\\\\\\\\\\\\\": \\\\\\\\\\\\\\"human-real-normal\\\\\\\\\\\\\\", \\\\\\\\\\\\\\"score\\\\\\\\\\\\\\": 0.9690580798778683, \\\\\\\\\\\\\\"bbox\\\\\\\\\\\\\\": [77, 280, 431, 569], \\\\\\\\\\\\\\"cloth_category\\\\\\\\\\\\\\": \\\\\\\\\\\\\\"modern\\\\\\\\\\\\\\", \\\\\\\\\\\\\\"cloth_category_score\\\\\\\\\\\\\\": 0.7393399477005005}]], \\\\\\\\\\\\\\"sceneInfo\\\\\\\\\\\\\\": [[{\\\\\\\\\\\\\\"category\\\\\\\\\\\\\\": \\\\\\\\\\\\\\"gamescreen-gameeffect\\\\\\\\\\\\\\", \\\\\\\\\\\\\\"score\\\\\\\\\\\\\\": 0.44200169294841274}]], \\\\\\\\\\\\\\"objectInfo\\\\\\\\\\\\\\": [null]}}\\\\\\"}]}\\n InvalidParameter\\n 72CFDC08-3FEF-56AA-91E5-B14DE31C09C2\\n \\n","errorExample":""}]', 'title' => '查询异步任务结果', 'summary' => '本文介绍查询异步任务结果GetAsyncJobResult的语法及示例。', 'description' => '## 功能描述'."\n" .'针对异步接口，调用API接口后，返回的并不是真正的请求结果，您需要保存返回结果中的RequestId，然后调用GetAsyncJobResult来获取真正的请求结果。'."\n" ."\n" .'> - 异步任务的文件有过期时间，有效期是30分钟。如需长期使用，需及时将文件下载到本地服务器或存储在OSS中。有关OSS更多操作信息，请参见[上传文件](~~31886~~)。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n\n" .'当前图像识别类目中广告素材分析（TaggingAdImage）为异步接口，需要调用GetAsyncJobResult来获取真实的请求结果。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" .'阿里云视觉AI能力推荐使用SDK调用，支持多种编程语言，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', 'extraInfo' => '## 错误码'."\n" .'关于查询异步任务结果的错误码，详情请参见[常见错误码](~~145022~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', 'changeSet' => [], ], 'RecognizeImageColor' => [ 'methods' => ['post'], 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'Url', 'in' => 'formData', 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imagerecog/RecognizeImageColor/RecognizeImageColor1.jpg', 'isFileTransferUrl' => true], ], [ 'name' => 'ColorCount', 'in' => 'formData', 'schema' => ['description' => '期望的色板输出数量。取值范围1~10，默认值为3。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '16', 'minimum' => '1', 'example' => '5', 'pattern' => '^\\d+$', 'default' => '3'], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'CCC7C1D9-8C0F-58AD-ADE3-C331B83BD6F2'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ 'ColorTemplateList' => [ 'description' => '色板列表。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Color' => ['description' => 'RGB颜色值（16进制），例如：291A18。', 'type' => 'string', 'example' => '270315'], 'Percentage' => ['description' => '当前颜色标签所占比例，取值范围`[0.0, 1.0]`。', 'type' => 'number', 'format' => 'float', 'example' => '0.459527'], 'Label' => ['description' => '颜色标签，共11种：black（黑色）、white（白色）、gray（灰色）、red（红色）、orange（橙色）、yellow（黄色）、green（绿色）、cyan（青色）、blue（蓝色）、purple（紫色）、magenta（紫红色）。', 'type' => 'string', 'example' => 'red'], ], 'description' => '', ], ], ], ], ], 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => ''], ], 403 => [ ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => ''], ], 408 => [ ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => ''], ], 503 => [ ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => ''], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"CCC7C1D9-8C0F-58AD-ADE3-C331B83BD6F2\\",\\n \\"Data\\": {\\n \\"ColorTemplateList\\": [\\n {\\n \\"Color\\": \\"270315\\",\\n \\"Percentage\\": 0.459527,\\n \\"Label\\": \\"red\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n CCC7C1D9-8C0F-58AD-ADE3-C331B83BD6F2\\n \\n \\n 0.459527\\n 270315\\n \\n \\n \\n 0.177192\\n 5A0014\\n \\n \\n \\n 0.169271\\n F139CC\\n \\n \\n \\n 0.107205\\n 610492\\n \\n \\n \\n 0.086806\\n EC4886\\n \\n \\n \\n","errorExample":""}]', 'title' => '颜色识别', 'summary' => '本文档介绍颜色识别RecognizeImageColor的语法及示例。', 'description' => '## 功能描述'."\n" .'颜色识别能力可以对输入图片的颜色信息进行分析，输出颜色值（RGB形式和HEX格式）与对应的占比信息。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=imagerecog&children=RecognizeImageColor)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[图像识别服务](https://vision.aliyun.com/imagerecog)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_imagerecog_public_cn#/open)。'."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/imagerecog/2019-09-30/RecognizeImageColor?lang=JAVA&sdkStyle=dara¶ms={%22Url%22:%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fimagerecog%2FRecognizeImageColor%2FRecognizeImageColor1.jpg%22,%22ColorCount%22:3}&tab=DEBUG)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为图像识别（imagerecog）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" .'6. 示例代码：该能力常用语言的示例代码，请参见[颜色识别示例代码](~~478784~~)。'."\n" ."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" .'- 图像格式：PNG、JPG、JPEG、BMP。'."\n" .'- 图像大小：不超过9.5 MB。'."\n" .'- 图像分辨率：小于2500×2500像素。'."\n" .'- 图像都必须是RGB 3通道。'."\n" ."\n" .'- URL地址中不能包含中文字符。'."\n" ."\n" .'## 计费说明'."\n" .'关于颜色识别的计费方式及报价，请参见[计费介绍](~~202481~~)。'."\n" ."\n" .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=imagerecog&children=RecognizeImageColor)。'."\n" ."\n", 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" .'阿里云视觉AI图像识别类目下的颜色识别能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为图像识别（imagerecog）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" .'该能力常用语言的示例代码，请参见[颜色识别示例代码](~~478784~~)。', 'extraInfo' => '## 错误码'."\n" .'关于颜色识别的错误码，详情请参见[常见错误码](~~145022~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', 'changeSet' => [], ], 'RecognizeImageStyle' => [ 'methods' => ['post'], 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'Url', 'in' => 'formData', 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imagerecog/RecognizeImageStyle/RecognizeImageStyle1.jpg', 'isFileTransferUrl' => true], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '66FC3009-9A7A-4D29-8B70-D6EB256EF590'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ 'Styles' => [ 'type' => 'array', 'items' => ['description' => '识别出的风格列表。风格包括：chinese（中国风）、watercolor（水彩）、cartoon（卡通）、real（实景）、standard（标准）、simple（简洁）、lively（活泼）、colourful（多彩）、luxury（豪华）、technology（科技）、morbidezza（柔美）、strong（硬朗）、simpleelegant（素雅）、coolcold（高冷）、promotion（促销）、protrude（突出）。', 'type' => 'string', 'example' => 'technology'], 'description' => '', ], ], ], ], 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => ''], ], 403 => [ ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => ''], ], 408 => [ ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => ''], ], 503 => [ ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => ''], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"66FC3009-9A7A-4D29-8B70-D6EB256EF590\\",\\n \\"Data\\": {\\n \\"Styles\\": [\\n \\"technology\\"\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 4F7BD051-ADBE-554C-893F-654FCA8535A1\\n \\n promotion\\n chinese\\n \\n","errorExample":""}]', 'title' => '风格识别', 'summary' => '本文档介绍风格识别RecognizeImageStyle的语法及示例。', 'description' => '## 功能描述'."\n" .'风格识别能力可以对输入图像的风格类型进行分析，识别可能的风格与语意标签。可以识别的风格包括：chinese（中国风）、watercolor（水彩）、cartoon（卡通）、real（实景）、standard（标准）、simple（简洁）、lively（活泼）、colourful（多彩）、luxury（豪华）、technology（科技）、morbidezza（柔美）、strong（硬朗）、simpleelegant（素雅）、coolcold（高冷）、promotion（促销）、protrude（突出）。'."\n" .'关于该接口功能的示例图如下： '."\n" .'视觉风格为中国风，语义风格为促销'."\n" .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221108/sqbq/RecognizeImageStyle.jpg" width="500)'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=imagerecog&children=RecognizeImageStyle)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[图像识别服务](https://vision.aliyun.com/imagerecog)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_imagerecog_public_cn#/open)。'."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/imagerecog/2019-09-30/RecognizeImageStyle?lang=JAVA&sdkStyle=dara¶ms=%7B%22Url%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fimagerecog%2FRecognizeImageStyle%2FRecognizeImageStyle1.jpg%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为图像识别（imagerecog）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" .'6. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" .'- 图像格式：PNG、JPG、JPEG、BMP、WEBP。'."\n" .'- 图像大小：不超过9.5 MB。'."\n" .'- 图像分辨率：小于3000×3000像素。'."\n" .'- 图像都必须是RGB 3通道。'."\n" .'- URL地址中不能包含中文字符。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" .'阿里云视觉AI图像识别类目下的风格识别能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为图像识别（imagerecog）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', 'extraInfo' => '## 错误码'."\n" .'关于风格识别的错误码，详情请参见[常见错误码](~~145022~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', 'changeSet' => [], ], 'RecognizeScene' => [ 'methods' => ['post'], 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'ImageURL', 'in' => 'formData', 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imagerecog/RecognizeScene/RecognizeScene1.jpg', 'isFileTransferUrl' => true], ], ], 'responses' => [ 200 => [ 'schema' => [ 'type' => 'object', 'properties' => [ 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'AC79F887-5CCB-42BE-8AC3-4D455EFEDB94'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ 'Tags' => [ 'description' => '标签名称。最多输出5个标签名称，如果某个类别标签未输出，则对应的`confidence`为零。'."\n", 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ 'Value' => ['description' => '标签名称。', 'type' => 'string', 'example' => '船'], 'Confidence' => ['description' => '标签名称的置信度。取值范围0~100。', 'type' => 'number', 'format' => 'float', 'example' => '79'], ], 'description' => '', ], ], ], ], ], 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => ''], ], 403 => [ ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => ''], ], 408 => [ ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => ''], ], 503 => [ ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => ''], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"AC79F887-5CCB-42BE-8AC3-4D455EFEDB94\\",\\n \\"Data\\": {\\n \\"Tags\\": [\\n {\\n \\"Value\\": \\"船\\",\\n \\"Confidence\\": 79\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n EA5E12C8-FFEB-5710-B4F4-A9A477DED671\\n \\n \\n 83\\n 夜景\\n \\n \\n 31\\n 海滨\\n \\n \\n 13\\n 街景\\n \\n \\n 13\\n 广场\\n \\n \\n 12\\n 船\\n \\n \\n","errorExample":""}]', 'title' => '场景识别', 'summary' => '本文介绍场景识别RecognizeScene的语法及示例。', 'description' => '## 功能描述'."\n" .'场景识别能力可以识别图像中的场景环境，支持数十种常见场景，包括：'."\n" .'- 人物、动物、狗、猫、鱼、鸟、花、草地、蔬菜、植物、水果、餐厅、美食、聚餐、烧烤'."\n" .'- 物品、手机、显示器'."\n" .'- 室外、广场、建筑、游乐场、户外、公路、小河、山峰、夜景、天空、旅行、日出、日落、树林、沙滩、沙漠、海滨、湖、露营、街景、街道、运动、运动场、婚礼、演出'."\n" .'- 地铁、汽车、火车、自行车、船、飞机'."\n" .'- 其他'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=imagerecog&children=RecognizeScene)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[图像识别服务](https://vision.aliyun.com/imagerecog)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_imagerecog_public_cn#/open)。'."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/imagerecog/2019-09-30/RecognizeScene?lang=JAVA&sdkStyle=dara¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fimagerecog%2FRecognizeScene%2FRecognizeScene1.jpg%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为图像识别（imagerecog）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" .'6. 示例代码：该能力常用语言的示例代码，请参见[场景识别示例代码](~~601110~~)。'."\n" ."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" .'- 图像格式：JPEG、JPG、PNG、BMP。'."\n" .'- 图像大小：不超过3 MB。'."\n" .'- 图像分辨率：大于5×5像素。'."\n" .'- URL地址中不能包含中文字符。'."\n" ."\n" .'## 计费说明'."\n" .'关于场景识别的计费方式及报价，请参见[计费介绍](~~202481~~)。'."\n" ."\n" .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=imagerecog&children=RecognizeScene)。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" .'阿里云视觉AI图像识别（imagerecog）类目下的场景识别能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为图像识别（imagerecog）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" .'该能力常用语言的示例代码，请参见[场景识别示例代码](~~601110~~)。', 'extraInfo' => '## 错误码'."\n" .'关于场景识别的错误码，详情请参见[常见错误码](~~145022~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', 'changeSet' => [], ], 'TaggingAdImage' => [ 'summary' => '本文介绍广告素材分析TaggingAdImage的语法及示例。', 'methods' => ['post'], 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => ['operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'paid', 'tenantRelevance' => 'publicInformation'], 'parameters' => [ [ 'name' => 'ImageURL', 'in' => 'formData', 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/DetectImageElements/xxxx.png', 'isFileTransferUrl' => true], ], ], 'responses' => [ 200 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '572974F0-1014-5C60-97EE-DBFFC0FF7616'], 'Data' => [ 'description' => '返回的结果数据内容。'."\n" .'该数据需要在异步任务执行成功后，通过调用[GetAsyncJobResult](~~607824~~)接口，对其Result字段进行JSON反序列化之后得到。', 'type' => 'object', 'properties' => [ 'TagInfo' => ['description' => '标签。目前仅输出scene（场景）和human（人）。具体取值请参见下表“TagInfo字段参数说明”。', 'type' => 'object'], ], ], 'Message' => ['description' => '提交异步任务后的提示信息。', 'type' => 'string', 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。'], ], ], ], ], 'errorCodes' => [ 400 => [ ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => ''], ], 403 => [ ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => ''], ], 408 => [ ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => ''], ], 503 => [ ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => ''], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"572974F0-1014-5C60-97EE-DBFFC0FF7616\\",\\n \\"Data\\": {\\n \\"TagInfo\\": {\\n \\"test\\": \\"test\\",\\n \\"test2\\": 1\\n }\\n },\\n \\"Message\\": \\"该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 572974F0-1014-5C60-97EE-DBFFC0FF7616\\n 该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\n","errorExample":""}]', 'title' => '广告素材分析', 'description' => '## 功能描述'."\n" .'广告素材分析能力可以对素材图片中的人物（明星、素人、CG人物）、场景等打上标签信息，可支持数千个内容标签，覆盖范围广。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 应用场景'."\n" ."\n" .'- 广告分析：对互联网广告内容及投放效果的数据进行分析，为用户投放和分析广告提供参考。'."\n" .'- 精准投放：利用素材标签、用户画像实现广告内容的精准投放。'."\n" .'- 素材检索：能够快速检索定位指定类型的素材。'."\n" ."\n" .'## 特色优势'."\n" ."\n" .'- 分析能力强：分析处理后对包含明星、素人、CG人物等复杂场景进行准确打标。'."\n" .'- 精准打标：可将物体、人物相关标签同步返回，并精准标记标签位置。'."\n" ."\n\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[图像识别服务](https://vision.aliyun.com/imagerecog)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_imagerecog_public_cn#/open)。'."\n" ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/imagerecog/2019-09-30/TaggingAdImage?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为图像识别（imagerecog）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" .'6. 示例代码：该能力常用语言的示例代码，请参见[广告素材分析示例代码](~~601117~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" ."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" ."\n" .'- 图像格式：JPEG、JPG、PNG、BMP。'."\n" .'- 图像大小：不超过3 MB。'."\n" .'- 图像分辨率：大于5×5像素。'."\n" .'- URL地址中不能包含中文字符。'."\n" ."\n" .'## 计费说明'."\n" .'关于广告素材分析的计费方式及报价，请参见[计费介绍](~~202481~~)。'."\n" ."\n" .'> 下方调试接口为付费接口。'."\n" ."\n" .'## 调用步骤'."\n" .'该能力为异步能力，需分两步进行调用。'."\n" .'第一步调用TaggingAdImage接口提交任务，请求成功后，得到一个任务ID。'."\n" .'第二步调用[GetAsyncJobResult](~~607824~~)接口查询结果，根据任务ID查询任务执行状态和结果。如果任务还在处理中，可稍等一段时间后再进行查询。当同一个任务还未处理完时，建议不要重复提交任务。', 'responseParamsDescription' => '## TagInfo字段参数说明'."\n" ."\n" .'| 字段 | 类型 | 是否必须 | 示例值 | 描述 |'."\n" .'| -------------------- | ------ | -------- | --------------------------- | ------------------------------------------------------------ |'."\n" .'| Cloth_category | string | 是 | modern | 如果为HumanInfo字段时，被识别的人物服饰标签。具体分类请参见下图“Category标签取值”。 如果为非HumanInfo字段时，可忽略此字段。 |'."\n" .'| Cloth_category_score | float | 是 | 0.8 | 如果为HumanInfo字段时，人物服饰标签置信度。取值范围 [0,1.0]。 如果为非HumanInfo字段时，可忽略此字段。 |'."\n" .'| Bbox | list | 是 | [77,280,431,569] | 表示视频中的元素出现的时间相对位置。 |'."\n" .'| Score | float | 是 | 0.9 | 标签置信度。取值范围 [0,1.0]。 |'."\n" .'| Category | string | 是 | human-real-celebrity-明星姓名 | 标签名称。具体分类请参见下图“Category标签取值”。 |'."\n" ."\n" .'## Category标签取值'."\n" .'![Category标签取值](https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/imagerecog/Image%201.png)'."\n" ."\n" .'## 查询结果'."\n" .'该接口为异步接口，当前并未返回真实的请求结果，您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见[GetAsyncJobResult](~~607824~~)。'."\n" ."\n" .'## SDK参考'."\n" .'阿里云视觉AI图像识别类目下的广告素材分析能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为图像识别（imagerecog）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" .'该能力常用语言的示例代码，请参见[广告素材分析示例代码](~~601117~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。', 'extraInfo' => '## 错误码'."\n" .'关于广告素材分析的错误码，详情请参见[常见错误码](~~145022~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', 'changeSet' => [], ], 'TaggingImage' => [ 'methods' => ['post'], 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'ImageURL', 'in' => 'formData', 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imagerecog/TaggingImage/TaggingImage1.jpg', 'isFileTransferUrl' => true], ], ], 'responses' => [ 200 => [ 'schema' => [ 'description' => '1', 'type' => 'object', 'properties' => [ 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '70ED13B0-BC22-576D-9CCF-1CC12FEAC477'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ 'Tags' => [ 'description' => '输出打标结果，最多输出5个打标结果，如果某个类别标签未输出，则对应的置信度`confidence`为零。', 'type' => 'array', 'items' => [ 'description' => '1', 'type' => 'object', 'properties' => [ 'Value' => ['description' => '标签名称。具体取值请[下载Label文件](https://viapi-oss.oss-cn-shanghai.aliyuncs.com/doc/imagerecog/label.txt)查看。', 'type' => 'string', 'example' => '沙发'], 'Confidence' => ['description' => '标签名称对应的置信度，取值范围0~100。', 'type' => 'number', 'format' => 'float', 'example' => '65'], ], ], ], ], ], ], ], ], ], 'errorCodes' => [ 400 => [ ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => ''], ], 403 => [ ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => ''], ], 408 => [ ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => ''], ], 503 => [ ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => ''], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"70ED13B0-BC22-576D-9CCF-1CC12FEAC477\\",\\n \\"Data\\": {\\n \\"Tags\\": [\\n {\\n \\"Value\\": \\"沙发\\",\\n \\"Confidence\\": 65\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 70ED13B0-BC22-576D-9CCF-1CC12FEAC477\\n \\n \\n 65\\n 沙发\\n \\n \\n 41\\n 床\\n \\n \\n 24\\n 家具\\n \\n \\n 13\\n 长沙发\\n \\n \\n 11\\n 卧室\\n \\n \\n","errorExample":""}]', 'title' => '通用图像打标', 'summary' => '本文介绍通用图像打标TaggingImage的语法及示例。', 'description' => '## 功能描述'."\n" .'通用图像打标能力用于识别图像中的主体内容并打上类型标签，支持数千个内容标签，覆盖常见物体品类。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=imagerecog&children=TaggingImage)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[图像识别服务](https://vision.aliyun.com/imagerecog)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_imagerecog_public_cn#/open)。'."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/imagerecog/2019-09-30/TaggingImage?lang=JAVA&sdkStyle=dara¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fimagerecog%2FTaggingImage%2FTaggingImage1.jpg%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为图像识别（imagerecog）的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" .'6. 示例代码：该能力常用语言的示例代码，请参见[通用图像打标示例代码](~~601100~~)。'."\n" ."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" .'- 图像格式：JPEG、JPG、PNG、BMP。'."\n" .'- 图像大小：不超过3 MB。'."\n" .'- 图像分辨率：大于5×5像素。'."\n" .'- URL地址中不能包含中文字符。'."\n" ."\n" .'## 计费说明'."\n" .'关于通用图像打标的计费方式及报价，请参见[计费介绍](~~202481~~)。'."\n" ."\n" .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=imagerecog&children=TaggingImage)。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" .'阿里云视觉AI图像识别类目下的通用图像打标能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为图像识别（imagerecog）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" .'该能力常用语言的示例代码，请参见[通用图像打标示例代码](~~601100~~)。', 'extraInfo' => '## 错误码'."\n" .'关于通用图像打标的错误码，详情请参见[常见错误码](~~145022~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', 'changeSet' => [], ], ], 'endpoints' => [ ['regionId' => 'cn-shanghai', 'regionName' => '华东2（上海）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'imagerecog.cn-shanghai.aliyuncs.com', 'endpoint' => 'imagerecog.cn-shanghai.aliyuncs.com', 'vpc' => 'imagerecog-vpc.cn-shanghai.aliyuncs.com'], ], 'errorCodes' => [], 'changeSet' => [ [ 'apis' => [ ['description' => '请求参数发生变更', 'api' => 'RecognizeLogo'], ], 'createdAt' => '2022-11-10T08:56:07.000Z', 'description' => '多url支持本地文件上传', ], [ 'apis' => [ ['description' => '错误码发生变更', 'api' => 'RecognizeImageStyle'], ], 'createdAt' => '2022-11-07T01:44:57.000Z', 'description' => '调整用户和API频率', ], [ 'apis' => [ ['description' => '响应参数发生变更', 'api' => 'TaggingAdImage'], ], 'createdAt' => '2022-10-17T02:04:46.000Z', 'description' => '修改异步任务Message为可见', ], [ 'apis' => [ ['description' => '响应参数发生变更', 'api' => 'RecognizeFood'], ], 'createdAt' => '2022-09-27T09:40:50.000Z', 'description' => '修改obj为可见', ], [ 'apis' => [ ['description' => '错误码发生变更', 'api' => 'ClassifyingRubbish'], ['description' => '错误码发生变更', 'api' => 'DetectFruits'], ['description' => '错误码发生变更', 'api' => 'DetectImageElements'], ['description' => '错误码发生变更', 'api' => 'EvaluateCertificateQuality'], ['description' => '错误码发生变更', 'api' => 'RecognizeImageColor'], ['description' => '错误码发生变更', 'api' => 'RecognizeVehicleType'], ], 'createdAt' => '2022-03-30T09:05:15.000Z', 'description' => '调整用户调用频率', ], [ 'apis' => [ ['description' => '错误码发生变更', 'api' => 'RecognizeLogo'], ], 'createdAt' => '2021-12-14T09:27:28.000Z', 'description' => '修改线上请求路径', ], [ 'apis' => [ ['description' => '响应参数发生变更', 'api' => 'TaggingAdImage'], ], 'createdAt' => '2021-08-10T01:41:06.000Z', 'description' => '新增出参参数', ], [ 'apis' => [ ['description' => '请求参数发生变更', 'api' => 'TaggingAdImage'], ], 'createdAt' => '2021-08-06T04:04:03.000Z', 'description' => '设置imageType', ], [ 'apis' => [ ['description' => 'OpenAPI 下线', 'api' => 'TaggingAdImage'], ['description' => '请求参数发生变更', 'api' => 'TaggingImage'], ], 'createdAt' => '2021-08-06T04:03:23.000Z', 'description' => '新增pop接口', ], ], 'flowControl' => [ 'flowControlList' => [ ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetAsyncJobResult'], ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DetectImageElements'], ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'RecognizeFood'], ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'RecognizeImageStyle'], ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'RecognizeScene'], ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'TaggingAdImage'], ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ClassifyingRubbish'], ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'RecognizeImageColor'], ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'TaggingImage'], ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'EvaluateCertificateQuality'], ], ], 'ram' => [ 'productCode' => 'VisualIntelligenceAPI', 'productName' => '视觉智能开放平台', 'ramCodes' => ['viapi-imageseg', 'viapi-imageaudit', 'viapi-ocr', 'viapi-objectdet', 'viapi-imageenhan', 'viapi-videorecog', 'viapi-imageprocess', 'viapi', 'viapi-ekyc', 'viapi-imgsearch', 'viapi-goodstech', 'viapi-facebody', 'viapi-threedvision', 'viapi-videoenhan', 'viapi-imagerecog', 'viapi-videoseg', 'viapi-regen', 'viapi-aigen'], 'ramLevel' => '服务级', 'ramConditions' => [], 'ramActions' => [ [ 'apiName' => 'RecognizeFood', 'description' => '菜品识别', 'operationType' => '', 'ramAction' => [ 'action' => 'viapi-imagerecog:RecognizeFood', 'authLevel' => 'operate', 'actionConditions' => [], 'resources' => [ ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], [ 'apiName' => 'EvaluateCertificateQuality', 'description' => '证件照质量审核', 'operationType' => '', 'ramAction' => [ 'action' => 'viapi-imagerecog:EvaluateCertificateQuality', 'authLevel' => 'operate', 'actionConditions' => [], 'resources' => [ ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], [ 'apiName' => 'GetAsyncJobResult', 'description' => '查询异步任务结果', 'operationType' => 'get', 'ramAction' => [ 'action' => 'viapi-imagerecog:GetAsyncJobResult', 'authLevel' => 'operate', 'actionConditions' => [], 'resources' => [ ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], [ 'apiName' => 'ClassifyingRubbish', 'description' => '垃圾分类识别', 'operationType' => '', 'ramAction' => [ 'action' => 'viapi-imagerecog:ClassifyingRubbish', 'authLevel' => 'operate', 'actionConditions' => [], 'resources' => [ ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], [ 'apiName' => 'TaggingAdImage', 'description' => '广告素材分析', 'operationType' => 'none', 'ramAction' => [ 'action' => 'viapi-imagerecog:TaggingAdImage', 'authLevel' => 'operate', 'actionConditions' => [], 'resources' => [ ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], [ 'apiName' => 'RecognizeImageStyle', 'description' => '风格识别', 'operationType' => '', 'ramAction' => [ 'action' => 'viapi-imagerecog:RecognizeImageStyle', 'authLevel' => 'operate', 'actionConditions' => [], 'resources' => [ ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], [ 'apiName' => 'RecognizeImageColor', 'description' => '颜色识别', 'operationType' => '', 'ramAction' => [ 'action' => 'viapi-imagerecog:RecognizeImageColor', 'authLevel' => 'operate', 'actionConditions' => [], 'resources' => [ ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], [ 'apiName' => 'DetectImageElements', 'description' => '元素识别', 'operationType' => '', 'ramAction' => [ 'action' => 'viapi-imagerecog:DetectImageElements', 'authLevel' => 'operate', 'actionConditions' => [], 'resources' => [ ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], [ 'apiName' => 'TaggingImage', 'description' => '通用图像打标', 'operationType' => '', 'ramAction' => [ 'action' => 'viapi-imagerecog:TaggingImage', 'authLevel' => 'operate', 'actionConditions' => [], 'resources' => [ ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], [ 'apiName' => 'RecognizeScene', 'description' => '场景识别', 'operationType' => '', 'ramAction' => [ 'action' => 'viapi-imagerecog:RecognizeScene', 'authLevel' => 'operate', 'actionConditions' => [], 'resources' => [ ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], ], 'resourceTypes' => [], ], ];