diff options
| author | Zhineng Li <im@zhineng.li> | 2026-07-12 17:11:17 +0800 |
|---|---|---|
| committer | Zhineng Li <im@zhineng.li> | 2026-07-12 17:11:17 +0800 |
| commit | 1c7f908ce09f98fdcbf79ed2a8ae21be60eaa634 (patch) | |
| tree | 5f0857666365b7e40cdaa3733ebe1f3ba9e13c67 /data/zh_cn/imagerecog/2019-09-30 | |
| parent | 7347bac4ab7e136157fc94777e6cf87ef9e08599 (diff) | |
| download | afterglow-metadata-full-1c7f908ce09f98fdcbf79ed2a8ae21be60eaa634.tar.gz afterglow-metadata-full-1c7f908ce09f98fdcbf79ed2a8ae21be60eaa634.zip | |
update APIs 20260712
Diffstat (limited to 'data/zh_cn/imagerecog/2019-09-30')
| -rw-r--r-- | data/zh_cn/imagerecog/2019-09-30/api-docs.php | 1540 |
1 files changed, 621 insertions, 919 deletions
diff --git a/data/zh_cn/imagerecog/2019-09-30/api-docs.php b/data/zh_cn/imagerecog/2019-09-30/api-docs.php index e0124df..c3f8048 100644 --- a/data/zh_cn/imagerecog/2019-09-30/api-docs.php +++ b/data/zh_cn/imagerecog/2019-09-30/api-docs.php @@ -1,197 +1,38 @@ <?php return [ 'version' => '1.0', - 'info' => [ - 'style' => 'RPC', - 'product' => 'imagerecog', - 'version' => '2019-09-30', - ], + 'info' => ['style' => 'RPC', 'product' => 'imagerecog', 'version' => '2019-09-30'], 'directories' => [ [ - 'id' => 64348, - 'title' => '结果', + 'children' => ['GetAsyncJobResult', 'EvaluateCertificateQuality'], 'type' => 'directory', - 'children' => [ - 'GetAsyncJobResult', - 'EvaluateCertificateQuality', - ], + 'title' => '结果', + 'id' => 357271, ], [ - 'id' => 64351, - 'title' => '标注', + 'children' => ['TaggingImage'], 'type' => 'directory', - 'children' => [ - 'TaggingImage', - ], + 'title' => '标注', + 'id' => 357274, ], [ - 'id' => 64353, - 'title' => '识别', + 'children' => ['ClassifyingRubbish', 'DetectImageElements', 'RecognizeImageColor', 'RecognizeImageStyle', 'RecognizeScene'], 'type' => 'directory', - 'children' => [ - 'ClassifyingRubbish', - 'DetectImageElements', - 'RecognizeFood', - 'RecognizeImageColor', - 'RecognizeImageStyle', - 'RecognizeScene', - ], + 'title' => '识别', + 'id' => 357276, ], [ - 'id' => 0, - 'title' => '其它', + 'children' => ['TaggingAdImage'], + '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":"<GetAsyncJobResultResponse>\\n <RequestId>572974F0-1014-5C60-97EE-DBFFC0FF7616</RequestId>\\n <Data>\\n <Status>PROCESS_SUCCESS</Status>\\n <ErrorMessage>paramsIllegal</ErrorMessage>\\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]}}\\\\\\"}]}</Result>\\n <ErrorCode>InvalidParameter</ErrorCode>\\n <JobId>72CFDC08-3FEF-56AA-91E5-B14DE31C09C2</JobId>\\n </Data>\\n</GetAsyncJobResultResponse>","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', - ], + 'ClassifyingRubbish' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -204,26 +45,7 @@ [ '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', - ], + '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' => [ @@ -231,120 +53,72 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '656318DC-3856-43E3-9147-859532721AD6', - ], + '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' => '输出识别出的质量问题列表。', + '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', - ], + '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.', - ], + ['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.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => ''], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => ''], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['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":"<RequestId>656318DC-3856-43E3-9147-859532721AD6</RequestId>\\n<Data>\\n <Elements>\\n <Value>lackoffront</Value>\\n <Score>0.06514739990234375</Score>\\n <Pass>false</Pass>\\n </Elements>\\n</Data>","errorExample":""}]', - 'title' => '证件照质量审核', - 'summary' => '本文介绍证件照质量审核EvaluateCertificateQuality的语法及示例。', + '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":"<ClassifyingRubbishResponse>\\n <RequestId>1619647E-92ED-5641-A1D9-F05C33FD294A</RequestId>\\n <Data>\\n <Sensitive>false</Sensitive>\\n <Elements>\\n <Rubbish>纸板箱</Rubbish>\\n <Category>可回收垃圾</Category>\\n <CategoryScore>0.9406</CategoryScore>\\n <RubbishScore>0.9406</RubbishScore>\\n </Elements>\\n </Data>\\n</ClassifyingRubbishResponse>","errorExample":""}]', + 'title' => '垃圾分类识别', + 'summary' => '本文档介绍垃圾分类识别ClassifyingRubbish的语法及示例。', 'description' => '## 功能描述'."\n" - .'证件照质量审核能力可以识别拍摄的证件照片是否存在质量问题，且有哪些质量问题。'."\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" - ."\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" + .'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. 示例代码：该能力常用语言的示例代码，请参见[证件照质量审核示例代码](~~601120~~)。'."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[垃圾分类识别示例代码](~~601145~~)。'."\n" ."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" @@ -353,141 +127,134 @@ .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" - .'- 图像类型：JPEG、JPG、BMP、PNG。'."\n" - .'- 图像大小：小于10 MB。'."\n" - .'- 图像分辨率：大于100×100像素，小于5000×5000像素。'."\n" - .'- URL地址中不能包含中文字符。', + .'- 图像类型：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' => '## SDK参考'."\n" - .'阿里云视觉AI图像识别类目下的证件照质量审核能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为图像识别（imagerecog）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + '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" - .'该能力常用语言的示例代码，请参见[证件照质量审核示例代码](~~601120~~)。', + .'该能力常用语言的示例代码，请参见[垃圾分类识别示例代码](~~601145~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于证件照质量审核的错误码，详情请参见[常见错误码](~~145022~~)。'."\n" + .'关于垃圾分类识别的错误码，详情请参见[常见错误码](~~145022~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', + 'changeSet' => [], ], - 'TaggingImage' => [ - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DetectImageElements' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ - 'name' => 'ImageURL', + '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/TaggingImage/TaggingImage1.jpg', - 'isFileTransferUrl' => true, - ], + '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' => [ - 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '70ED13B0-BC22-576D-9CCF-1CC12FEAC477', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '7EE82437-AEC4-5AAF-819F-AB28C23EE0FC'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'Tags' => [ - 'description' => '输出打标结果，最多输出5个打标结果，如果某个类别标签未输出，则对应的置信度`confidence`为零。', + 'Elements' => [ + 'description' => '元素列表。', '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', - ], + '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.', - ], + ['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.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => ''], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => ''], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['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":"<TaggingImageResponse>\\n <RequestId>70ED13B0-BC22-576D-9CCF-1CC12FEAC477</RequestId>\\n <Data>\\n <Tags>\\n <Confidence>65</Confidence>\\n <Value>沙发</Value>\\n </Tags>\\n <Tags>\\n <Confidence>41</Confidence>\\n <Value>床</Value>\\n </Tags>\\n <Tags>\\n <Confidence>24</Confidence>\\n <Value>家具</Value>\\n </Tags>\\n <Tags>\\n <Confidence>13</Confidence>\\n <Value>长沙发</Value>\\n </Tags>\\n <Tags>\\n <Confidence>11</Confidence>\\n <Value>卧室</Value>\\n </Tags>\\n </Data>\\n</TaggingImageResponse>","errorExample":""}]', - 'title' => '通用图像打标', - 'summary' => '本文介绍通用图像打标TaggingImage的语法及示例。', + '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":"<DetectImageElementsResponse>\\n <RequestId>7EE82437-AEC4-5AAF-819F-AB28C23EE0FC</RequestId>\\n <Data>\\n <Elements>\\n <Type>character</Type>\\n <Score>0.999164342880249</Score>\\n <X>490</X>\\n <Y>215</Y>\\n <Height>66</Height>\\n <Width>380</Width>\\n </Elements>\\n <Elements>\\n <Type>character</Type>\\n <Score>0.998594701290131</Score>\\n <X>531</X>\\n <Y>302</Y>\\n <Height>38</Height>\\n <Width>308</Width>\\n </Elements>\\n <Elements>\\n <Type>majorauction</Type>\\n <Score>0.983854711055756</Score>\\n <X>51</X>\\n <Y>80</Y>\\n <Height>392</Height>\\n <Width>464</Width>\\n </Elements>\\n <Elements>\\n <Type>decoration</Type>\\n <Score>0.915460407733917</Score>\\n <X>596</X>\\n <Y>148</Y>\\n <Height>50</Height>\\n <Width>170</Width>\\n </Elements>\\n <Elements>\\n <Type>decoration</Type>\\n <Score>0.777607440948486</Score>\\n <X>649</X>\\n <Y>149</Y>\\n <Height>45</Height>\\n <Width>63</Width>\\n </Elements>\\n <Elements>\\n <Type>character</Type>\\n <Score>0.712217330932617</Score>\\n <X>533</X>\\n <Y>349</Y>\\n <Height>20</Height>\\n <Width>297</Width>\\n </Elements>\\n <Elements>\\n <Type>character</Type>\\n <Score>0.701746642589569</Score>\\n <X>239</X>\\n <Y>129</Y>\\n <Height>36</Height>\\n <Width>72</Width>\\n </Elements>\\n <Elements>\\n <Type>decoration</Type>\\n <Score>0.598963797092438</Score>\\n <X>594</X>\\n <Y>166</Y>\\n <Height>30</Height>\\n <Width>67</Width>\\n </Elements>\\n <Elements>\\n <Type>decoration</Type>\\n <Score>0.502112746238708</Score>\\n <X>703</X>\\n <Y>167</Y>\\n <Height>29</Height>\\n <Width>67</Width>\\n </Elements>\\n </Data>\\n</DetectImageElementsResponse>","errorExample":""}]', + 'title' => '元素识别', + 'summary' => '本文介绍元素识别DetectImageElements的语法及示例。', 'description' => '## 功能描述'."\n" - .'通用图像打标能力用于识别图像中的主体内容并打上类型标签，支持数千个内容标签，覆盖常见物体品类。'."\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=TaggingImage)对该能力进行更直观试用以及在线购买。'."\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/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" + .'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. 示例代码：该能力常用语言的示例代码，请参见[通用图像打标示例代码](~~601100~~)。'."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[元素识别示例代码](~~601121~~)。'."\n" ."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" @@ -496,234 +263,73 @@ .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" - .'- 图像格式：JPEG、JPG、PNG、BMP。'."\n" + .'- 图像格式：JPG、JPEG、BMP、PNG。'."\n" .'- 图像大小：不超过3 MB。'."\n" - .'- 图像分辨率：大于5×5像素。'."\n" + .'- 图像分辨率：不超过1280×1280像素。'."\n" .'- URL地址中不能包含中文字符。'."\n" ."\n" .'## 计费说明'."\n" - .'关于通用图像打标的计费方式及报价，请参见[计费介绍](~~202481~~)。'."\n" + .'关于元素识别的计费方式及报价，请参见[计费介绍](~~202481~~)。'."\n" ."\n" - .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=imagerecog&children=TaggingImage)。', + .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=imagerecog&children=DetectImageElements)。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI图像识别类目下的通用图像打标能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为图像识别（imagerecog）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + .'阿里云视觉AI图像识别类目下的元素识别能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为图像识别（imagerecog）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[通用图像打标示例代码](~~601100~~)。', + .'该能力常用语言的示例代码，请参见[元素识别示例代码](~~601121~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于通用图像打标的错误码，详情请参见[常见错误码](~~145022~~)。'."\n" + .'关于元素识别的错误码，详情请参见[常见错误码](~~145022~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'ClassifyingRubbish' => [ - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [ + ['createdAt' => '2022-03-30T03:34:17.000Z', 'description' => '错误码发生变更'], ], - 'security' => [ - [ - 'AK' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DetectImageElements'], ], ], - 'operationType' => 'read', - 'deprecated' => false, - 'systemTags' => [], - 'parameters' => [ + 'ramActions' => [ [ - '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' => '可回收垃圾', - ], - ], - ], - ], - ], - ], + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-imagerecog:DetectImageElements', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], ], - '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":"<ClassifyingRubbishResponse>\\n <RequestId>1619647E-92ED-5641-A1D9-F05C33FD294A</RequestId>\\n <Data>\\n <Sensitive>false</Sensitive>\\n <Elements>\\n <Rubbish>纸板箱</Rubbish>\\n <Category>可回收垃圾</Category>\\n <CategoryScore>0.9406</CategoryScore>\\n <RubbishScore>0.9406</RubbishScore>\\n </Elements>\\n </Data>\\n</ClassifyingRubbishResponse>","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', - ], + 'EvaluateCertificateQuality' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ - 'name' => 'Url', + '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/DetectImageElements/DetectImageElements5.jpg', - 'isFileTransferUrl' => true, - ], + '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' => [ @@ -731,118 +337,94 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '7EE82437-AEC4-5AAF-819F-AB28C23EE0FC', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '656318DC-3856-43E3-9147-859532721AD6'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ 'Elements' => [ - 'description' => '元素列表。', + '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', - ], + '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.', - ], + ['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.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => ''], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => ''], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['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":"<DetectImageElementsResponse>\\n <RequestId>7EE82437-AEC4-5AAF-819F-AB28C23EE0FC</RequestId>\\n <Data>\\n <Elements>\\n <Type>character</Type>\\n <Score>0.999164342880249</Score>\\n <X>490</X>\\n <Y>215</Y>\\n <Height>66</Height>\\n <Width>380</Width>\\n </Elements>\\n <Elements>\\n <Type>character</Type>\\n <Score>0.998594701290131</Score>\\n <X>531</X>\\n <Y>302</Y>\\n <Height>38</Height>\\n <Width>308</Width>\\n </Elements>\\n <Elements>\\n <Type>majorauction</Type>\\n <Score>0.983854711055756</Score>\\n <X>51</X>\\n <Y>80</Y>\\n <Height>392</Height>\\n <Width>464</Width>\\n </Elements>\\n <Elements>\\n <Type>decoration</Type>\\n <Score>0.915460407733917</Score>\\n <X>596</X>\\n <Y>148</Y>\\n <Height>50</Height>\\n <Width>170</Width>\\n </Elements>\\n <Elements>\\n <Type>decoration</Type>\\n <Score>0.777607440948486</Score>\\n <X>649</X>\\n <Y>149</Y>\\n <Height>45</Height>\\n <Width>63</Width>\\n </Elements>\\n <Elements>\\n <Type>character</Type>\\n <Score>0.712217330932617</Score>\\n <X>533</X>\\n <Y>349</Y>\\n <Height>20</Height>\\n <Width>297</Width>\\n </Elements>\\n <Elements>\\n <Type>character</Type>\\n <Score>0.701746642589569</Score>\\n <X>239</X>\\n <Y>129</Y>\\n <Height>36</Height>\\n <Width>72</Width>\\n </Elements>\\n <Elements>\\n <Type>decoration</Type>\\n <Score>0.598963797092438</Score>\\n <X>594</X>\\n <Y>166</Y>\\n <Height>30</Height>\\n <Width>67</Width>\\n </Elements>\\n <Elements>\\n <Type>decoration</Type>\\n <Score>0.502112746238708</Score>\\n <X>703</X>\\n <Y>167</Y>\\n <Height>29</Height>\\n <Width>67</Width>\\n </Elements>\\n </Data>\\n</DetectImageElementsResponse>","errorExample":""}]', - 'title' => '元素识别', - 'summary' => '本文介绍元素识别DetectImageElements的语法及示例。', + '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":"<RequestId>656318DC-3856-43E3-9147-859532721AD6</RequestId>\\n<Data>\\n <Elements>\\n <Value>lackoffront</Value>\\n <Score>0.06514739990234375</Score>\\n <Pass>false</Pass>\\n </Elements>\\n</Data>","errorExample":""}]', + 'title' => '证件照质量审核', + 'summary' => '本文介绍证件照质量审核EvaluateCertificateQuality的语法及示例。', '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" ."\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" + ."\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/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" + .'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. 示例代码：该能力常用语言的示例代码，请参见[元素识别示例代码](~~601121~~)。'."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[证件照质量审核示例代码](~~601120~~)。'."\n" ."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" @@ -851,103 +433,70 @@ .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" - .'- 图像格式：JPG、JPEG、BMP、PNG。'."\n" - .'- 图像大小：不超过3 MB。'."\n" - .'- 图像分辨率：不超过1280×1280像素。'."\n" - .'- URL地址中不能包含中文字符。'."\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" + .'阿里云视觉AI图像识别类目下的证件照质量审核能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为图像识别（imagerecog）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[元素识别示例代码](~~601121~~)。', + .'该能力常用语言的示例代码，请参见[证件照质量审核示例代码](~~601120~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于元素识别的错误码，详情请参见[常见错误码](~~145022~~)。'."\n" + .'关于证件照质量审核的错误码，详情请参见[常见错误码](~~145022~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', + 'changeSet' => [], ], - 'RecognizeFood' => [ - 'summary' => '本文介绍菜品识别RecognizeFood的语法及示例。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'GetAsyncJobResult' => [ + 'methods' => ['get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [], + 'systemTags' => ['operationType' => 'get'], '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, - ], + 'name' => 'JobId', + 'in' => 'query', + 'schema' => ['description' => '异步接口返回的RequestId，输入后可以查询异步接口的真实请求结果。', 'type' => 'string', 'required' => true, 'example' => '72CFDC08-3FEF-56AA-91E5-B14DE31C09C2'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '4C2369C5-54E0-4B9F-8ACB-80C4F50AD2DB', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '572974F0-1014-5C60-97EE-DBFFC0FF7616'], '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', - ], - ], - ], - ], + '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'], ], ], ], @@ -956,83 +505,42 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['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.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => ''], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => ''], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => ''], ], ], - '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":"<RecognizeFoodResponse>\\n <RequestId>B6F48953-92F4-5388-A000-0057D46B1658</RequestId>\\n <Data>\\n <TopFives>\\n <Calorie>105</Calorie>\\n <Score>0.56878662109375</Score>\\n <Category>清蒸鲈鱼</Category>\\n </TopFives>\\n <TopFives>\\n <Calorie>117</Calorie>\\n <Score>0.0455322265625</Score>\\n <Category>鳜鱼</Category>\\n </TopFives>\\n <TopFives>\\n <Calorie>112</Calorie>\\n <Score>0.039886474609375</Score>\\n <Category>清蒸桂花鱼</Category>\\n </TopFives>\\n <TopFives>\\n <Calorie>118</Calorie>\\n <Score>0.0296173095703125</Score>\\n <Category>沸腾鱼</Category>\\n </TopFives>\\n <TopFives>\\n <Calorie>UNKNOWN</Calorie>\\n <Score>0.0205230712890625</Score>\\n <Category>其他类</Category>\\n </TopFives>\\n </Data>\\n</RecognizeFoodResponse>","errorExample":""}]', - 'title' => '菜品识别', - 'description' => '## 服务说明'."\n" - .'由于产品业务调整，菜品识别服务于 即日起停止新用户开通调用，历史开通过该服务的老用户可继续调用，2026年04月20日后该服务将下架，不再支持新老用户调用，请尽早寻找替代方案。如果对菜品识别 API 服务使用有疑问，可通过搜索钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" - ."\n\n" - .'## 功能描述'."\n" - .'菜品识别能力可以识别出图片中的菜品类别名称和热量。'."\n" + '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":"<GetAsyncJobResultResponse>\\n <RequestId>572974F0-1014-5C60-97EE-DBFFC0FF7616</RequestId>\\n <Data>\\n <Status>PROCESS_SUCCESS</Status>\\n <ErrorMessage>paramsIllegal</ErrorMessage>\\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]}}\\\\\\"}]}</Result>\\n <ErrorCode>InvalidParameter</ErrorCode>\\n <JobId>72CFDC08-3FEF-56AA-91E5-B14DE31C09C2</JobId>\\n </Data>\\n</GetAsyncJobResultResponse>","errorExample":""}]', + 'title' => '查询异步任务结果', + 'summary' => '本文介绍查询异步任务结果GetAsyncJobResult的语法及示例。', + 'description' => '## 功能描述'."\n" + .'针对异步接口，调用API接口后，返回的并不是真正的请求结果，您需要保存返回结果中的RequestId，然后调用GetAsyncJobResult来获取真正的请求结果。'."\n" ."\n" - .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'> - 异步任务的文件有过期时间，有效期是30分钟。如需长期使用，需及时将文件下载到本地服务器或存储在OSS中。有关OSS更多操作信息，请参见[上传文件](~~31886~~)。'."\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)。', + .'当前图像识别类目中广告素材分析（TaggingAdImage）为异步接口，需要调用GetAsyncJobResult来获取真实的请求结果。', + 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI图像识别类目下的菜品识别能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为图像识别（imagerecog）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" - ."\n" - .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[菜品识别示例代码](~~601126~~)。', + .'阿里云视觉AI能力推荐使用SDK调用，支持多种编程语言，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于菜品识别的错误码，详情请参见[常见错误码](~~145022~~)。'."\n" + .'关于查询异步任务结果的错误码，详情请参见[常见错误码](~~145022~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', + 'changeSet' => [], ], 'RecognizeImageColor' => [ - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -1045,28 +553,12 @@ [ '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, - ], + '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', - ], + 'schema' => ['description' => '期望的色板输出数量。取值范围1~10，默认值为3。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '16', 'minimum' => '1', 'example' => '5', 'pattern' => '^\\d+$', 'default' => '3'], ], ], 'responses' => [ @@ -1074,11 +566,7 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'CCC7C1D9-8C0F-58AD-ADE3-C331B83BD6F2', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'CCC7C1D9-8C0F-58AD-ADE3-C331B83BD6F2'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', @@ -1089,55 +577,32 @@ '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', - ], + '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.', - ], + ['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.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => ''], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => ''], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['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":"<RecognizeImageColorResponse>\\n <RequestId>CCC7C1D9-8C0F-58AD-ADE3-C331B83BD6F2</RequestId>\\n <Data>\\n <ColorTemplateList>\\n <Percentage>0.459527</Percentage>\\n <Color>270315</Color>\\n <Label>red</Label>\\n </ColorTemplateList>\\n <ColorTemplateList>\\n <Percentage>0.177192</Percentage>\\n <Color>5A0014</Color>\\n <Label>red</Label>\\n </ColorTemplateList>\\n <ColorTemplateList>\\n <Percentage>0.169271</Percentage>\\n <Color>F139CC</Color>\\n <Label>magenta</Label>\\n </ColorTemplateList>\\n <ColorTemplateList>\\n <Percentage>0.107205</Percentage>\\n <Color>610492</Color>\\n <Label>purple</Label>\\n </ColorTemplateList>\\n <ColorTemplateList>\\n <Percentage>0.086806</Percentage>\\n <Color>EC4886</Color>\\n <Label>red</Label>\\n </ColorTemplateList>\\n </Data>\\n</RecognizeImageColorResponse>","errorExample":""}]', @@ -1193,15 +658,11 @@ .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', + 'changeSet' => [], ], 'RecognizeImageStyle' => [ - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -1214,13 +675,7 @@ [ '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, - ], + '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' => [ @@ -1228,53 +683,35 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '66FC3009-9A7A-4D29-8B70-D6EB256EF590', - ], + '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', - ], + '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.', - ], + ['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.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => ''], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => ''], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['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":"<RecognizeImageStyleResponse>\\n <RequestId>4F7BD051-ADBE-554C-893F-654FCA8535A1</RequestId>\\n <Data>\\n <Styles>promotion</Styles>\\n <Styles>chinese</Styles>\\n </Data>\\n</RecognizeImageStyleResponse>","errorExample":""}]', @@ -1321,15 +758,11 @@ .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', + 'changeSet' => [], ], 'RecognizeScene' => [ - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -1342,13 +775,7 @@ [ '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, - ], + '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' => [ @@ -1356,11 +783,7 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'AC79F887-5CCB-42BE-8AC3-4D455EFEDB94', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'AC79F887-5CCB-42BE-8AC3-4D455EFEDB94'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', @@ -1371,50 +794,31 @@ 'items' => [ 'type' => 'object', 'properties' => [ - 'Value' => [ - 'description' => '标签名称。', - 'type' => 'string', - 'example' => '船', - ], - 'Confidence' => [ - 'description' => '标签名称的置信度。取值范围0~100。', - 'type' => 'number', - 'format' => 'float', - 'example' => '79', - ], + '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.', - ], + ['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.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => ''], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => ''], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['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":"<RecognizeSceneResponse>\\n <RequestId>EA5E12C8-FFEB-5710-B4F4-A9A477DED671</RequestId>\\n <Data>\\n <Tags>\\n <Confidence>83</Confidence>\\n <Value>夜景</Value>\\n </Tags>\\n <Tags>\\n <Confidence>31</Confidence>\\n <Value>海滨</Value>\\n </Tags>\\n <Tags>\\n <Confidence>13</Confidence>\\n <Value>街景</Value>\\n </Tags>\\n <Tags>\\n <Confidence>13</Confidence>\\n <Value>广场</Value>\\n </Tags>\\n <Tags>\\n <Confidence>12</Confidence>\\n <Value>船</Value>\\n </Tags>\\n </Data>\\n</RecognizeSceneResponse>","errorExample":""}]', @@ -1472,16 +876,12 @@ .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', + 'changeSet' => [], ], 'TaggingAdImage' => [ 'summary' => '本文介绍广告素材分析TaggingAdImage的语法及示例。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -1489,23 +889,12 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - 'riskType' => 'none', - 'chargeType' => 'paid', - 'tenantRelevance' => 'publicInformation', - ], + '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, - ], + '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' => [ @@ -1515,56 +904,32 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '572974F0-1014-5C60-97EE-DBFFC0FF7616', - ], + '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', - ], + 'TagInfo' => ['description' => '标签。目前仅输出scene（场景）和human（人）。具体取值请参见下表“TagInfo字段参数说明”。', 'type' => 'object'], ], ], - 'Message' => [ - 'description' => '提交异步任务后的提示信息。', - 'type' => 'string', - 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。', - ], + 'Message' => ['description' => '提交异步任务后的提示信息。', 'type' => 'string', 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。'], ], ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], + ['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.', - ], + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => ''], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => ''], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['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":"<TaggingAdImageResponse>\\n <RequestId>572974F0-1014-5C60-97EE-DBFFC0FF7616</RequestId>\\n <Message>该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>\\n</TaggingAdImageResponse>","errorExample":""}]', @@ -1648,12 +1013,349 @@ .'## 安全声明'."\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":"<TaggingImageResponse>\\n <RequestId>70ED13B0-BC22-576D-9CCF-1CC12FEAC477</RequestId>\\n <Data>\\n <Tags>\\n <Confidence>65</Confidence>\\n <Value>沙发</Value>\\n </Tags>\\n <Tags>\\n <Confidence>41</Confidence>\\n <Value>床</Value>\\n </Tags>\\n <Tags>\\n <Confidence>24</Confidence>\\n <Value>家具</Value>\\n </Tags>\\n <Tags>\\n <Confidence>13</Confidence>\\n <Value>长沙发</Value>\\n </Tags>\\n <Tags>\\n <Confidence>11</Confidence>\\n <Value>卧室</Value>\\n </Tags>\\n </Data>\\n</TaggingImageResponse>","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', + ], [ - 'regionId' => 'cn-shanghai', - 'endpoint' => 'imagerecog.cn-shanghai.aliyuncs.com', + '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' => [], ], ]; |