diff options
Diffstat (limited to 'data/zh_cn/imageseg/2019-12-30')
| -rw-r--r-- | data/zh_cn/imageseg/2019-12-30/api-docs.php | 1951 |
1 files changed, 978 insertions, 973 deletions
diff --git a/data/zh_cn/imageseg/2019-12-30/api-docs.php b/data/zh_cn/imageseg/2019-12-30/api-docs.php index c15d3e0..1fd3a36 100644 --- a/data/zh_cn/imageseg/2019-12-30/api-docs.php +++ b/data/zh_cn/imageseg/2019-12-30/api-docs.php @@ -1,40 +1,18 @@ <?php return [ 'version' => '1.0', - 'info' => [ - 'style' => 'RPC', - 'product' => 'imageseg', - 'version' => '2019-12-30', - ], + 'info' => ['style' => 'RPC', 'product' => 'imageseg', 'version' => '2019-12-30'], 'directories' => [ [ - 'id' => 64411, - 'title' => '分割', + 'children' => ['ChangeSky', 'RefineMask', 'SegmentBody', 'SegmentCloth', 'SegmentCommodity', 'SegmentCommonImage', 'SegmentFood', 'SegmentHair', 'SegmentHDBody', 'SegmentHDCommonImage', 'SegmentHDSky', 'SegmentHead', 'SegmentSkin', 'SegmentSky'], 'type' => 'directory', - 'children' => [ - 'ChangeSky', - 'ParseFace', - 'RefineMask', - 'SegmentBody', - 'SegmentCloth', - 'SegmentCommodity', - 'SegmentCommonImage', - 'SegmentFood', - 'SegmentHair', - 'SegmentHDBody', - 'SegmentHDCommonImage', - 'SegmentHDSky', - 'SegmentHead', - 'SegmentSkin', - 'SegmentSky', - ], + 'title' => '分割', + 'id' => 335297, ], [ - 'id' => 64433, - 'title' => '结果', + 'children' => ['GetAsyncJobResult'], 'type' => 'directory', - 'children' => [ - 'GetAsyncJobResult', - ], + 'title' => '结果', + 'id' => 335319, ], ], 'components' => [ @@ -42,14 +20,8 @@ ], 'apis' => [ 'ChangeSky' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -57,31 +29,17 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - ], + 'systemTags' => ['operationType' => 'update'], 'parameters' => [ [ 'name' => 'ImageURL', 'in' => 'query', - 'schema' => [ - 'description' => '需要替换天空的目标图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/ChangeSky/ChangeSky2.jpg', - 'isFileTransferUrl' => true, - ], + 'schema' => ['description' => '需要替换天空的目标图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n", 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/ChangeSky/ChangeSky2.jpg', 'isFileTransferUrl' => true], ], [ 'name' => 'ReplaceImageURL', 'in' => 'query', - 'schema' => [ - 'description' => '参考图URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/ChangeSky/ChangeSky6.jpg', - 'isFileTransferUrl' => true, - ], + 'schema' => ['description' => '参考图URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n", 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/ChangeSky/ChangeSky6.jpg', 'isFileTransferUrl' => true], ], ], 'responses' => [ @@ -89,52 +47,33 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'F9D60817-EC5A-4BAC-9092-4AD42220CFA8', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'F9D60817-EC5A-4BAC-9092-4AD42220CFA8'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'ImageURL' => [ - 'description' => '替换后的图像URL地址。'."\n" - .'抠图之后返回四通道PNG图，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_skySegmentator/2020-7-24/invi_skySegmentator_015955791588111000000_5pn2QM.jpg?Expires=1595580958&OSSAccessKeyId=LTAI****************&Signature=Sq4po8h3WAj%2BBFrCgTP3ghlXn4****', - ], + 'ImageURL' => ['description' => '替换后的图像URL地址。'."\n" + .'抠图之后返回四通道PNG图，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_skySegmentator/2020-7-24/invi_skySegmentator_015955791588111000000_5pn2QM.jpg?Expires=1595580958&OSSAccessKeyId=LTAI****************&Signature=Sq4po8h3WAj%2BBFrCgTP3ghlXn4****'], ], ], ], + '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' => '授权失败，请检查RAM权限配置，操作流程可参考https://help.aliyun.com/document_detail/145025.htm。'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '算法服务报错，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。 '], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"F9D60817-EC5A-4BAC-9092-4AD42220CFA8\\",\\n \\"Data\\": {\\n \\"ImageURL\\": \\"http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_skySegmentator/2020-7-24/invi_skySegmentator_015955791588111000000_5pn2QM.jpg?Expires=1595580958&OSSAccessKeyId=LTAI****************&Signature=Sq4po8h3WAj%2BBFrCgTP3ghlXn4****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<ChangeSkyResponse>\\n <RequestId>F9D60817-EC5A-4BAC-9092-4AD42220CFA8</RequestId>\\n <Data>\\n <ImageURL>http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_skySegmentator/2020-7-24/invi_skySegmentator_015955791588111000000_5pn2QM.jpg?Expires=1595580958&OSSAccessKeyId=LTAI****************&Signature=Sq4po8h3WAj%2BBFrCgTP3ghlXn4****</ImageURL>\\n </Data>\\n</ChangeSkyResponse>","errorExample":""}]', @@ -190,141 +129,120 @@ .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'ParseFace' => [ - 'methods' => [ - 'post', - 'get', + 'changeSet' => [ + ['createdAt' => '2022-11-18T05:36:20.000Z', 'description' => '请求参数发生变更'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ChangeSky'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'viapi-imageseg:ChangeSky', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'GetAsyncJobResult' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ - 'name' => 'ImageURL', - 'in' => 'query', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/ParseFace/ParseFace1.jpg', - 'isFileTransferUrl' => true, - ], + 'name' => 'JobId', + 'in' => 'formData', + 'schema' => ['description' => '异步接口返回的RequestId，输入后可以查询异步接口的真实请求结果。', 'type' => 'string', 'required' => true, 'example' => 'E75FE679-0303-4DD1-8252-1143B4FA8A27'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'D6C24839-91A7-41DA-B31F-98F08EF80CC0', - ], + 'RequestId' => ['description' => '请求ID。'."\n" + ."\n", 'type' => 'string', 'example' => '43A0AEB6-45F4-4138-8E89-E1A5D63200E3'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'Elements' => [ - 'description' => '各个子元素的分割结果。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'ImageURL' => [ - 'description' => '抠图结果。'."\n" - .'抠图之后返回四通道PNG图，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/fivesensesegmenter/prod/560FA2E7-FDC6-59A5-ABDD-D62A05146734/skin/_18dd_20211231-040658.png?Expires=1640925418&OSSAccessKeyId=LTAI****************&Signature=2g0M88wZl%2Bn4t4gzQX%2BTIskpWB****', - ], - 'Name' => [ - 'description' => '抠图结果key值。具体请参见下方表格说明。', - 'type' => 'string', - 'example' => 'skin', - ], - ], - ], - ], - 'OriginImageURL' => [ - 'description' => '原始图像URL地址。', - 'type' => 'string', - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/ParseFace/ParseFace1.jpg', - ], + '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' => '{"ImageUrl":"http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_/2020-4-2/invi__015858226731531000018_UE7B9p.png?Expires=1585824473&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSR****&Signature=etyeYQQ%2BWAyQTqQKd8Xq0GiOW****"}'], + 'ErrorCode' => ['description' => '异步任务错误码。', 'type' => 'string', 'example' => 'InvalidParameter'], + 'JobId' => ['description' => '异步任务ID。', 'type' => 'string', 'example' => '49E2CC28-ED1D-4CC5-854D-7D0AE2B20976'], ], ], ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D6C24839-91A7-41DA-B31F-98F08EF80CC0\\",\\n \\"Data\\": {\\n \\"Elements\\": [\\n {\\n \\"ImageURL\\": \\"http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/fivesensesegmenter/prod/560FA2E7-FDC6-59A5-ABDD-D62A05146734/skin/_18dd_20211231-040658.png?Expires=1640925418&OSSAccessKeyId=LTAI****************&Signature=2g0M88wZl%2Bn4t4gzQX%2BTIskpWB****\\",\\n \\"Name\\": \\"skin\\"\\n }\\n ],\\n \\"OriginImageURL\\": \\"http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/ParseFace/ParseFace1.jpg\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<ParseFaceResponse>\\n <RequestId>318E490D-6955-5720-B1B4-31093242D00A</RequestId>\\n <Data>\\n <OriginImageURL>http://viapi-test.oss-cn-shanghai-internal.aliyuncs.com/viapi-3.0domepic/imageseg/ParseFace/ParseFace1.jpg</OriginImageURL>\\n <Elements>\\n <ImageURL>http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/fivesensesegmenter/prod/318E490D-6955-5720-B1B4-31093242D00A/skin/_e3ab_20211231-040959.png?Expires=1640925599&OSSAccessKeyId=LTAI****************&Signature=68Z1rRQT47o0501Ai5aJWH50ml****</ImageURL>\\n <Name>skin</Name>\\n </Elements>\\n <Elements>\\n <ImageURL>http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/fivesensesegmenter/prod/318E490D-6955-5720-B1B4-31093242D00A/l_brow/_7f24_20211231-040959.png?Expires=1640925599&OSSAccessKeyId=LTAI****************&Signature=a8MVO5zFhL%2BA93Yce4DucIPGB%2B****</ImageURL>\\n <Name>l_brow</Name>\\n </Elements>\\n <Elements>\\n <ImageURL>http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/fivesensesegmenter/prod/318E490D-6955-5720-B1B4-31093242D00A/r_brow/_2d2a_20211231-040959.png?Expires=1640925599&OSSAccessKeyId=LTAI****************&Signature=LjwcSshnOV1dhPbx5OjhQkwLaZ****</ImageURL>\\n <Name>r_brow</Name>\\n </Elements>\\n <Elements>\\n <ImageURL>http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/fivesensesegmenter/prod/318E490D-6955-5720-B1B4-31093242D00A/l_eye/_5ba8_20211231-040959.png?Expires=1640925599&OSSAccessKeyId=LTAI****************&Signature=Ak6hAp5%2BWUiexlyUJSAL7PpC9g****</ImageURL>\\n <Name>l_eye</Name>\\n </Elements>\\n <Elements>\\n <ImageURL>http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/fivesensesegmenter/prod/318E490D-6955-5720-B1B4-31093242D00A/r_eye/_03f3_20211231-040959.png?Expires=1640925599&OSSAccessKeyId=LTAI****************&Signature=0IfJ%2BXtOLTofKuMyru7G3DYIlU****</ImageURL>\\n <Name>r_eye</Name>\\n </Elements>\\n <Elements>\\n <ImageURL>http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/fivesensesegmenter/prod/318E490D-6955-5720-B1B4-31093242D00A/l_ear/_2722_20211231-040959.png?Expires=1640925599&OSSAccessKeyId=LTAI****************&Signature=OfvsQuZ4Xb7hgvG6snbSK6%2BoWL****</ImageURL>\\n <Name>l_ear</Name>\\n </Elements>\\n <Elements>\\n <ImageURL>http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/fivesensesegmenter/prod/318E490D-6955-5720-B1B4-31093242D00A/r_ear/_4c72_20211231-040959.png?Expires=1640925599&OSSAccessKeyId=LTAI****************&Signature=wTvhMOjb7Yxu9TSuysoNqr0Jtx****</ImageURL>\\n <Name>r_ear</Name>\\n </Elements>\\n <Elements>\\n <ImageURL>http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/fivesensesegmenter/prod/318E490D-6955-5720-B1B4-31093242D00A/nose/_f37f_20211231-040959.png?Expires=1640925599&OSSAccessKeyId=LTAI****************&Signature=kfQPM6LEiZQX7jq6UkDPNsCM3Z****</ImageURL>\\n <Name>nose</Name>\\n </Elements>\\n <Elements>\\n <ImageURL>http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/fivesensesegmenter/prod/318E490D-6955-5720-B1B4-31093242D00A/mouth/_75d9_20211231-040959.png?Expires=1640925599&OSSAccessKeyId=LTAI****************&Signature=pYe9WwXzhy9008SGx1OiZwdVWl****</ImageURL>\\n <Name>mouth</Name>\\n </Elements>\\n <Elements>\\n <ImageURL>http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/fivesensesegmenter/prod/318E490D-6955-5720-B1B4-31093242D00A/u_lip/_e7ae_20211231-040959.png?Expires=1640925599&OSSAccessKeyId=LTAI****************&Signature=4prsADyajiJvxud5syDNanBiOr****</ImageURL>\\n <Name>u_lip</Name>\\n </Elements>\\n <Elements>\\n <ImageURL>http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/fivesensesegmenter/prod/318E490D-6955-5720-B1B4-31093242D00A/l_lip/_35e6_20211231-040959.png?Expires=1640925599&OSSAccessKeyId=LTAI****************&Signature=sFeMY%2B5u0TgyqhHplY4z3qvxVn****</ImageURL>\\n <Name>l_lip</Name>\\n </Elements>\\n </Data>\\n</ParseFaceResponse>","errorExample":""}]', - 'title' => '五官分割', - 'summary' => '本文档为您介绍五官分割ParseFace的语法及示例。', - 'description' => '## 服务说明'."\n" - .'由于产品业务调整，五官分割服务于 即日起停止新用户开通调用，历史开通过该服务的老用户可继续调用，2026年04月20日后该服务将下架，不再支持新老用户调用，请尽早寻找替代方案。如果对五官分割 API 服务使用有疑问，可通过搜索钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"43A0AEB6-45F4-4138-8E89-E1A5D63200E3\\",\\n \\"Data\\": {\\n \\"Status\\": \\"PROCESS_SUCCESS\\",\\n \\"ErrorMessage\\": \\"paramsIllegal\\",\\n \\"Result\\": \\"{\\\\\\"ImageUrl\\\\\\":\\\\\\"http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_/2020-4-2/invi__015858226731531000018_UE7B9p.png?Expires=1585824473&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSR****&Signature=etyeYQQ%2BWAyQTqQKd8Xq0GiOW****\\\\\\"}\\",\\n \\"ErrorCode\\": \\"InvalidParameter\\",\\n \\"JobId\\": \\"49E2CC28-ED1D-4CC5-854D-7D0AE2B20976\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetAsyncJobResultResponse>\\n <RequestId>43A0AEB6-45F4-4138-8E89-E1A5D63200E3</RequestId>\\n <Data>\\n <Status>PROCESS_SUCCESS</Status>\\n <JobId>186AC396-0EEC-46F1-AAA1-BF3585227427</JobId>\\n <Result>{\\"ImageUrl\\":\\"http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_/2020-4-2/invi__015858228333801000019_zs0HOi.png?Expires=1585824633&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSR*****&Signature=YHSg24oLm3yk*****%3D\\"}</Result>\\n <status>PROCESS_SUCCESS</status>\\n </Data>\\n</GetAsyncJobResultResponse>","errorExample":""}]', + 'title' => '查询异步任务结果', + 'summary' => '本文介绍查询异步任务结果GetAsyncJobResult的语法及示例。', + 'description' => '# 功能描述'."\n" ."\n" - .'## 功能描述'."\n" - .'五官分割能力可以检测输入的人脸正面图像，对眼睛、鼻子、嘴进行像素级语义分割。'."\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" + .'当前分割抠图类目中通用高清分割（SegmentHDCommonImage）为异步接口，需要调用GetAsyncJobResult来获取真实的请求结果。'."\n" + ."\n\n", + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => '## SDK参考'."\n" + .'阿里云视觉AI能力推荐使用SDK调用，支持多种编程语言，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', + 'extraInfo' => '## Result反序列化'."\n" ."\n" - .'- 图像格式：JPG、JPEG 、PNG。'."\n" - .'- 图像大小：不超过4 MB。'."\n" - .'- 图像分辨率：大于100×100像素，小于2048×2048像素，且宽高比在0.5~2.0之间。'."\n" - .'- 图像中仅包含单个人脸，要求正面，无眼镜、帽子等遮挡物。人脸部分的面积大小至少在100×100像素，且人脸检测框至少是对应边长的1/10。'."\n" - .'- URL地址中不能包含中文字符。'."\n" + .'将上面Result反序列化展示如下。'."\n" ."\n" - .'## 计费说明'."\n" - .'关于五官分割的计费方式及报价，请参见[计费介绍](~~190132~~)。'."\n" + .'```'."\n" + .'{'."\n" + .' "ImageUrl": "http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_/2020-4-2/invi__015858228333801000019_zs0HOi.png?Expires=1585824633&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSR*****&Signature=YHSg24oLm3yk********%3D"'."\n" + .'}'."\n" + .'```'."\n" ."\n" - .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=imageseg&children=ParseFace)。', - 'requestParamsDescription' => ' ', - 'responseParamsDescription' => '### 抠图结果key值说明'."\n" - ."\n" - .'| name值 | 类型 | 是否必须 | 描述 |'."\n" - .'|--------|---------|----------|-------------|'."\n" - .'| skin | string| 是 | 脸部皮肤的分割结果。 |'."\n" - .'| l_brow | string| 是 | 左眉毛的分割结果。 |'."\n" - .'| r_brow | string| 是 |右眉毛的分割结果。 |'."\n" - .'| l_eye | string| 是 | 左眼睛的分割结果。 |'."\n" - .'| r_eye | string| 是 | 右眼睛的分割结果。 |'."\n" - .'| nose| string| 是 | 鼻子的分割结果。 |'."\n" - .'| l_ear| string| 否 | 左耳的分割结果。 |'."\n" - .'| r_ear| string| 否 | 右耳的分割结果。 |'."\n" - .'| mouth| string| 否 |上下嘴唇中间部分的分割结果。若人物为闭嘴状态，则不会输出。 |'."\n" - .'| u_lip| string| 是 | 上嘴唇的分割结果。 |'."\n" - .'| l_lip| string| 是 | 下嘴唇的分割结果。 |'."\n" + .'## 错误码'."\n" ."\n" - .'## SDK参考'."\n" - .'阿里云视觉AI分割抠图类目下的五官分割能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为分割抠图（imageseg）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', - 'extraInfo' => '## 错误码'."\n" - .'关于五官分割的错误码，详情请参见[常见错误码](~~146751~~)。'."\n" + .'详情请参见[常见错误码](~~146751~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', + 'changeSet' => [ + ['createdAt' => '2022-04-24T08:11:47.000Z', 'description' => '错误码发生变更'], + ], ], 'RefineMask' => [ - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -337,24 +255,12 @@ [ 'name' => 'MaskImageURL', 'in' => 'formData', - 'schema' => [ - 'description' => '与输入图像对应的粗糙Mask图像。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/RefineMask/RefineMask6.jpg', - 'isFileTransferUrl' => true, - ], + 'schema' => ['description' => '与输入图像对应的粗糙Mask图像。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/RefineMask/RefineMask6.jpg', 'isFileTransferUrl' => true], ], [ '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/imageseg/RefineMask/RefineMask1.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/imageseg/RefineMask/RefineMask1.jpg', 'isFileTransferUrl' => true], ], ], 'responses' => [ @@ -362,11 +268,7 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'E948F80B-86D9-54E0-9FF9-ACF3B1DA83C4', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'E948F80B-86D9-54E0-9FF9-ACF3B1DA83C4'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', @@ -377,18 +279,16 @@ 'items' => [ 'type' => 'object', 'properties' => [ - 'ImageURL' => [ - 'description' => '输出的精细化Mask的图像URL地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://algo-app-taobao-mm-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/pixelai-portrait-beauty%2F2020_03_04%2F61f544a1a5004c88a2bf29452db494e9.jpeg?OSSAccessKeyId=LTAI****************&Expires=1583406122&Signature=Heet1ivG0xFP3YlO6usvd0pmrH****', - ], + 'ImageURL' => ['description' => '输出的精细化Mask的图像URL地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://algo-app-taobao-mm-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/pixelai-portrait-beauty%2F2020_03_04%2F61f544a1a5004c88a2bf29452db494e9.jpeg?OSSAccessKeyId=LTAI****************&Expires=1583406122&Signature=Heet1ivG0xFP3YlO6usvd0pmrH****'], ], + 'description' => '', ], ], ], ], ], + 'description' => '', ], ], ], @@ -452,16 +352,13 @@ .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', + 'changeSet' => [ + ['createdAt' => '2022-09-29T08:00:10.000Z', 'description' => '请求参数发生变更'], + ], ], 'SegmentBody' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -474,37 +371,26 @@ [ 'name' => 'ImageURL', 'in' => 'query', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" - .'图片格式要求：'."\n" - ."\n" - .'- 图像格式：JPEG、JPG、PNG（不支持8位、16位、64位PNG）、BMP、WEBP。'."\n" - .'- 图像大小：不超过3 MB。'."\n" - .'- 图像分辨率：小于2000×2000像素。'."\n" - .'- URL地址中不能包含中文字符。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/SegmentBody/SegmentBody1.png', - 'isFileTransferUrl' => true, - ], + 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" + .'图片格式要求：'."\n" + ."\n" + .'- 图像格式：JPEG、JPG、PNG（不支持8位、16位、64位PNG）、BMP、WEBP。'."\n" + .'- 图像大小：不超过3 MB。'."\n" + .'- 图像分辨率：小于2000×2000像素。'."\n" + .'- URL地址中不能包含中文字符。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/SegmentBody/SegmentBody1.png', 'isFileTransferUrl' => true], ], [ 'name' => 'ReturnForm', 'in' => 'query', - 'schema' => [ - 'description' => '指定返回的图像形式。'."\n" - ."\n" - .'- 如果设置为`mask`，则返回单通道黑白图。'."\n" - ."\n" - .'- 如果设置为`crop`，则返回裁剪之后的四通道PNG图（裁掉边缘空白区域）。'."\n" - ."\n" - .'- 如果设置为`whiteBK`，则返回白底图。'."\n" - ."\n" - .'- 如果不设置或者设置为其他值，则返回四通道PNG图。', - 'type' => 'string', - 'required' => false, - 'example' => 'mask', - ], + 'schema' => ['description' => '指定返回的图像形式。'."\n" + ."\n" + .'- 如果设置为`mask`，则返回单通道黑白图。'."\n" + ."\n" + .'- 如果设置为`crop`，则返回裁剪之后的四通道PNG图（裁掉边缘空白区域）。'."\n" + ."\n" + .'- 如果设置为`whiteBK`，则返回白底图。'."\n" + ."\n" + .'- 如果不设置或者设置为其他值，则返回四通道PNG图。', 'type' => 'string', 'required' => false, 'example' => 'mask'], ], ], 'responses' => [ @@ -512,30 +398,23 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '30EDCEEA-2806-44C6-AF0B-0988849106FE', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '30EDCEEA-2806-44C6-AF0B-0988849106FE'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'ImageURL' => [ - 'description' => '结果图像URL地址。'."\n" - .'请求参数指定返回的图像形式。'."\n" - .'- 如果设置为`mask`，则返回单通道黑白图。'."\n" - .'- 如果设置为`crop`，则返回裁剪之后的四通道PNG图（裁掉边缘空白区域）。'."\n" - .'- 如果设置为`whiteBK`，则返回白底图。'."\n" - .'- 如果不设置或者设置为其他值，则返回四通道PNG图，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" - ."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_humansegmenter/2021-3-31/invi_humansegmenter_016171823500001081370_Ej0WwO.jpg?Expires=1617184150&OSSAccessKeyId=LTAI****************&Signature=ZwaWXpAOMzHar%2B1wVO7zeSD83r****', - ], + 'ImageURL' => ['description' => '结果图像URL地址。'."\n" + .'请求参数指定返回的图像形式。'."\n" + .'- 如果设置为`mask`，则返回单通道黑白图。'."\n" + .'- 如果设置为`crop`，则返回裁剪之后的四通道PNG图（裁掉边缘空白区域）。'."\n" + .'- 如果设置为`whiteBK`，则返回白底图。'."\n" + .'- 如果不设置或者设置为其他值，则返回四通道PNG图，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" + ."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_humansegmenter/2021-3-31/invi_humansegmenter_016171823500001081370_Ej0WwO.jpg?Expires=1617184150&OSSAccessKeyId=LTAI****************&Signature=ZwaWXpAOMzHar%2B1wVO7zeSD83r****'], ], ], ], + 'description' => '', ], ], ], @@ -614,16 +493,31 @@ .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'SegmentCloth' => [ - 'methods' => [ - 'post', - 'get', + 'changeSet' => [ + ['createdAt' => '2022-11-01T05:49:48.000Z', 'description' => '请求参数发生变更'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SegmentBody'], + ], ], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-imageseg:SegmentBody', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + ], + ], + 'SegmentCloth' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -631,35 +525,21 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - ], + 'systemTags' => ['operationType' => 'none'], 'parameters' => [ [ 'name' => 'ImageURL', 'in' => 'query', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/SegmentCloth/SegmentCloth1.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/imageseg/SegmentCloth/SegmentCloth1.jpg', 'isFileTransferUrl' => true], ], [ 'name' => 'OutMode', 'in' => 'query', - 'schema' => [ - 'description' => '返回分割结果的类型，影响ImageURL字段的返回内容，用户非必选。'."\n" - ."\n" - .'- 0（默认值）：默认的主体服饰分割结果。'."\n" - ."\n" - .'- 1：用户指定class类别的组合分割结果。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '0或1', - ], + 'schema' => ['description' => '返回分割结果的类型，影响ImageURL字段的返回内容，用户非必选。'."\n" + ."\n" + .'- 0（默认值）：默认的主体服饰分割结果。'."\n" + ."\n" + .'- 1：用户指定class类别的组合分割结果。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '0或1'], ], [ 'name' => 'ClothClass', @@ -675,19 +555,14 @@ .'- shoes：鞋子'."\n" .'- hat：帽子', 'type' => 'array', - 'items' => [ - 'description' => '服饰类别。可一次传入多个值。取值范围：'."\n" - .'- tops：上衣'."\n" - .'- coat：外套'."\n" - .'- skirt：裙装'."\n" - .'- pants：裤装'."\n" - .'- bag：包类'."\n" - .'- shoes：鞋子'."\n" - .'- hat：帽子', - 'type' => 'string', - 'required' => false, - 'example' => 'tops', - ], + 'items' => ['description' => '服饰类别。可一次传入多个值。取值范围：'."\n" + .'- tops：上衣'."\n" + .'- coat：外套'."\n" + .'- skirt：裙装'."\n" + .'- pants：裤装'."\n" + .'- bag：包类'."\n" + .'- shoes：鞋子'."\n" + .'- hat：帽子', 'type' => 'string', 'required' => false, 'example' => 'tops'], 'required' => false, 'maxItems' => 15, ], @@ -695,17 +570,12 @@ [ 'name' => 'ReturnForm', 'in' => 'query', - 'schema' => [ - 'description' => '指定返回的图像格式，取值范围：'."\n" - ."\n" - .'- whiteBK：返回白底图。'."\n" - .'- mask：返回单通道mask。'."\n" - .'- 如果不设置，则返回四通道PNG图。'."\n" - .'> - 该参数的设置只对输出结果的ImageURL有效，对ClassUrl无效，ClassUrl固定返回的是mask通道图。', - 'type' => 'string', - 'required' => false, - 'example' => 'whiteBK', - ], + 'schema' => ['description' => '指定返回的图像格式，取值范围：'."\n" + ."\n" + .'- whiteBK：返回白底图。'."\n" + .'- mask：返回单通道mask。'."\n" + .'- 如果不设置，则返回四通道PNG图。'."\n" + .'> - 该参数的设置只对输出结果的ImageURL有效，对ClassUrl无效，ClassUrl固定返回的是mask通道图。', 'type' => 'string', 'required' => false, 'example' => 'whiteBK'], ], ], 'responses' => [ @@ -713,11 +583,7 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'BCE049A3-FE69-41CF-A870-5970156388A7', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'BCE049A3-FE69-41CF-A870-5970156388A7'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', @@ -729,23 +595,15 @@ 'description' => '返回元素的数组。', 'type' => 'object', 'properties' => [ - 'ImageURL' => [ - 'description' => '返回抠图结果图像URL地址。'."\n" - .'抠图之后返回四通道PNG图，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/clothingsegmentation-2020-06-17-16-54-40-688c84cbbd-hnqfq/2020-6-18/invi__015924459307821000041_IIVHoM.png?Expires=1592447730&OSSAccessKeyId=LTAI****************&Signature=Hy8pn3IQj8nuKN0LEaC57cee9L****', - ], + 'ImageURL' => ['description' => '返回抠图结果图像URL地址。'."\n" + .'抠图之后返回四通道PNG图，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/clothingsegmentation-2020-06-17-16-54-40-688c84cbbd-hnqfq/2020-6-18/invi__015924459307821000041_IIVHoM.png?Expires=1592447730&OSSAccessKeyId=LTAI****************&Signature=Hy8pn3IQj8nuKN0LEaC57cee9L****'], 'ClassUrl' => [ 'description' => '根据用户输入的`clothClass`返回一个服饰类别对应的URL。'."\n" .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'object', - 'additionalProperties' => [ - 'type' => 'string', - 'example' => '{\'tops\':http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/..,\'hat\':http://viapi-cn-shanghai-dha-segmenter...,...}', - 'description' => '根据用户输入的`clothClass`返回一个服饰类别对应的URL。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - ], + 'additionalProperties' => ['type' => 'string', 'example' => '{\'tops\':http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/..,\'hat\':http://viapi-cn-shanghai-dha-segmenter...,...}', 'description' => '根据用户输入的`clothClass`返回一个服饰类别对应的URL。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。'], ], ], ], @@ -753,6 +611,7 @@ ], ], ], + 'description' => '', ], ], ], @@ -832,16 +691,20 @@ .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'SegmentCommodity' => [ - 'methods' => [ - 'post', - 'get', + 'changeSet' => [ + ['createdAt' => '2024-07-19T02:14:58.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-12-06T02:08:23.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ['createdAt' => '2022-03-30T06:07:10.000Z', 'description' => '错误码发生变更'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SegmentCloth'], + ], ], + ], + 'SegmentCommodity' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -854,34 +717,23 @@ [ 'name' => 'ImageURL', 'in' => 'query', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" - .'图片格式要求：'."\n" - ."\n" - .'- 图像格式：JPEG、JPG、PNG（不支持8位、16位、64位PNG）、BMP。'."\n" - .'- 图像大小：不超过3 MB。'."\n" - .'- 图像分辨率：小于2000×2000像素。'."\n" - .'- URL地址中不能包含中文字符。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/SegmentCommodity/SegmentCommodity1.jpg', - 'isFileTransferUrl' => true, - ], + 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" + .'图片格式要求：'."\n" + ."\n" + .'- 图像格式：JPEG、JPG、PNG（不支持8位、16位、64位PNG）、BMP。'."\n" + .'- 图像大小：不超过3 MB。'."\n" + .'- 图像分辨率：小于2000×2000像素。'."\n" + .'- URL地址中不能包含中文字符。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/SegmentCommodity/SegmentCommodity1.jpg', 'isFileTransferUrl' => true], ], [ 'name' => 'ReturnForm', 'in' => 'query', - 'schema' => [ - 'description' => '指定返回的图像形式。'."\n" - ."\n" - .'- 如果不设置，则返回四通道PNG图。'."\n" - .'- 如果设置为`mask`，则返回单通道mask。'."\n" - .'- 如果设置为`whiteBK`，则返回白底图。'."\n" - .'- 如果设置为`crop`，则返回裁剪之后的四通道PNG图（裁掉边缘空白区域）。'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'mask', - ], + 'schema' => ['description' => '指定返回的图像形式。'."\n" + ."\n" + .'- 如果不设置，则返回四通道PNG图。'."\n" + .'- 如果设置为`mask`，则返回单通道mask。'."\n" + .'- 如果设置为`whiteBK`，则返回白底图。'."\n" + .'- 如果设置为`crop`，则返回裁剪之后的四通道PNG图（裁掉边缘空白区域）。'."\n", 'type' => 'string', 'required' => false, 'example' => 'mask'], ], ], 'responses' => [ @@ -889,30 +741,23 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'D6C24839-91A7-41DA-B31F-98F08EF80CC0', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'D6C24839-91A7-41DA-B31F-98F08EF80CC0'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'ImageURL' => [ - 'description' => '结果图像URL地址。'."\n" - .'请求参数指定返回的图像形式。'."\n" - ."\n" - .'- 如果设置为`crop`，则返回裁剪之后的四通道PNG图（裁掉边缘空白区域）。'."\n" - .'- 如果设置为`mask`，则返回单通道mask。'."\n" - .'- 如果设置为`whiteBK`，则返回白底图。'."\n" - .'- 如果不设置，则返回四通道PNG图，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://luban-vgd-invi.oss-cn-hangzhou.aliyuncs.com/upload/result_segmenter/2019-12-20/invi_segmenter_015768355410261076021_Z3t0fc.png?Expires=1577094741&OSSAccessKeyId=LTAI****************&Signature=pkaKK3VlfsTR2r%2BYycJzTVEEos****', - ], + 'ImageURL' => ['description' => '结果图像URL地址。'."\n" + .'请求参数指定返回的图像形式。'."\n" + ."\n" + .'- 如果设置为`crop`，则返回裁剪之后的四通道PNG图（裁掉边缘空白区域）。'."\n" + .'- 如果设置为`mask`，则返回单通道mask。'."\n" + .'- 如果设置为`whiteBK`，则返回白底图。'."\n" + .'- 如果不设置，则返回四通道PNG图，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://luban-vgd-invi.oss-cn-hangzhou.aliyuncs.com/upload/result_segmenter/2019-12-20/invi_segmenter_015768355410261076021_Z3t0fc.png?Expires=1577094741&OSSAccessKeyId=LTAI****************&Signature=pkaKK3VlfsTR2r%2BYycJzTVEEos****'], ], ], ], + 'description' => '', ], ], ], @@ -987,16 +832,29 @@ .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'SegmentCommonImage' => [ - 'methods' => [ - 'post', - 'get', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SegmentCommodity'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-imageseg:SegmentCommodity', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'SegmentCommonImage' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -1009,34 +867,23 @@ [ 'name' => 'ImageURL', 'in' => 'query', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" - .'图片格式要求：'."\n" - ."\n" - .'- 图像格式：JPEG、JPG、PNG（不支持8位、16位、64位PNG）、BMP、WEBP。'."\n" - .'- 图像大小：不超过3 MB。'."\n" - .'- 图像分辨率：大于32×32像素，小于2000×2000像素，最长边小于等于1999像素。'."\n" - .'- URL地址中不能包含中文字符。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/SegmentCommonImage/SegmentCommonImage1.jpg', - 'isFileTransferUrl' => true, - ], + 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" + .'图片格式要求：'."\n" + ."\n" + .'- 图像格式：JPEG、JPG、PNG（不支持8位、16位、64位PNG）、BMP、WEBP。'."\n" + .'- 图像大小：不超过3 MB。'."\n" + .'- 图像分辨率：大于32×32像素，小于2000×2000像素，最长边小于等于1999像素。'."\n" + .'- URL地址中不能包含中文字符。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/SegmentCommonImage/SegmentCommonImage1.jpg', 'isFileTransferUrl' => true], ], [ 'name' => 'ReturnForm', 'in' => 'query', - 'schema' => [ - 'description' => '指定返回的图像形式。'."\n" - ."\n" - .'- 如果不设置，则返回四通道PNG图。'."\n" - .'- 如果设置为`mask`，则返回单通道mask。'."\n" - .'- 如果设置为`whiteBK`，则返回白底图。'."\n" - .'- 如果设置为`crop`，则返回裁剪之后的四通道PNG图（裁掉边缘空白区域）。', - 'type' => 'string', - 'required' => false, - 'example' => 'mask', - ], + 'schema' => ['description' => '指定返回的图像形式。'."\n" + ."\n" + .'- 如果不设置，则返回四通道PNG图。'."\n" + .'- 如果设置为`mask`，则返回单通道mask。'."\n" + .'- 如果设置为`whiteBK`，则返回白底图。'."\n" + .'- 如果设置为`crop`，则返回裁剪之后的四通道PNG图（裁掉边缘空白区域）。', 'type' => 'string', 'required' => false, 'example' => 'mask'], ], ], 'responses' => [ @@ -1044,29 +891,22 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1B8BEF02-0672-44CA-A974-4D6FAC392497', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1B8BEF02-0672-44CA-A974-4D6FAC392497'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'ImageURL' => [ - 'description' => '结果图像URL地址。'."\n" - .'请求参数指定返回的图像形式。'."\n" - .'- 如果不设置，则返回四通道PNG图，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" - .'- 如果设置为`mask`，则返回单通道mask。'."\n" - .'- 如果设置为`whiteBK`，则返回白底图。'."\n" - .'- 如果设置为`crop`，则返回裁剪之后的四通道PNG图（裁掉边缘空白区域）。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://luban-vgd-invi.oss-cn-hangzhou.aliyuncs.com/upload/result_segmenter/2019-12-20/invi_segmenter_015768355410261076021_Z3t0fc.png?Expires=1577094741&OSSAccessKeyId=LTAI****************&Signature=pkaKK3VlfsTR2r%2BYycJzTVEEos****', - ], + 'ImageURL' => ['description' => '结果图像URL地址。'."\n" + .'请求参数指定返回的图像形式。'."\n" + .'- 如果不设置，则返回四通道PNG图，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" + .'- 如果设置为`mask`，则返回单通道mask。'."\n" + .'- 如果设置为`whiteBK`，则返回白底图。'."\n" + .'- 如果设置为`crop`，则返回裁剪之后的四通道PNG图（裁掉边缘空白区域）。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://luban-vgd-invi.oss-cn-hangzhou.aliyuncs.com/upload/result_segmenter/2019-12-20/invi_segmenter_015768355410261076021_Z3t0fc.png?Expires=1577094741&OSSAccessKeyId=LTAI****************&Signature=pkaKK3VlfsTR2r%2BYycJzTVEEos****'], ], ], ], + 'description' => '', ], ], ], @@ -1142,16 +982,29 @@ .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'SegmentFood' => [ - 'methods' => [ - 'post', - 'get', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SegmentCommonImage'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-imageseg:SegmentCommonImage', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'SegmentFood' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -1164,27 +1017,16 @@ [ 'name' => 'ImageURL', 'in' => 'query', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/SegmentFood/SegmentFood5.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/imageseg/SegmentFood/SegmentFood5.jpg', 'isFileTransferUrl' => true], ], [ 'name' => 'ReturnForm', 'in' => 'query', - 'schema' => [ - 'description' => '指定返回的图像形式。'."\n" - ."\n" - .'- 如果不设置，则返回四通道PNG图。'."\n" - .'- 如果设置为`mask`，则返回单通道mask。'."\n" - .'- 如果设置为`whiteBK`，则返回白底图。', - 'type' => 'string', - 'required' => false, - 'example' => 'mask', - ], + 'schema' => ['description' => '指定返回的图像形式。'."\n" + ."\n" + .'- 如果不设置，则返回四通道PNG图。'."\n" + .'- 如果设置为`mask`，则返回单通道mask。'."\n" + .'- 如果设置为`whiteBK`，则返回白底图。', 'type' => 'string', 'required' => false, 'example' => 'mask'], ], ], 'responses' => [ @@ -1192,25 +1034,18 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '38265D08-AD0F-4752-8E96-D1D9FB96C3D9', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '38265D08-AD0F-4752-8E96-D1D9FB96C3D9'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'ImageURL' => [ - 'description' => '返回抠图结果图像URL地址。'."\n" - .'抠图之后返回四通道PNG图，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/foodsegmenter-2020-06-17-15-24-00-8658fc85b8-8ds8k/2020-6-18/invi__015924442076191000002_WqJ99N.png?Expires=1592446007&OSSAccessKeyId=LTAI****************&Signature=5ITSd6ndSuP7pUfoDFpgLPUOGg****', - ], + 'ImageURL' => ['description' => '返回抠图结果图像URL地址。'."\n" + .'抠图之后返回四通道PNG图，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/foodsegmenter-2020-06-17-15-24-00-8658fc85b8-8ds8k/2020-6-18/invi__015924442076191000002_WqJ99N.png?Expires=1592446007&OSSAccessKeyId=LTAI****************&Signature=5ITSd6ndSuP7pUfoDFpgLPUOGg****'], ], ], ], + 'description' => '', ], ], ], @@ -1266,165 +1101,29 @@ .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'SegmentHair' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'security' => [ - [ - 'AK' => [], + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SegmentFood'], ], ], - 'operationType' => 'readAndWrite', - 'deprecated' => false, - 'systemTags' => [], - 'parameters' => [ + 'ramActions' => [ [ - 'name' => 'ImageURL', - 'in' => 'query', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/SegmentHair/SegmentHair1.jpg', - 'isFileTransferUrl' => true, - ], - ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'D6C24839-91A7-41DA-B31F-98F08EF80CC0', - ], - 'Data' => [ - 'description' => '返回的结果数据内容。', - 'type' => 'object', - 'properties' => [ - 'Elements' => [ - 'description' => '各个子元素的抠图结果。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'ImageURL' => [ - 'description' => '结果图像URL地址。'."\n" - .'抠图之后返回四通道PNG图，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_HeadSegmenter/2021-12-31/invi_HeadSegmenter_016409228383064285967296_iPLUXA.png?Expires=1640924638&OSSAccessKeyId=LTAI****************&Signature=wpKOqSar1bYvGmlTMryfEH2Q9I****', - ], - 'Width' => [ - 'description' => '结果图的宽度。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '113', - ], - 'Height' => [ - 'description' => '结果图的高度。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '180', - ], - 'Y' => [ - 'description' => '结果图左上角在原图中的y轴坐标。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '102', - ], - 'X' => [ - 'description' => '结果图左上角在原图中的x轴坐标。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '446', - ], - ], - ], - ], - ], - ], + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-imageseg:SegmentFood', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D6C24839-91A7-41DA-B31F-98F08EF80CC0\\",\\n \\"Data\\": {\\n \\"Elements\\": [\\n {\\n \\"ImageURL\\": \\"http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_HeadSegmenter/2021-12-31/invi_HeadSegmenter_016409228383064285967296_iPLUXA.png?Expires=1640924638&OSSAccessKeyId=LTAI****************&Signature=wpKOqSar1bYvGmlTMryfEH2Q9I****\\",\\n \\"Width\\": 113,\\n \\"Height\\": 180,\\n \\"Y\\": 102,\\n \\"X\\": 446\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"<SegmentHairResponse>\\n <RequestId>D6C24839-91A7-41DA-B31F-98F08EF80CC0</RequestId>\\n <Data>\\n <Elements>\\n <ImageURL>http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_HeadSegmenter/2021-12-31/invi_HeadSegmenter_016409228383064285967296_iPLUXA.png?Expires=1640924638&OSSAccessKeyId=LTAI****************&Signature=wpKOqSar1bYvGmlTMryfEH2Q9I****</ImageURL>\\n <Width>113</Width>\\n <Height>180</Height>\\n <Y>102</Y>\\n <X>446</X>\\n </Elements>\\n </Data>\\n</SegmentHairResponse>","errorExample":""}]', - 'title' => '头发分割', - 'summary' => '本文档介绍头发分割SegmentHair的语法及示例。', - 'description' => '## 功能描述'."\n" - .'头发分割能力用于识别图像中的人物头像，然后对人物头像区域进行抠图解析，最后输出PNG格式的人物头发矩形透明图。'."\n" - ."\n" - .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=imageseg&children=SegmentHair)对该能力进行更直观试用以及在线购买。'."\n" - .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" - ."\n" - .'## 应用场景'."\n" - ."\n" - .'- 假发网络试戴：通过头发分割，截取自拍照的头发后，换成假发图像，就可以直接看到假发试戴效果，省去了网购后佩戴不合适需要退换货的烦恼。'."\n" - .'- 理发店发型尝试：发型师指导客户通过平板电脑或手机拍摄的自己头像，换成各种发型，有更直观的感觉。客户可以选择最喜欢的发型，让发型师为自己打理。'."\n" - ."\n" - .'## 特色优势'."\n" - .'发丝边缘的精确分割：对发丝边缘可以精确分割，分割后图像编辑结果无违和感。'."\n" - ."\n" - .'## 接入指引'."\n" - .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" - .'2. 开通能力：请确保您已开通[分割抠图服务](https://vision.aliyun.com/imageseg)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_imageseg_public_cn#/open)。'."\n" - .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/imageseg/2019-12-30/SegmentHair?lang=JAVA&sdkStyle=dara¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fimageseg%2FSegmentHair%2FSegmentHair1.jpg%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" - .'5. 开发接入步骤：'."\n" - .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" - .'- 在对应语言的SDK文档中找到AI类目为分割抠图（imageseg）的SDK包进行安装。'."\n" - .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" - ."\n" - .'6. 示例代码：该能力常用语言的示例代码，请参见[头发分割示例代码](~~605130~~)。'."\n" - ."\n" - .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" - .'- [Web前端直接调用](~~467779~~)'."\n" - .'- [小程序场景下直接调用](~~467780~~)'."\n" - .'- [Android端直接调用](~~467781~~)'."\n" - .'- [iOS端直接调用](~~467782~~)'."\n" - ."\n" - .'## 输入限制'."\n" - .'- 图像格式：JPEG、JPG、PNG、BMP。'."\n" - .'- 图像大小：不超过3M。'."\n" - .'- 图像分辨率：大于32×32像素，小于2000×2000像素。'."\n" - .'- URL地址中不能包含中文字符。'."\n" - ."\n" - .'## 计费说明'."\n" - .'关于头发分割的计费方式及报价，请参见[计费介绍](~~190132~~)。'."\n" - ."\n" - .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=imageseg&children=SegmentHair)。', - 'requestParamsDescription' => ' ', - 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI分割抠图类目下的头发分割能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为分割抠图（imageseg）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" - ."\n" - .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[头发分割示例代码](~~605130~~)。', - 'extraInfo' => '## 错误码'."\n" - .'关于头发分割的错误码，详情请参见[常见错误码](~~146751~~)。'."\n" - ."\n" - .'## 安全声明'."\n" - .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', ], 'SegmentHDBody' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -1437,18 +1136,12 @@ [ 'name' => 'ImageURL', 'in' => 'query', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" - .'图片格式要求：'."\n" - .'- 图像格式：JPG、JPEG 、BMP、PNG（透明图）。'."\n" - .'- 图像大小：不超过40 MB 。'."\n" - .'- 图像分辨率：大于32×32像素，小于6000×6000像素，最长边小于等于6000像素。'."\n" - .'- URL地址中不能包含中文字符。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/SegmentHDBody/SegmentHDBody1.jpg', - 'isFileTransferUrl' => true, - ], + 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" + .'图片格式要求：'."\n" + .'- 图像格式：JPG、JPEG 、BMP、PNG（透明图）。'."\n" + .'- 图像大小：不超过40 MB 。'."\n" + .'- 图像分辨率：大于32×32像素，小于6000×6000像素，最长边小于等于6000像素。'."\n" + .'- URL地址中不能包含中文字符。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/SegmentHDBody/SegmentHDBody1.jpg', 'isFileTransferUrl' => true], ], ], 'responses' => [ @@ -1457,22 +1150,14 @@ 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'A8D3F5C3-E414-4981-8D84-E2CADF0B7CBC', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'A8D3F5C3-E414-4981-8D84-E2CADF0B7CBC'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'ImageURL' => [ - 'description' => '结果图像URL地址。'."\n" - .'输出图像在原始图像的3通道基础上增加alpha通道生成四通道PNG图像作为输出，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/segmenthdbody-2020-05-18-16-27-45-675d9884d7-kd9dz/2020-5-18/invi_humansegmenter_015897914589851000001_wQbLq9.png?Expires=1589793259&OSSAccessKeyId=LTAI****************&Signature=Lx6xSS0t7lqEvy5Qd1keccIAjL****', - ], + 'ImageURL' => ['description' => '结果图像URL地址。'."\n" + .'输出图像在原始图像的3通道基础上增加alpha通道生成四通道PNG图像作为输出，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/segmenthdbody-2020-05-18-16-27-45-675d9884d7-kd9dz/2020-5-18/invi_humansegmenter_015897914589851000001_wQbLq9.png?Expires=1589793259&OSSAccessKeyId=LTAI****************&Signature=Lx6xSS0t7lqEvy5Qd1keccIAjL****'], ], ], ], @@ -1545,16 +1230,29 @@ .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'SegmentHDCommonImage' => [ - 'methods' => [ - 'post', - 'get', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SegmentHDBody'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-imageseg:SegmentHDBody', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'SegmentHDCommonImage' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -1567,13 +1265,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/imageseg/SegmentHDCommonImage/SegmentHDCommonImage1.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/imageseg/SegmentHDCommonImage/SegmentHDCommonImage1.jpg', 'isFileTransferUrl' => true], ], ], 'responses' => [ @@ -1582,58 +1274,34 @@ 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'EC994171-7964-44B3-85AF-A715CB56747D', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'EC994171-7964-44B3-85AF-A715CB56747D'], 'Data' => [ 'description' => '返回的结果数据内容。'."\n" .'该数据需要在异步任务执行成功后，通过调用[GetAsyncJobResult](~~607824~~)接口，对其Result字段进行JSON反序列化之后得到。', 'type' => 'object', 'properties' => [ - 'ImageUrl' => [ - 'description' => '结果图像的URL地址。'."\n" - .'抠图之后返回四通道PNG图，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_commoditysegmenter/2020-10-27/invi_commoditysegmenter_016037842193171000000_5pn2QM.png?Expires=1603786019&OSSAccessKeyId=LTAI****************&Signature=HwUztguGBYXmXGEmuTh%2FL3ztoh****', - ], + 'ImageUrl' => ['description' => '结果图像的URL地址。'."\n" + .'抠图之后返回四通道PNG图，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_commoditysegmenter/2020-10-27/invi_commoditysegmenter_016037842193171000000_5pn2QM.png?Expires=1603786019&OSSAccessKeyId=LTAI****************&Signature=HwUztguGBYXmXGEmuTh%2FL3ztoh****'], ], ], - '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' => '授权失败，请检查RAM权限配置，操作流程可参考https://help.aliyun.com/document_detail/145025.htm。'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '算法服务报错，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。 '], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"EC994171-7964-44B3-85AF-A715CB56747D\\",\\n \\"Data\\": {\\n \\"ImageUrl\\": \\"http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_commoditysegmenter/2020-10-27/invi_commoditysegmenter_016037842193171000000_5pn2QM.png?Expires=1603786019&OSSAccessKeyId=LTAI****************&Signature=HwUztguGBYXmXGEmuTh%2FL3ztoh****\\"\\n },\\n \\"Message\\": \\"该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"<SegmentHDCommonImageResponse>\\n <RequestId>EC994171-7964-44B3-85AF-A715CB56747D</RequestId>\\n <Message>该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>\\n</SegmentHDCommonImageResponse>","errorExample":""}]', @@ -1696,16 +1364,31 @@ .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'SegmentHDSky' => [ - 'methods' => [ - 'post', - 'get', + 'changeSet' => [ + ['createdAt' => '2022-10-17T02:04:01.000Z', 'description' => '响应参数发生变更'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SegmentHDCommonImage'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-imageseg:SegmentHDCommonImage', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'SegmentHDSky' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -1718,13 +1401,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/imageseg/SegmentHDSky/SegmentHDSky4.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/imageseg/SegmentHDSky/SegmentHDSky4.jpg', 'isFileTransferUrl' => true], ], ], 'responses' => [ @@ -1732,52 +1409,33 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '1173F38F-B4F4-4A07-AB2E-D490C01347E5', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '1173F38F-B4F4-4A07-AB2E-D490C01347E5'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'ImageURL' => [ - 'description' => '分割后的图像URL地址。'."\n" - .'抠图之后返回四通道PNG图，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/sky-segmentation-hd/res/1173F38F-B4F4-4A07-AB2E-D490C01347E5_0d56_20201027-061858.jpg?Expires=1603781339&OSSAccessKeyId=LTAI****************&Signature=2F8%2Bj%2FWruWOMqDezwpnJOkcNJD****', - ], + 'ImageURL' => ['description' => '分割后的图像URL地址。'."\n" + .'抠图之后返回四通道PNG图，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/sky-segmentation-hd/res/1173F38F-B4F4-4A07-AB2E-D490C01347E5_0d56_20201027-061858.jpg?Expires=1603781339&OSSAccessKeyId=LTAI****************&Signature=2F8%2Bj%2FWruWOMqDezwpnJOkcNJD****'], ], ], ], + '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' => '授权失败，请检查RAM权限配置，操作流程可参考https://help.aliyun.com/document_detail/145025.htm。'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '算法服务报错，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。 '], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1173F38F-B4F4-4A07-AB2E-D490C01347E5\\",\\n \\"Data\\": {\\n \\"ImageURL\\": \\"http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/sky-segmentation-hd/res/1173F38F-B4F4-4A07-AB2E-D490C01347E5_0d56_20201027-061858.jpg?Expires=1603781339&OSSAccessKeyId=LTAI****************&Signature=2F8%2Bj%2FWruWOMqDezwpnJOkcNJD****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<SegmentHDSkyResponse>\\n <RequestId>1173F38F-B4F4-4A07-AB2E-D490C01347E5</RequestId>\\n <Data>\\n <ImageURL>http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/sky-segmentation-hd/res/1173F38F-B4F4-4A07-AB2E-D490C01347E5_0d56_20201027-061858.jpg?Expires=1603781339&OSSAccessKeyId=LTAI****************&Signature=2F8%2Bj%2FWruWOMqDezwpnJOkcNJD****</ImageURL>\\n </Data>\\n</SegmentHDSkyResponse>","errorExample":""}]', @@ -1847,16 +1505,29 @@ .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'SegmentHead' => [ - 'methods' => [ - 'post', - 'get', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SegmentHDSky'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-imageseg:SegmentHDSky', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'SegmentHair' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -1869,26 +1540,147 @@ [ 'name' => 'ImageURL', 'in' => 'query', + 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/SegmentHair/SegmentHair1.jpg', 'isFileTransferUrl' => true], + ], + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/SegmentHead/SegmentHead1.jpg', - 'isFileTransferUrl' => true, + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'D6C24839-91A7-41DA-B31F-98F08EF80CC0'], + 'Data' => [ + 'description' => '返回的结果数据内容。', + 'type' => 'object', + 'properties' => [ + 'Elements' => [ + 'description' => '各个子元素的抠图结果。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'ImageURL' => ['description' => '结果图像URL地址。'."\n" + .'抠图之后返回四通道PNG图，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_HeadSegmenter/2021-12-31/invi_HeadSegmenter_016409228383064285967296_iPLUXA.png?Expires=1640924638&OSSAccessKeyId=LTAI****************&Signature=wpKOqSar1bYvGmlTMryfEH2Q9I****'], + 'Width' => ['description' => '结果图的宽度。', 'type' => 'integer', 'format' => 'int32', 'example' => '113'], + 'Height' => ['description' => '结果图的高度。', 'type' => 'integer', 'format' => 'int32', 'example' => '180'], + 'Y' => ['description' => '结果图左上角在原图中的y轴坐标。', 'type' => 'integer', 'format' => 'int32', 'example' => '102'], + 'X' => ['description' => '结果图左上角在原图中的x轴坐标。', 'type' => 'integer', 'format' => 'int32', 'example' => '446'], + ], + 'description' => '', + ], + ], + ], + ], + ], + 'description' => '', + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"D6C24839-91A7-41DA-B31F-98F08EF80CC0\\",\\n \\"Data\\": {\\n \\"Elements\\": [\\n {\\n \\"ImageURL\\": \\"http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_HeadSegmenter/2021-12-31/invi_HeadSegmenter_016409228383064285967296_iPLUXA.png?Expires=1640924638&OSSAccessKeyId=LTAI****************&Signature=wpKOqSar1bYvGmlTMryfEH2Q9I****\\",\\n \\"Width\\": 113,\\n \\"Height\\": 180,\\n \\"Y\\": 102,\\n \\"X\\": 446\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"<SegmentHairResponse>\\n <RequestId>D6C24839-91A7-41DA-B31F-98F08EF80CC0</RequestId>\\n <Data>\\n <Elements>\\n <ImageURL>http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_HeadSegmenter/2021-12-31/invi_HeadSegmenter_016409228383064285967296_iPLUXA.png?Expires=1640924638&OSSAccessKeyId=LTAI****************&Signature=wpKOqSar1bYvGmlTMryfEH2Q9I****</ImageURL>\\n <Width>113</Width>\\n <Height>180</Height>\\n <Y>102</Y>\\n <X>446</X>\\n </Elements>\\n </Data>\\n</SegmentHairResponse>","errorExample":""}]', + 'title' => '头发分割', + 'summary' => '本文档介绍头发分割SegmentHair的语法及示例。', + 'description' => '## 功能描述'."\n" + .'头发分割能力用于识别图像中的人物头像，然后对人物头像区域进行抠图解析，最后输出PNG格式的人物头发矩形透明图。'."\n" + ."\n" + .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=imageseg&children=SegmentHair)对该能力进行更直观试用以及在线购买。'."\n" + .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" + ."\n" + .'## 应用场景'."\n" + ."\n" + .'- 假发网络试戴：通过头发分割，截取自拍照的头发后，换成假发图像，就可以直接看到假发试戴效果，省去了网购后佩戴不合适需要退换货的烦恼。'."\n" + .'- 理发店发型尝试：发型师指导客户通过平板电脑或手机拍摄的自己头像，换成各种发型，有更直观的感觉。客户可以选择最喜欢的发型，让发型师为自己打理。'."\n" + ."\n" + .'## 特色优势'."\n" + .'发丝边缘的精确分割：对发丝边缘可以精确分割，分割后图像编辑结果无违和感。'."\n" + ."\n" + .'## 接入指引'."\n" + .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" + .'2. 开通能力：请确保您已开通[分割抠图服务](https://vision.aliyun.com/imageseg)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_imageseg_public_cn#/open)。'."\n" + .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/imageseg/2019-12-30/SegmentHair?lang=JAVA&sdkStyle=dara¶ms=%7B%22ImageURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fimageseg%2FSegmentHair%2FSegmentHair1.jpg%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'5. 开发接入步骤：'."\n" + .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" + .'- 在对应语言的SDK文档中找到AI类目为分割抠图（imageseg）的SDK包进行安装。'."\n" + .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" + ."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[头发分割示例代码](~~605130~~)。'."\n" + ."\n" + .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'- [Web前端直接调用](~~467779~~)'."\n" + .'- [小程序场景下直接调用](~~467780~~)'."\n" + .'- [Android端直接调用](~~467781~~)'."\n" + .'- [iOS端直接调用](~~467782~~)'."\n" + ."\n" + .'## 输入限制'."\n" + .'- 图像格式：JPEG、JPG、PNG、BMP。'."\n" + .'- 图像大小：不超过3M。'."\n" + .'- 图像分辨率：大于32×32像素，小于2000×2000像素。'."\n" + .'- URL地址中不能包含中文字符。'."\n" + ."\n" + .'## 计费说明'."\n" + .'关于头发分割的计费方式及报价，请参见[计费介绍](~~190132~~)。'."\n" + ."\n" + .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=imageseg&children=SegmentHair)。', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => '## SDK参考'."\n" + .'阿里云视觉AI分割抠图类目下的头发分割能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为分割抠图（imageseg）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + ."\n" + .'## 示例代码'."\n" + .'该能力常用语言的示例代码，请参见[头发分割示例代码](~~605130~~)。', + 'extraInfo' => '## 错误码'."\n" + .'关于头发分割的错误码，详情请参见[常见错误码](~~146751~~)。'."\n" + ."\n" + .'## 安全声明'."\n" + .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" + .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', + 'changeSet' => [ + ['createdAt' => '2022-03-30T06:07:10.000Z', 'description' => '错误码发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SegmentHair'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-imageseg:SegmentHair', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], + ], + ], + 'SegmentHead' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => [], + 'parameters' => [ + [ + 'name' => 'ImageURL', + 'in' => 'query', + 'schema' => ['description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/SegmentHead/SegmentHead1.jpg', 'isFileTransferUrl' => true], + ], [ 'name' => 'ReturnForm', 'in' => 'query', - 'schema' => [ - 'description' => '指定返回的图像形式。'."\n" - ."\n" - .'- 如果设置为`mask`，则返回单通道mask。'."\n" - .'- 如果不设置或者设置为任意非mask值，则返回四通道PNG图。', - 'type' => 'string', - 'required' => false, - 'example' => 'mask', - ], + 'schema' => ['description' => '指定返回的图像形式。'."\n" + ."\n" + .'- 如果设置为`mask`，则返回单通道mask。'."\n" + .'- 如果不设置或者设置为任意非mask值，则返回四通道PNG图。', 'type' => 'string', 'required' => false, 'example' => 'mask'], ], ], 'responses' => [ @@ -1896,11 +1688,7 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '89BBDA42-E1CA-426E-9A46-C703D8DBB1E2', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '89BBDA42-E1CA-426E-9A46-C703D8DBB1E2'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', @@ -1911,43 +1699,21 @@ 'items' => [ 'type' => 'object', 'properties' => [ - 'ImageURL' => [ - 'description' => '结果图像URL地址。'."\n" - .'抠图之后返回四通道PNG图，无压缩，图像体积会变大。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_headsegmenter/2020-6-2/invi_headsegmenter_015910809094981099086_TAamhR.png?Expires=1591082709&OSSAccessKeyId=LTAI****************&Signature=xuUE%2FbYeB9LpR18VXawOVeutQU****', - ], - 'Width' => [ - 'description' => '结果图的宽度。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '116', - ], - 'Height' => [ - 'description' => '结果图的高度。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '180', - ], - 'Y' => [ - 'description' => '左上角y坐标。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '102', - ], - 'X' => [ - 'description' => '左上角x坐标。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '445', - ], + 'ImageURL' => ['description' => '结果图像URL地址。'."\n" + .'抠图之后返回四通道PNG图，无压缩，图像体积会变大。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_headsegmenter/2020-6-2/invi_headsegmenter_015910809094981099086_TAamhR.png?Expires=1591082709&OSSAccessKeyId=LTAI****************&Signature=xuUE%2FbYeB9LpR18VXawOVeutQU****'], + 'Width' => ['description' => '结果图的宽度。', 'type' => 'integer', 'format' => 'int32', 'example' => '116'], + 'Height' => ['description' => '结果图的高度。', 'type' => 'integer', 'format' => 'int32', 'example' => '180'], + 'Y' => ['description' => '左上角y坐标。', 'type' => 'integer', 'format' => 'int32', 'example' => '102'], + 'X' => ['description' => '左上角x坐标。', 'type' => 'integer', 'format' => 'int32', 'example' => '445'], ], + 'description' => '', ], ], ], ], ], + 'description' => '', ], ], ], @@ -2002,17 +1768,12 @@ .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', + 'changeSet' => [], ], 'SegmentSkin' => [ 'summary' => '本文介绍皮肤分割SegmentSkin的语法及示例。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -2020,23 +1781,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' => '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/imageseg/SegmentSkin/SegmentSkin2.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/imageseg/SegmentSkin/SegmentSkin2.jpg', 'isFileTransferUrl' => true], ], ], 'responses' => [ @@ -2044,52 +1794,33 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'DA007354-6CF5-45BE-8333-E06318D848C0', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'DA007354-6CF5-45BE-8333-E06318D848C0'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'URL' => [ - 'description' => '分割结果图像的URL地址。'."\n" - .'抠图之后返回四通道PNG图，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_skinsegmenter/2020-9-27/invi_skinsegmenter_016011971641871000001_wQbLq9.jpg?Expires=1601198964&OSSAccessKeyId=LTAI****************&Signature=xjKc%2BScprmB86cxtI%2B1T0R6TlE****', - ], + 'URL' => ['description' => '分割结果图像的URL地址。'."\n" + .'抠图之后返回四通道PNG图，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_skinsegmenter/2020-9-27/invi_skinsegmenter_016011971641871000001_wQbLq9.jpg?Expires=1601198964&OSSAccessKeyId=LTAI****************&Signature=xjKc%2BScprmB86cxtI%2B1T0R6TlE****'], ], ], ], + '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' => '授权失败，请检查RAM权限配置，操作流程可参考https://help.aliyun.com/document_detail/145025.htm。'], ], 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], ], 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '算法服务报错，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。 '], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"DA007354-6CF5-45BE-8333-E06318D848C0\\",\\n \\"Data\\": {\\n \\"URL\\": \\"http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_skinsegmenter/2020-9-27/invi_skinsegmenter_016011971641871000001_wQbLq9.jpg?Expires=1601198964&OSSAccessKeyId=LTAI****************&Signature=xjKc%2BScprmB86cxtI%2B1T0R6TlE****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<SegmentSkinResponse>\\n <RequestId>DA007354-6CF5-45BE-8333-E06318D848C0</RequestId>\\n <Data>\\n <URL>http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_skinsegmenter/2020-9-27/invi_skinsegmenter_016011971641871000001_wQbLq9.jpg?Expires=1601198964&OSSAccessKeyId=LTAI****************&Signature=xjKc%2BScprmB86cxtI%2B1T0R6TlE****</URL>\\n </Data>\\n</SegmentSkinResponse>","errorExample":""}]', @@ -2137,16 +1868,29 @@ ."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'SegmentSky' => [ - 'methods' => [ - 'post', - 'get', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SegmentSkin'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'viapi-imageseg:SegmentSkin', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'SegmentSky' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -2159,13 +1903,7 @@ [ 'name' => 'ImageURL', 'in' => 'query', - 'schema' => [ - 'description' => '图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/SegmentSky/SegmentSky5.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/imageseg/SegmentSky/SegmentSky5.jpg', 'isFileTransferUrl' => true], ], ], 'responses' => [ @@ -2173,25 +1911,18 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '80E9D0A0-0330-4210-9986-CAC50C922FF0', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '80E9D0A0-0330-4210-9986-CAC50C922FF0'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'ImageURL' => [ - 'description' => '结果图像URL地址。'."\n" - .'抠图之后返回四通道PNG图，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/skysegmentation-2020-05-18-10-44-16-5bc8dc79f9-92b7z/2020-5-18/invi_skySegmentator_015897703560961000003_SqZLDv.png?Expires=1589772156&OSSAccessKeyId=LTAI****************&Signature=gXrzAUl%2BvIdYbQ9XKdho54MlkX****', - ], + 'ImageURL' => ['description' => '结果图像URL地址。'."\n" + .'抠图之后返回四通道PNG图，无压缩，图像尺寸保持不变，图像体积会变大。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/skysegmentation-2020-05-18-10-44-16-5bc8dc79f9-92b7z/2020-5-18/invi_skySegmentator_015897703560961000003_SqZLDv.png?Expires=1589772156&OSSAccessKeyId=LTAI****************&Signature=gXrzAUl%2BvIdYbQ9XKdho54MlkX****'], ], ], ], + 'description' => '', ], ], ], @@ -2238,135 +1969,409 @@ .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'GetAsyncJobResult' => [ - 'methods' => [ - 'post', - 'get', + 'changeSet' => [ + ['createdAt' => '2022-03-30T06:07:10.000Z', 'description' => '错误码发生变更'], ], - 'schemes' => [ - 'http', - 'https', + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SegmentSky'], + ], ], - 'security' => [ + 'ramActions' => [ [ - 'AK' => [], + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-imageseg:SegmentSky', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], ], ], - 'operationType' => 'read', - 'deprecated' => false, - 'systemTags' => [ + ], + ], + 'endpoints' => [ + ['regionId' => 'cn-shanghai', 'regionName' => '华东2（上海）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'imageseg.cn-shanghai.aliyuncs.com', 'endpoint' => 'imageseg.cn-shanghai.aliyuncs.com', 'vpc' => 'imageseg-vpc.cn-shanghai.aliyuncs.com'], + ], + 'errorCodes' => [ + ['code' => 'AuthFailed', 'message' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'http_code' => 403, 'description' => '授权失败，请检查RAM权限配置，操作流程可参考https://help.aliyun.com/document_detail/145025.htm。'], + ['code' => 'ClientError.IllegalArgument', 'message' => '请检查参数，如参数值所代表的数据库是否存在', 'http_code' => 400, 'description' => '请检查参数，如参数值所代表的数据库是否存在'], + ['code' => 'EntityNotExist.Role', 'message' => '没有Ram权限，请联系主账号给你添加AliyunVIAPIFullAccess权限，操作流程可参考https://help.aliyun.com/document_detail/145025.htm', 'http_code' => 400, 'description' => '没有Ram权限，请联系主账号给你添加AliyunVIAPIFullAccess权限，操作流程可参考https://help.aliyun.com/document_detail/145025.htm'], + ['code' => 'IllegalUrlParameter', 'message' => 'parameter url is illegal', 'http_code' => 400, 'description' => 'Url不合法，请检查url能否正常打开 - 非上海OSS图片链接请参考：https://help.aliyun.com/document\\_detail/155645.html '], + ['code' => 'InternalError', 'message' => 'An error occurred to the algorithm service.', 'http_code' => 500, 'description' => '算法服务报错，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。 '], + ['code' => 'InternalError.Algo', 'message' => 'An algorithm error occurred.', 'http_code' => 500, 'description' => '算法服务报错，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。 '], + ['code' => 'InternalError.Busy', 'message' => 'Server busy.', 'http_code' => 500, 'description' => '后台服务忙，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ['code' => 'InternalError.Env', 'message' => 'Failed to initilize the environment.', 'http_code' => 500, 'description' => '初始化环境失败。请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ['code' => 'InternalError.Model', 'message' => 'Failed to load the model.', 'http_code' => 500, 'description' => '模型加载错误，请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ['code' => 'InternalError.Process', 'message' => 'An error occurred during inference.', 'http_code' => 500, 'description' => '推理过程异常，请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ['code' => 'InternalError.Remote', 'message' => 'The request processing has failed due to some unknown error.', 'http_code' => 500, 'description' => '远程服务不可用，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ['code' => 'InternalError.Server', 'message' => 'The request processing has failed due to some unknown error.', 'http_code' => 500, 'description' => '系统内部错误，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ['code' => 'InternalError.Timeout', 'message' => '算法服务报错，请稍后重试', 'http_code' => 500, 'description' => '算法服务报错，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。 '], + ['code' => 'InternalServerError', 'message' => 'A server error occurred while processing your request.', 'http_code' => 500, 'description' => '系统内部错误，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ['code' => 'InvalidAccessKeyId.Inactive', 'message' => 'AccessKeyId非法，请检查AccessKeyId是否被禁用，或者AccessKeyId和AccessKeySecret是否填写正确。', 'http_code' => 400, 'description' => 'AccessKeyId非法，请检查AccessKeyId是否被禁用，或者AccessKeyId和AccessKeySecret是否填写正确。请参考文档：https://help.aliyun.com/document\\_detail/175144.html，进入控制台，将对应的AccessKey启用。 '], + ['code' => 'InvalidAccessKeyId.NotFound', 'message' => 'access key not found', 'http_code' => 404, 'description' => 'AccessKeyId未找到，请检查AccessKeyId和AccessKeySecret是否填写正确。请参考文档：https://help.aliyun.com/document\\_detail/175144.html，进入控制台，找到对应的AccessKeyId和AccessKeySecret。如果AccessKeySecret未保存，主账号可以通过查看Secret找回，子账号无法找回，可以新建一个AccessKey。 '], + ['code' => 'InvalidAccessKeySecret', 'message' => 'AccessKeyId或AccessKeySecret填写错误，请检查AccessKeyId和AccessKeySecret是否填写正确。', 'http_code' => 400, 'description' => 'AccessKeyId或AccessKeySecret填写错误，请检查AccessKeyId和AccessKeySecret是否填写正确。请参考文档：https://help.aliyun.com/document\\_detail/175144.html，进入控制台，找到对应的AccessKeyId和AccessKeySecret。如果AccessKeySecret未保存，主账号可以通过查看Secret找回，子账号无法找回，可以新建一个AccessKey。 '], + ['code' => 'InvalidAction.NotFound', 'message' => '能力未找到，请检查类目与能力是否匹配，检查访问域名与能力是否匹配，关于访问域名可参考：https://help.aliyun.com/document_detail/143103.htm。SDK接入请参考：https://help.aliyun.com/document_detail/145033.html，选择合适编程语言根据实例代码作相关修改进行接入。', 'http_code' => 400, 'description' => '能力未找到，请检查类目与能力是否匹配，检查访问域名与能力是否匹配，关于访问域名可参考：https://help.aliyun.com/document_detail/143103.htm。SDK接入请参考：https://help.aliyun.com/document_detail/145033.html，选择合适编程语言根据实例代码作相关修改进行接入。'], + ['code' => 'InvalidApi.ForbiddenInvoke', 'message' => '调用受限，请检查您调用的能力是否为受限能力，受限能力需要在控制台https://vision.console.aliyun.com/找到相应能力申请经过审批之后才能调用。如非上述情况，请检查账号是否欠费', 'http_code' => 400, 'description' => '调用受限，请检查您调用的能力是否为受限能力，受限能力需要在控制台https://vision.console.aliyun.com/找到相应能力申请经过审批之后才能调用。如非上述情况，请检查账号是否欠费'], + ['code' => 'InvalidApi.NotPurchase', 'message' => 'specified api is not purchase', 'http_code' => 403, 'description' => '产品未开通，请开通产品：https://common-buy.aliyun.com/?commodityCode=viapi\\_imageseg\\_public\\_cn#/open '], + ['code' => 'InvalidApi.OutOfService', 'message' => '产品未开通，请开通产品：https://common-buy.aliyun.com/?commodityCode=viapi_imageseg_public_cn#/open', 'http_code' => 400, 'description' => '产品未开通，请开通产品：https://common-buy.aliyun.com/?commodityCode=viapi_imageseg_public_cn#/open'], + ['code' => 'InvalidFile.Content', 'message' => '请参考算法文档检查文件内容，更换包含符合算法要求的', 'http_code' => 400, 'description' => '请参考算法文档检查文件内容，更换包含符合算法要求的'], + ['code' => 'InvalidFile.Decode', 'message' => 'Failed to decode the image.', 'http_code' => 400, 'description' => '图像解码失败，请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ['code' => 'InvalidFile.Download', 'message' => '文件无法下载，请检查链接是否可访问和本地网络情况 - 非上海OSS文件链接请参考：https://help.aliyun.com/document_detail/155645.html', 'http_code' => 400, 'description' => '文件无法下载，请检查链接是否可访问和本地网络情况 - 非上海OSS文件链接请参考：https://help.aliyun.com/document_detail/155645.html'], + ['code' => 'InvalidFile.REGION', 'message' => '文件链接地域不对，非上海OSS文件链接请参考：https://help.aliyun.com/document_detail/155645.html', 'http_code' => 400, 'description' => '文件链接地域不对，非上海OSS文件链接请参考：https://help.aliyun.com/document_detail/155645.html'], + ['code' => 'InvalidFile.Resolution', 'message' => '文件分辨率超出限制，请检查文件分辨率和内容，修改文件分辨率后重试', 'http_code' => 400, 'description' => '文件分辨率超出限制，请检查文件分辨率和内容，修改文件分辨率后重试'], + ['code' => 'InvalidFile.Type', 'message' => '文件类型错误，请检查文件类型 - 请参考算法API文档，使用算法支持的文件类型', 'http_code' => 400, 'description' => '文件类型错误，请检查文件类型 - 请参考算法API文档，使用算法支持的文件类型。阿里云视觉智能开放平台能够读取文件并获取真实的文件类型，不是通过文件后缀名进行类型判断，只看文件后缀名是无效的，关于更多文件类型判断和处理信息可参考：https://help.aliyun.com/document_detail/470250.html'], + ['code' => 'InvalidFile.Unsafe', 'message' => 'Risky file URL.', 'http_code' => 400, 'description' => '不安全的文件链接，请确保上传的图片或文件来源符合相应的法律法规。'], + ['code' => 'InvalidFile.URL', 'message' => '文件无法下载，请检查链接是否可访问和本地网络情况 - 非上海OSS文件链接请参考：https://help.aliyun.com/document_detail/155645.html', 'http_code' => 400, 'description' => '文件无法下载，请检查链接是否可访问和本地网络情况 - 非上海OSS文件链接请参考：https://help.aliyun.com/document_detail/155645.html'], + ['code' => 'InvalidImage.Content', 'message' => 'Invalid content value.', 'http_code' => 400, 'description' => '图像内容不正确，请参考文档检查图片内容，更换包含符合算法要求的。'], + ['code' => 'InvalidImage.Content', 'message' => 'invalid image content', 'http_code' => 400, 'description' => '请参考算法文档检查图片内容，更换包含符合算法要求的 '], + ['code' => 'InvalidImage.Decode', 'message' => '请检查图片是否能够正常打开', 'http_code' => 400, 'description' => '请检查图片是否能够正常打开'], + ['code' => 'InvalidImage.Download', 'message' => 'Failed to download the file.', 'http_code' => 400, 'description' => '图片无法下载，请检查链接是否可访问和本地网络情况 - 非上海OSS图片链接请参考：https://help.aliyun.com/document\\_detail/155645.html。URL中不支持空格和中文字符，如包含请通过urlEncode编码之后再传入。请检查OSS链接是否过期等。 '], + ['code' => 'InvalidImage.NotFoundFace', 'message' => '图像中没找到人脸，请检查您的图像中是否包含人脸或人脸太小', 'http_code' => 400, 'description' => '图像中没找到人脸，请检查您的图像中是否包含人脸或人脸太小'], + ['code' => 'InvalidImage.Region', 'message' => 'The URL format of the file is invalid.', 'http_code' => 400, 'description' => '图片链接地域不对，非上海OSS图片链接请参考：https://help.aliyun.com/document\\_detail/155645.html '], + ['code' => 'InvalidImage.Resolution', 'message' => 'The resolution of the image or video is invalid.', 'http_code' => 400, 'description' => '文件分辨率超出限制，请检查文件分辨率和内容，修改文件分辨率后重试 '], + ['code' => 'InvalidImage.Timeout', 'message' => '图片下载超时，请检查链接是否可访问和本地网络情况 - 非上海OSS图片链接请参考：https://help.aliyun.com/document_detail/155645.html。请检查OSS链接是否过期等。', 'http_code' => 400, 'description' => '图片下载超时，请检查链接是否可访问和本地网络情况 - 非上海OSS图片链接请参考：https://help.aliyun.com/document_detail/155645.html。请检查OSS链接是否过期等。'], + ['code' => 'InvalidImage.Type', 'message' => '图片类型错误，请检查图片类型 - 请参考算法API文档，使用算法支持的图片类型', 'http_code' => 400, 'description' => '图片类型错误，请检查图片类型 - 请参考算法API文档，使用算法支持的图片类型'], + ['code' => 'InvalidImage.Unsafe', 'message' => 'Risky file URL.', 'http_code' => 400, 'description' => 'URL不安全。请确保上传的图片或文件来源符合相应的法律法规。'], + ['code' => 'InvalidImage.URL', 'message' => 'The URL format of the file is invalid or URL access has failed.', 'http_code' => 400, 'description' => '图片链接非法，请检查图片链接是否可访问 - 非上海OSS图片链接请参考：https://help.aliyun.com/document\\_detail/155645.html。对于上海oss链接请使用标准的oss域名，目前暂不支持绑定cdn域名和自定义域名。 '], + ['code' => 'InvalidImageType', 'message' => 'Invalid image type.', 'http_code' => 400, 'description' => '无效的图片类型。请参考调用能力的文档输入文档中支持的图片类型。'], + ['code' => 'InvalidParameter', 'message' => 'Invalid parameter value.', 'http_code' => 400, 'description' => '参数错误，请根据算法API文档和报错Message检查参数值。是否参数值前后多了空格或者其他特殊字符等。 '], + ['code' => 'InvalidParameter.BadRequest', 'message' => '参数错误，请根据算法API文档和报错Message检查参数值。是否参数值前后多了空格或者其他特殊字符等。', 'http_code' => 400, 'description' => '参数错误，请根据算法API文档和报错Message检查参数值。是否参数值前后多了空格或者其他特殊字符等。'], + ['code' => 'InvalidParameter.Convert', 'message' => 'Invalid convert value.', 'http_code' => 400, 'description' => '输入参数转换失败。'], + ['code' => 'InvalidParameter.NotFound', 'message' => '参数错误，请根据算法API文档和报错Message检查参数值。是否参数值前后多了空格或者其他特殊字符等。', 'http_code' => 400, 'description' => '参数错误，请根据算法API文档和报错Message检查参数值。是否参数值前后多了空格或者其他特殊字符等。'], + ['code' => 'InvalidParameter.TooLarge', 'message' => 'The file size exceeds the limit.', 'http_code' => 400, 'description' => '参数错误，文件大小超出限制，请参考算法API文档调整文件大小 '], + ['code' => 'InvalidParameter.Transfer', 'message' => 'Invalid transfer value.', 'http_code' => 400, 'description' => '下载或上传数据失败。'], + ['code' => 'InvalidParameter.Unsuitable', 'message' => 'Invalid unsuitable value.', 'http_code' => 400, 'description' => '数据为空或参数无效，请参照文档核对传入参数后再发起请求。'], + ['code' => 'InvalidRamRole', 'message' => '没有Ram权限，请联系主账号给你添加AliyunVIAPIFullAccess权限，操作流程可参考https://help.aliyun.com/document_detail/145025.htm', 'http_code' => 400, 'description' => '没有Ram权限，请联系主账号给你添加AliyunVIAPIFullAccess权限，操作流程可参考https://help.aliyun.com/document_detail/145025.htm'], + ['code' => 'InvalidResult', 'message' => '参数错误，请参考文档检查参数值，检查文件内容。请检查是否图片内容不完整或者太模糊等。', 'http_code' => 400, 'description' => '参数错误，请参考文档检查参数值，检查文件内容。请检查是否图片内容不完整或者太模糊等。'], + ['code' => 'InvalidSide', 'message' => 'Specified parameter Side is not valid. 请参考文档填写正确的Side参数', 'http_code' => 400, 'description' => 'Specified parameter Side is not valid. 请参考文档填写正确的Side参数'], + ['code' => 'InvalidTimeStamp.Expired', 'message' => 'timestamp expired', 'http_code' => 400, 'description' => '时间戳过期，请更新时间戳。可以参考https://help.aliyun.com/document\\_detail/144904.html文档计算请求签名。如果您的语言比较常用，推荐使用SDK进行调用，详情可参考：https://help.aliyun.com/document\\_detail/145033.html '], + ['code' => 'InvalidVersion', 'message' => 'Specified parameter Version is not valid', 'http_code' => 400, 'description' => '版本未找到，请检查SDK版本是否匹配，检查版本与类目和能力是否匹配，关于SDK版本可参考：https://help.aliyun.com/document_detail/145033.html'], + ['code' => 'MissingAccessKeyId', 'message' => 'AccessKeyId未填写，请检查AccessKeyId和AccessKeySecret是否填写正确。', 'http_code' => 400, 'description' => 'AccessKeyId未填写，请检查AccessKeyId和AccessKeySecret是否填写正确。请参考文档：https://help.aliyun.com/document\\_detail/175144.html，进入控制台，找到对应的AccessKeyId和AccessKeySecret。如果AccessKeySecret未保存，主账号可以通过查看Secret找回，子账号无法找回，可以新建一个AccessKey。 '], + ['code' => 'MissingFileURL', 'message' => 'FileURL is required for this operation.', 'http_code' => 400, 'description' => '缺少文件参数FileURL，该参数为文件URL地址，文件输入推荐使用华东2（上海）区域的OSS链接-非上海OSS文件链接请参考：'."\n" + .'https://help.aliyun.com/document_detail/155645.html'], + ['code' => 'MissingImageURL', 'message' => 'ImageURL is required for this operation.', 'http_code' => 400, 'description' => '缺少图像参数ImageURL，该参数为图片URL地址，文件输入推荐使用华东2（上海）区域的OSS链接-非上海OSS文件链接请参考：'."\n" + .'https://help.aliyun.com/document_detail/155645.html'], + ['code' => 'MissingLimit', 'message' => 'Limit is required for this operation', 'http_code' => 400, 'description' => '缺少Limit参数，该参数是接口必填参数。推荐使用对应类目的SDK进行调用：https://help.aliyun.com/document_detail/145033.html'], + ['code' => 'MissingParameter', 'message' => 'A required parameter is not specified.', 'http_code' => 400, 'description' => '参数缺失，请参考文档检查参数值 '], + ['code' => 'MissingTasks', 'message' => 'Tasks is required for this operation.', 'http_code' => 400, 'description' => '缺少Tasks参数，该参数是接口必填参数。推荐使用对应类目的SDK进行调用：https://help.aliyun.com/document_detail/145033.html'], + ['code' => 'ParameterError', 'message' => 'The parameter is invalid. Please check again.', 'http_code' => 400, 'description' => '参数错误，请检查参数值。'], + ['code' => 'ServiceUnavailable', 'message' => 'The service is unavailable.', 'http_code' => 503, 'description' => '算法服务报错，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。 '], + ['code' => 'SignatureDoesNotMatch', 'message' => 'signature not match', 'http_code' => 400, 'description' => '签名不正确，请重新计算签名。可以参考https://help.aliyun.com/document\\_detail/144904.html文档计算请求签名。如果您的语言比较常用，推荐使用SDK进行调用，详情可参考：https://help.aliyun.com/document\\_detail/145033.html '], + ['code' => 'SignatureNonceUsed', 'message' => 'signature nonce error', 'http_code' => 400, 'description' => '签名已经被使用过，请重新计算签名。可以参考https://help.aliyun.com/document\\_detail/144904.html文档计算请求签名。如果您的语言比较常用，推荐使用SDK进行调用，详情可参考：https://help.aliyun.com/document\\_detail/145033.html '], + ['code' => 'Throttling', 'message' => 'The request was denied due to QPS limits.', 'http_code' => 400, 'description' => '调用被限流，请稍后再调用，或者购买QPS提升调用限制。关于QPS限制提升流程和处理请参考：https://help.aliyun.com/document_detail/604963.html。如果因业务需求需要更多QPS可通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群与平台取得联系。'], + ['code' => 'Throttling.User', 'message' => 'The request was denied due to QPS limits.', 'http_code' => 400, 'description' => '调用被限流，请稍后再调用，或者购买QPS提升调用限制。关于QPS限制提升流程和处理请参考：https://help.aliyun.com/document_detail/604963.html。如果因业务需求需要更多QPS可通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群与平台取得联系。'], + ['code' => 'Timeout', 'message' => 'The request has timed out.', 'http_code' => 408, 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ['code' => 'Unauthorized', 'message' => 'RAM authentication failed.', 'http_code' => 403, 'description' => '没有Ram权限，请联系主账号给你添加AliyunVIAPIFullAccess权限，操作流程可参考https://help.aliyun.com/document\\_detail/145025.htm '], + ], + 'changeSet' => [ + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'SegmentCloth'], + ], + 'createdAt' => '2024-07-19T02:15:05.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'SegmentCloth'], + ], + 'createdAt' => '2023-12-06T02:08:29.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'ChangeSky'], + ], + 'createdAt' => '2022-11-18T05:37:37.000Z', + 'description' => '支持本地文件上传', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'SegmentBody'], + ], + 'createdAt' => '2022-11-01T05:50:12.000Z', + 'description' => '设置SegmentBody的入参async为不可见', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'SegmentHDCommonImage'], + ], + 'createdAt' => '2022-10-17T02:04:15.000Z', + 'description' => '修改异步任务Message为可见', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'RefineMask'], + ], + 'createdAt' => '2022-09-29T08:00:16.000Z', + 'description' => '多url参数支持本地文件上传', + ], + [ + 'apis' => [ + ['description' => '错误码发生变更', 'api' => 'GetAsyncJobResult'], + ], + 'createdAt' => '2022-04-24T08:16:08.000Z', + 'description' => '调整GetAsyncJobResult单用户调用频率', + ], + [ + 'apis' => [ + ['description' => '错误码发生变更', 'api' => 'ParseFace'], + ], + 'createdAt' => '2022-03-30T09:08:48.000Z', + 'description' => '调整用户调用频率', + ], + [ + 'apis' => [ + ['description' => '错误码发生变更', 'api' => 'SegmentCloth'], + ['description' => '错误码发生变更', 'api' => 'SegmentFace'], + ['description' => '错误码发生变更', 'api' => 'SegmentFurniture'], + ['description' => '错误码发生变更', 'api' => 'SegmentHair'], + ['description' => '错误码发生变更', 'api' => 'SegmentSky'], + ['description' => '错误码发生变更', 'api' => 'SegmentVehicle'], + ], + 'createdAt' => '2022-03-30T09:08:05.000Z', + 'description' => '调整单用户调用频率', + ], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SegmentBody'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SegmentHDSky'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SegmentHair'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SegmentSky'], + ['threshold' => '500', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SegmentHead'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SegmentFood'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SegmentHDCommonImage'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'RefineMask'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SegmentSkin'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SegmentCommonImage'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetAsyncJobResult'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ParseFace'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SegmentCommodity'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SegmentHDBody'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SegmentCloth'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ChangeSky'], + ], + ], + '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' => 'SegmentHDSky', + 'description' => '天空高清分割', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-imageseg:SegmentHDSky', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'GetAsyncJobResult', + 'description' => '查询异步任务结果', 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'viapi-imageseg:GetAsyncJobResult', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], ], - 'parameters' => [ - [ - 'name' => 'JobId', - 'in' => 'formData', - 'schema' => [ - 'description' => '异步接口返回的RequestId，输入后可以查询异步接口的真实请求结果。', - 'type' => 'string', - 'required' => true, - 'example' => 'E75FE679-0303-4DD1-8252-1143B4FA8A27', + [ + 'apiName' => 'SegmentCloth', + 'description' => '服饰分割', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'viapi-imageseg:SegmentCloth', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'description' => '1', - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。'."\n" - ."\n", - 'type' => 'string', - 'example' => '43A0AEB6-45F4-4138-8E89-E1A5D63200E3', - ], - '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' => '{"ImageUrl":"http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_/2020-4-2/invi__015858226731531000018_UE7B9p.png?Expires=1585824473&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSR****&Signature=etyeYQQ%2BWAyQTqQKd8Xq0GiOW****"}', - ], - 'ErrorCode' => [ - 'description' => '异步任务错误码。', - 'type' => 'string', - 'example' => 'InvalidParameter', - ], - 'JobId' => [ - 'description' => '异步任务ID。', - 'type' => 'string', - 'example' => '49E2CC28-ED1D-4CC5-854D-7D0AE2B20976', - ], - ], - ], - ], + [ + 'apiName' => 'SegmentHDBody', + 'description' => '高清人体分割', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-imageseg:SegmentHDBody', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'ParseFace', + 'description' => '五官分割', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-imageseg:ParseFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'SegmentFood', + 'description' => '食品分割', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-imageseg:SegmentFood', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'SegmentHair', + 'description' => '头发分割', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-imageseg:SegmentHair', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'ChangeSky', + 'description' => '天空替换', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'viapi-imageseg:ChangeSky', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'SegmentSkin', + 'description' => '皮肤分割', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'viapi-imageseg:SegmentSkin', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'SegmentBody', + 'description' => '人体分割', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-imageseg:SegmentBody', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'RefineMask', + 'description' => 'Mask精细化分割', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-imageseg:RefineMask', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'SegmentHead', + 'description' => '头像分割', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-imageseg:SegmentHead', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'SegmentCommonImage', + 'description' => '通用分割', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-imageseg:SegmentCommonImage', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'SegmentSky', + 'description' => '天空分割', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-imageseg:SegmentSky', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'SegmentCommodity', + 'description' => '商品分割', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-imageseg:SegmentCommodity', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'SegmentHDCommonImage', + 'description' => '通用高清分割', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-imageseg:SegmentHDCommonImage', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"43A0AEB6-45F4-4138-8E89-E1A5D63200E3\\",\\n \\"Data\\": {\\n \\"Status\\": \\"PROCESS_SUCCESS\\",\\n \\"ErrorMessage\\": \\"paramsIllegal\\",\\n \\"Result\\": \\"{\\\\\\"ImageUrl\\\\\\":\\\\\\"http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_/2020-4-2/invi__015858226731531000018_UE7B9p.png?Expires=1585824473&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSR****&Signature=etyeYQQ%2BWAyQTqQKd8Xq0GiOW****\\\\\\"}\\",\\n \\"ErrorCode\\": \\"InvalidParameter\\",\\n \\"JobId\\": \\"49E2CC28-ED1D-4CC5-854D-7D0AE2B20976\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetAsyncJobResultResponse>\\n <RequestId>43A0AEB6-45F4-4138-8E89-E1A5D63200E3</RequestId>\\n <Data>\\n <Status>PROCESS_SUCCESS</Status>\\n <JobId>186AC396-0EEC-46F1-AAA1-BF3585227427</JobId>\\n <Result>{\\"ImageUrl\\":\\"http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_/2020-4-2/invi__015858228333801000019_zs0HOi.png?Expires=1585824633&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSR*****&Signature=YHSg24oLm3yk*****%3D\\"}</Result>\\n <status>PROCESS_SUCCESS</status>\\n </Data>\\n</GetAsyncJobResultResponse>","errorExample":""}]', - 'title' => '查询异步任务结果', - 'summary' => '本文介绍查询异步任务结果GetAsyncJobResult的语法及示例。', - 'description' => '# 功能描述'."\n" - ."\n" - .'异步接口调用API接口后，返回的并不是真正的请求结果，您需要保存返回结果中的RequestId，然后调用GetAsyncJobResult来获取真正的请求结果。'."\n" - ."\n" - .'> - 异步任务的文件有过期时间，有效期是30分钟。如需长期使用，需及时将文件下载到本地服务器或存储在OSS中。有关OSS更多操作信息，请参见[上传文件](~~31886~~)。'."\n" - .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" - ."\n\n" - .'当前分割抠图类目中通用高清分割（SegmentHDCommonImage）为异步接口，需要调用GetAsyncJobResult来获取真实的请求结果。'."\n" - ."\n\n", - 'requestParamsDescription' => ' ', - 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI能力推荐使用SDK调用，支持多种编程语言，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。', - 'extraInfo' => '## Result反序列化'."\n" - ."\n" - .'将上面Result反序列化展示如下。'."\n" - ."\n" - .'```'."\n" - .'{'."\n" - .' "ImageUrl": "http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_/2020-4-2/invi__015858228333801000019_zs0HOi.png?Expires=1585824633&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSR*****&Signature=YHSg24oLm3yk********%3D"'."\n" - .'}'."\n" - .'```'."\n" - ."\n" - .'## 错误码'."\n" - ."\n" - .'详情请参见[常见错误码](~~146751~~)。'."\n" - ."\n" - .'## 安全声明'."\n" - .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - ], - 'endpoints' => [ - [ - 'regionId' => 'cn-shanghai', - 'endpoint' => 'imageseg.cn-shanghai.aliyuncs.com', ], + 'resourceTypes' => [], ], ]; |