'1.0',
'info' => [
'style' => 'RPC',
'product' => 'imagerecog',
'version' => '2019-09-30',
],
'directories' => [
[
'id' => 64348,
'title' => '结果',
'type' => 'directory',
'children' => [
'GetAsyncJobResult',
'EvaluateCertificateQuality',
],
],
[
'id' => 64351,
'title' => '标注',
'type' => 'directory',
'children' => [
'TaggingImage',
],
],
[
'id' => 64353,
'title' => '识别',
'type' => 'directory',
'children' => [
'ClassifyingRubbish',
'DetectImageElements',
'RecognizeFood',
'RecognizeImageColor',
'RecognizeImageStyle',
'RecognizeScene',
],
],
[
'id' => 0,
'title' => '其它',
'type' => 'directory',
'children' => [
'TaggingAdImage',
],
],
],
'components' => [
'schemas' => [],
],
'apis' => [
'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.',
],
],
403 => [
[
'errorCode' => 'AuthFailed',
'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.',
],
],
408 => [
[
'errorCode' => 'Timeout',
'errorMessage' => 'The request has timed out.',
],
],
503 => [
[
'errorCode' => 'ServiceUnavailable',
'errorMessage' => 'The service is unavailable.',
],
],
],
'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小时后会被系统自动清理删除。',
],
'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',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterError',
'errorMessage' => 'The parameter is invalid. Please check again.',
],
],
403 => [
[
'errorCode' => 'AuthFailed',
'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.',
],
],
408 => [
[
'errorCode' => 'Timeout',
'errorMessage' => 'The request has timed out.',
],
],
503 => [
[
'errorCode' => 'ServiceUnavailable',
'errorMessage' => 'The service is unavailable.',
],
],
],
'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小时后会被系统自动清理删除。',
],
'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.',
],
],
403 => [
[
'errorCode' => 'AuthFailed',
'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.',
],
],
408 => [
[
'errorCode' => 'Timeout',
'errorMessage' => 'The request has timed out.',
],
],
503 => [
[
'errorCode' => 'ServiceUnavailable',
'errorMessage' => 'The service is unavailable.',
],
],
],
'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小时后会被系统自动清理删除。',
],
'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' => '可回收垃圾',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterError',
'errorMessage' => 'The parameter is invalid. Please check again.',
],
],
403 => [
[
'errorCode' => 'AuthFailed',
'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.',
],
],
408 => [
[
'errorCode' => 'Timeout',
'errorMessage' => 'The request has timed out.',
],
],
503 => [
[
'errorCode' => 'ServiceUnavailable',
'errorMessage' => 'The service is unavailable.',
],
],
],
'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小时后会被系统自动清理删除。',
],
'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',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterError',
'errorMessage' => 'The parameter is invalid. Please check again.',
],
],
403 => [
[
'errorCode' => 'AuthFailed',
'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.',
],
],
408 => [
[
'errorCode' => 'Timeout',
'errorMessage' => 'The request has timed out.',
],
],
503 => [
[
'errorCode' => 'ServiceUnavailable',
'errorMessage' => 'The service is unavailable.',
],
],
],
'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"
.'元素识别能力目前处于公测期，可免费调用。',
'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小时后会被系统自动清理删除。',
],
'RecognizeFood' => [
'summary' => '本文介绍菜品识别RecognizeFood的语法及示例。',
'methods' => [
'post',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'deprecated' => false,
'systemTags' => [],
'parameters' => [
[
'name' => 'ImageURL',
'in' => 'formData',
'schema' => [
'title' => 'A short description of struct',
'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。',
'type' => 'string',
'required' => true,
'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imagerecog/RecognizeFood/RecognizeFood5.jpg',
'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' => '4C2369C5-54E0-4B9F-8ACB-80C4F50AD2DB',
],
'Data' => [
'description' => '返回的结果数据内容。',
'type' => 'object',
'properties' => [
'TopFives' => [
'description' => '识别出TOP5可能性高的类别，按照置信度从大到小排列。'."\n"
."\n"
.'> 可能不足5个，最多显示5个。',
'type' => 'array',
'items' => [
'description' => '1',
'type' => 'object',
'properties' => [
'Category' => [
'description' => '类别。',
'type' => 'string',
'example' => '清蒸鲈鱼',
],
'Score' => [
'description' => '识别菜品类别的置信度，取值范围为0~1。',
'type' => 'number',
'format' => 'float',
'example' => '0.2083740234375',
],
'Calorie' => [
'description' => '每百克卡路里数值。例如被识别为三菌汤的数值为208，则表示每100克三菌汤卡路里为208大卡。'."\n"
."\n"
.'> 由于有些菜品很少见，没有比较统一的卡路里数值，故标注`UNKNOWN`，表示未知。',
'type' => 'string',
'example' => '208',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterError',
'errorMessage' => 'The parameter is invalid. Please check again.',
],
],
403 => [
[
'errorCode' => 'AuthFailed',
'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.',
],
],
408 => [
[
'errorCode' => 'Timeout',
'errorMessage' => 'The request has timed out.',
],
],
503 => [
[
'errorCode' => 'ServiceUnavailable',
'errorMessage' => 'The service is unavailable.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"4C2369C5-54E0-4B9F-8ACB-80C4F50AD2DB\\",\\n \\"Data\\": {\\n \\"TopFives\\": [\\n {\\n \\"Category\\": \\"清蒸鲈鱼\\",\\n \\"Score\\": 0.2083740234375,\\n \\"Calorie\\": \\"208\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n B6F48953-92F4-5388-A000-0057D46B1658\\n \\n \\n 105\\n 0.56878662109375\\n 清蒸鲈鱼\\n \\n \\n 117\\n 0.0455322265625\\n 鳜鱼\\n \\n \\n 112\\n 0.039886474609375\\n 清蒸桂花鱼\\n \\n \\n 118\\n 0.0296173095703125\\n 沸腾鱼\\n \\n \\n UNKNOWN\\n 0.0205230712890625\\n 其他类\\n \\n \\n","errorExample":""}]',
'title' => '菜品识别',
'description' => '## 服务说明'."\n"
.'由于产品业务调整，菜品识别服务于 即日起停止新用户开通调用，历史开通过该服务的老用户可继续调用，2026年04月20日后该服务将下架，不再支持新老用户调用，请尽早寻找替代方案。如果对菜品识别 API 服务使用有疑问，可通过搜索钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n"
."\n\n"
.'## 功能描述'."\n"
.'菜品识别能力可以识别出图片中的菜品类别名称和热量。'."\n"
."\n"
.'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n"
.'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n"
."\n"
.'## 应用场景'."\n"
."\n"
.'- 减肥App：拍摄每天的饮食，计算菜品的热量，可协助您控制好热量摄入。'."\n"
.'- 运动管理App：通过识别菜品类别，计算累计摄入热量，给出每天的运动计划量。'."\n"
.'- 餐饮、菜场等自动收银结算：通过识别餐饮的类别，可提供自动结算服务。'."\n"
."\n"
.'## 特色优势'."\n"
."\n"
.'- 支持本地生活业务场景。已积累线上餐饮品类三万多种，图片上亿张，海量数据积累，模型沉淀较深厚。'."\n"
.'- 支持线下食堂、连锁快餐、烘焙等垂直解决方案。'."\n"
."\n\n"
."\n"
.'## 输入限制'."\n"
.'- 图像类型：JPEG、JPG、PNG、BMP。'."\n"
.'- 图像大小：小于10 MB。'."\n"
.'- 图像分辨率：大于等于100×100像素，小于等于4096×4096像素。'."\n"
.'- URL地址中不能包含中文字符。'."\n"
."\n"
.'## 计费说明'."\n"
.'关于菜品识别的计费方式及报价，请参见[计费介绍](~~202481~~)。'."\n"
."\n"
.'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=imagerecog&children=RecognizeFood)。',
'responseParamsDescription' => '## SDK参考'."\n"
.'阿里云视觉AI图像识别类目下的菜品识别能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为图像识别（imagerecog）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n"
."\n"
.'## 示例代码'."\n"
.'该能力常用语言的示例代码，请参见[菜品识别示例代码](~~601126~~)。',
'extraInfo' => '## 错误码'."\n"
.'关于菜品识别的错误码，详情请参见[常见错误码](~~145022~~)。'."\n"
."\n"
.'## 安全声明'."\n"
.'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n"
.'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。',
],
'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',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterError',
'errorMessage' => 'The parameter is invalid. Please check again.',
],
],
403 => [
[
'errorCode' => 'AuthFailed',
'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.',
],
],
408 => [
[
'errorCode' => 'Timeout',
'errorMessage' => 'The request has timed out.',
],
],
503 => [
[
'errorCode' => 'ServiceUnavailable',
'errorMessage' => 'The service is unavailable.',
],
],
],
'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小时后会被系统自动清理删除。',
],
'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',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterError',
'errorMessage' => 'The parameter is invalid. Please check again.',
],
],
403 => [
[
'errorCode' => 'AuthFailed',
'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.',
],
],
408 => [
[
'errorCode' => 'Timeout',
'errorMessage' => 'The request has timed out.',
],
],
503 => [
[
'errorCode' => 'ServiceUnavailable',
'errorMessage' => 'The service is unavailable.',
],
],
],
'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小时后会被系统自动清理删除。',
],
'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',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterError',
'errorMessage' => 'The parameter is invalid. Please check again.',
],
],
403 => [
[
'errorCode' => 'AuthFailed',
'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.',
],
],
408 => [
[
'errorCode' => 'Timeout',
'errorMessage' => 'The request has timed out.',
],
],
503 => [
[
'errorCode' => 'ServiceUnavailable',
'errorMessage' => 'The service is unavailable.',
],
],
],
'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小时后会被系统自动清理删除。',
],
'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.',
],
],
403 => [
[
'errorCode' => 'AuthFailed',
'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.',
],
],
408 => [
[
'errorCode' => 'Timeout',
'errorMessage' => 'The request has timed out.',
],
],
503 => [
[
'errorCode' => 'ServiceUnavailable',
'errorMessage' => 'The service is unavailable.',
],
],
],
'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"
.''."\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小时后会被系统自动清理删除。',
],
],
'endpoints' => [
[
'regionId' => 'cn-shanghai',
'endpoint' => 'imagerecog.cn-shanghai.aliyuncs.com',
],
],
];