diff options
Diffstat (limited to 'data/zh_cn/videoenhan/2020-03-20')
| -rw-r--r-- | data/zh_cn/videoenhan/2020-03-20/api-docs.php | 3414 |
1 files changed, 1640 insertions, 1774 deletions
diff --git a/data/zh_cn/videoenhan/2020-03-20/api-docs.php b/data/zh_cn/videoenhan/2020-03-20/api-docs.php index 6fdb06e..324abe4 100644 --- a/data/zh_cn/videoenhan/2020-03-20/api-docs.php +++ b/data/zh_cn/videoenhan/2020-03-20/api-docs.php @@ -1,75 +1,207 @@ <?php return [ 'version' => '1.0', - 'info' => [ - 'style' => 'RPC', - 'product' => 'videoenhan', - 'version' => '2020-03-20', - ], + 'info' => ['style' => 'RPC', 'product' => 'videoenhan', 'version' => '2020-03-20'], 'directories' => [ [ - 'id' => 69030, - 'title' => '调色', + 'children' => ['AdjustVideoColor'], 'type' => 'directory', - 'children' => [ - 'AdjustVideoColor', - ], + 'title' => '调色', + 'id' => 335324, ], [ - 'id' => 69033, - 'title' => '其他能力', + 'children' => ['ChangeVideoSize', 'EnhanceVideoQuality', 'GenerateVideo', 'InterpolateVideoFrame', 'MergeVideoFace', 'SuperResolveVideo'], 'type' => 'directory', - 'children' => [ - 'ChangeVideoSize', - 'EnhanceVideoQuality', - 'GenerateVideo', - 'InterpolateVideoFrame', - 'MergeVideoFace', - 'SuperResolveVideo', - ], + 'title' => '其他能力', + 'id' => 335327, ], [ - 'id' => 69041, - 'title' => '擦除', + 'children' => ['EraseVideoLogo', 'EraseVideoSubtitles'], 'type' => 'directory', - 'children' => [ - 'EraseVideoLogo', - 'EraseVideoSubtitles', - ], + 'title' => '擦除', + 'id' => 335335, ], [ - 'id' => 69044, - 'title' => '结果', + 'children' => ['GetAsyncJobResult'], 'type' => 'directory', - 'children' => [ - 'GetAsyncJobResult', - ], + 'title' => '结果', + 'id' => 335338, ], [ - 'id' => 156246, - 'title' => '其它', + 'children' => ['AddFaceVideoTemplate', 'DeleteFaceVideoTemplate', 'MergeVideoModelFace', 'QueryFaceVideoTemplate', 'GenerateHumanAnimeStyleVideo', 'EnhancePortraitVideo'], 'type' => 'directory', - 'children' => [ - 'AddFaceVideoTemplate', - 'DeleteFaceVideoTemplate', - 'MergeVideoModelFace', - 'QueryFaceVideoTemplate', - 'GenerateHumanAnimeStyleVideo', - 'EnhancePortraitVideo', - ], + 'title' => '其它', + 'id' => 335340, ], ], 'components' => [ 'schemas' => [], ], 'apis' => [ - 'AdjustVideoColor' => [ - 'methods' => [ - 'post', + 'AddFaceVideoTemplate' => [ + 'summary' => '本文介绍视频人脸融合模版增加AddFaceVideoTemplate的语法及示例。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'create', 'riskType' => 'none', 'chargeType' => 'free', 'tenantRelevance' => 'publicInformation'], + 'parameters' => [ + [ + 'name' => 'VideoURL', + 'in' => 'formData', + 'schema' => ['description' => '视频模板的URL地址。当前仅支持上海地域的OSS链接，如何生成URL请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://invi-label.oss-cn-shanghai.aliyuncs.com/labl/temp/faceswap/test_for_api/xxxx.mp4', 'isFileTransferUrl' => true], + ], + [ + 'name' => 'VideoScene', + 'in' => 'formData', + 'schema' => ['description' => '判断视频换脸场景。取值如下：'."\n" + .'- single（默认）：单人视频换脸。'."\n" + .'- multi：多人视频换脸。'."\n" + ."\n" + .'> - 如果输入视频为单人物视频，**VideoScene**参数可以选择不输入或者传入`single`。'."\n" + .'- 如果输入视频为多人视频，**VideoScene**参数必须传入`multi`，后续可通过模板换脸接口进行多人一对一指定人脸融合。'."\n" + .'- 如果输入视频为多人视频，但用户只想替换其中某一个ID人物，则按照多人视频场景进行模板添加，即**VideoScene**参数传入`multi`值，后续可通过模板换脸接口指定想融合的具体人物。', 'type' => 'string', 'required' => false, 'example' => 'single'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'F61182AE-515B-5B0A-A877-1C9AE908FF15'], + 'Message' => ['description' => '提交异步任务后的提示信息。', 'type' => 'string', 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。'], + 'Date' => [ + 'description' => '返回的结果数据内容。该数据需要在异步任务执行成功后，通过调用[GetAsyncJobResult](~~159423~~)接口，对其Result字段进行JSON反序列化之后得到。', + 'type' => 'object', + 'properties' => [ + 'TemplateId' => ['description' => '模板ID。', 'type' => 'string', 'example' => '6cd509ea-54fa-4730-8e9d-c94cadcda048'], + 'FaceInfos' => [ + 'description' => '输入视频中存在多个人脸时，返回各人脸ID和各人脸裁剪后的图像。', + 'type' => 'array', + 'items' => [ + 'description' => '输入视频中存在多个人脸时，返回各人脸ID和各人脸裁剪后的图像。', + 'type' => 'object', + 'properties' => [ + 'TemplateFaceID' => ['description' => '人脸对应的子模板ID。', 'type' => 'string', 'example' => '7d1a2498-0f9a-42d8-bae8-c7e478188106_0'], + 'TemplateFaceURL' => ['description' => '人脸对应的子模板ID对应的人脸图。', 'type' => 'string', 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-face-fusion/template/xhtest_7d1a2498-0f9a-42d8-bae8-c7e478188106/xhtest_7d1a2498-0f9a-42d8-bae8-c7e478188106_0.png?Expires=1686040781&OSSAccessKeyId=LTAI****************&Signature=WVYTf%2F3knRuUPXSVGVz%2FZi3Miu****'], + ], + ], + ], + 'TransResult' => ['description' => '视频帧的人脸位置转换矩阵文件，用于辅助用户校验换脸信息。', 'type' => 'string', 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-face-fusion/template/1952059581270833_308f1611-7de8-4f16-9175-f1e997caadf6-V1/1952059581270833_308f1611-7de8-4f16-9175-f1e997caadf6-V1_trans.npy?Expires=1717055504&OSSAccessKeyId=LTAI****************&Signature=zg784H1bv5hwaKPvAywp8p5Hla****'], + ], + ], + ], + ], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"F61182AE-515B-5B0A-A877-1C9AE908FF15\\",\\n \\"Message\\": \\"该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\",\\n \\"Date\\": {\\n \\"TemplateId\\": \\"6cd509ea-54fa-4730-8e9d-c94cadcda048\\",\\n \\"FaceInfos\\": [\\n {\\n \\"TemplateFaceID\\": \\"7d1a2498-0f9a-42d8-bae8-c7e478188106_0\\",\\n \\"TemplateFaceURL\\": \\"http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-face-fusion/template/xhtest_7d1a2498-0f9a-42d8-bae8-c7e478188106/xhtest_7d1a2498-0f9a-42d8-bae8-c7e478188106_0.png?Expires=1686040781&OSSAccessKeyId=LTAI****************&Signature=WVYTf%2F3knRuUPXSVGVz%2FZi3Miu****\\"\\n }\\n ],\\n \\"TransResult\\": \\"http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-face-fusion/template/1952059581270833_308f1611-7de8-4f16-9175-f1e997caadf6-V1/1952059581270833_308f1611-7de8-4f16-9175-f1e997caadf6-V1_trans.npy?Expires=1717055504&OSSAccessKeyId=LTAI****************&Signature=zg784H1bv5hwaKPvAywp8p5Hla****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<AddFaceVideoTemplateResponse>\\n <RequestId>F61182AE-515B-5B0A-A877-1C9AE908FF15</RequestId>\\n <Message>该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>\\n</AddFaceVideoTemplateResponse>","errorExample":""}]', + 'title' => '视频人脸融合模版增加', + 'description' => '## 功能描述'."\n" + .'视频人脸融合模板增加功能可以将已通过内容审核的包含人脸的视频，作为视频人脸融合的模板，供模板视频人脸融合功能使用。'."\n" + ."\n" + .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" + ."\n" + .'## 接入指引'."\n" + .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" + .'2. 开通能力：请确保您已开通[视频生产服务](https://vision.aliyun.com/videoenhan)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_videoenhan_public_cn#/open)。'."\n" + .'><notice>'."\n" + .'本能力仅限企业认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/document_detail/428525.html)。'."\n" + .'></notice>'."\n" + ."\n" + .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videoenhan/2020-03-20/AddFaceVideoTemplate?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'5. 开发接入步骤： '."\n" + .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" + .'- 在对应语言的SDK文档中找到AI类目为视频生产（videoenhan）类目的SDK包进行安装。'."\n" + .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" + ."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[视频人脸融合模板增加示例代码](~~602556~~)。'."\n" + ."\n" + .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'- [Web前端直接调用](~~467779~~)'."\n" + .'- [小程序场景下直接调用](~~467780~~)'."\n" + .'- [Android端直接调用](~~467781~~)'."\n" + .'- [iOS端直接调用](~~467782~~)'."\n" + ."\n" + .'## 输入限制'."\n" + ."\n" + .'- 视频类型：MP4、AVI、MKV、MOV、FLV、TS、MPG。'."\n" + .'- 视频分辨率：大于等于320×320像素，小于等于1920×1920像素。'."\n" + .'- 视频大小：不大于120 MB。'."\n" + .'- URL地址不能包含中文字符。'."\n" + .'- 同一用户最多可支持上传3000个视频模板。'."\n" + .'- 添加多人脸视频时，单个视频出现的人物ID个数不能大于6个，如果超过6个人脸ID，则返回出现频次最高的6个人。'."\n" + .'- 视频只支持静态（恒定）帧率视频，暂不支持动态（可变）帧率视频。'."\n" + ."\n" + .'## 出参说明'."\n" + .'- 添加模板过程中，系统会自动进行涉黄涉政的过滤检查，如不符合规范，则无法正确添加。'."\n" + .'- 多人视频中如出现多张ID人脸，系统会按照多张脸出现的时长进行排序返回。'."\n" + ."\n" + .'## 视频帧质量建议'."\n" + .'- 要求保证图像中的人脸清晰。图像中人脸尺寸建议大于64×64像素，人脸区域建议不大于全图区域的2/3。'."\n" + .'- 建议图像中人脸五官区域轮廓完整，无明显遮挡。人脸融合算法支持人脸偏侧一定角度，在偏侧角度不超过30度的情况下能取得更佳效果。'."\n" + .'- 对于多人脸视频场景，系统会自动识别出整个视频中的不同人物ID，建议视频中的人物不要出现角度过大的转动以及明显遮挡的情况，否则识别出的人物ID个数可能不准确。'."\n" + ."\n" + .'推荐图像示例：'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221114/jris/MergeImageFacetuijian.png" width="300)'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20230609/otnv/MergeVideoModelFacetuijian.png" width="300)'."\n" + ."\n" + .'不推荐图像示例：'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221114/rkbx/MergeImageFacebutuijian.png" width="300)'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20230609/jcgb/MergeVideoModelFacebutuijian.png" width="300)'."\n" + ."\n" + .'## 调用步骤'."\n" + .'该能力为异步能力，需分两步进行调用。'."\n" + .'第一步调用AddFaceVideoTemplate接口提交任务，请求成功后，得到一个任务ID。'."\n" + .'第二步调用[GetAsyncJobResult](~~159423~~)接口查询结果，根据任务ID查询任务执行状态和结果。如果任务还在处理中，可稍等一段时间后再进行查询。当同一个任务还未处理完时，建议不要重复提交任务。'."\n" + ."\n" + .'## 计费说明'."\n" + .'视频人脸融合模板增加能力可免费调用。', + 'responseParamsDescription' => '## 查询结果'."\n" + .'该接口为异步接口，当前并未返回真实的请求结果，您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见[GetAsyncJobResult](~~159423~~)。'."\n" + ."\n" + .'## SDK参考'."\n" + .'阿里云视觉AI视频生产类目下的视频人脸融合模板增加能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为视频生产（videoenhan）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + ."\n" + .'## 示例代码'."\n" + .'该能力常用语言的示例代码，请参见[视频人脸融合模板增加示例代码](~~602556~~)。'."\n", + 'extraInfo' => '## 错误码'."\n" + .'关于视频人脸融合模板增加的错误码，详情请参见[常见错误码](~~159313~~)。'."\n" + ."\n" + .'## 安全声明'."\n" + .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" + .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n", + 'changeSet' => [ + ['createdAt' => '2024-05-30T09:21:48.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2023-06-09T02:22:45.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ['createdAt' => '2022-12-02T02:35:23.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-10-17T02:05:12.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2021-04-09T08:28:59.000Z', 'description' => 'OpenAPI 下线'], + ], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:AddFaceVideoTemplate', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'AdjustVideoColor' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -82,54 +214,27 @@ [ 'name' => 'VideoUrl', '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/videoenhan/AdjustVideoColor/AdjustVideoColor1.mp4', - '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/videoenhan/AdjustVideoColor/AdjustVideoColor1.mp4', 'isFileTransferUrl' => true], ], [ 'name' => 'VideoBitrate', 'in' => 'formData', - 'schema' => [ - 'description' => '输出视频码率，单位为M，默认20M，取值范围`[8,200]`。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '20', - ], + 'schema' => ['description' => '输出视频码率，单位为M，默认20M，取值范围`[8,200]`。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '20'], ], [ 'name' => 'VideoCodec', 'in' => 'formData', - 'schema' => [ - 'description' => '输出视频编码格式，可选h264、hevc、prores三种。默认值为h264。', - 'type' => 'string', - 'required' => false, - 'example' => 'h264', - ], + 'schema' => ['description' => '输出视频编码格式，可选h264、hevc、prores三种。默认值为h264。', 'type' => 'string', 'required' => false, 'example' => 'h264'], ], [ 'name' => 'VideoFormat', 'in' => 'formData', - 'schema' => [ - 'description' => '输出视频格式，可选mp4、mov两种。默认值为mp4。', - 'type' => 'string', - 'required' => false, - 'example' => 'mp4', - ], + 'schema' => ['description' => '输出视频格式，可选mp4、mov两种。默认值为mp4。', 'type' => 'string', 'required' => false, 'example' => 'mp4'], ], [ 'name' => 'Mode', 'in' => 'formData', - 'schema' => [ - 'description' => '指定调色模式，默认值为LogC。具体请参见调色模式说明。', - 'type' => 'string', - 'required' => false, - 'example' => 'LogC', - ], + 'schema' => ['description' => '指定调色模式，默认值为LogC。具体请参见调色模式说明。', 'type' => 'string', 'required' => false, 'example' => 'LogC'], ], ], 'responses' => [ @@ -137,29 +242,18 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'C4EB5E0B-0718-42CC-9B2C-1FB149256874', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'C4EB5E0B-0718-42CC-9B2C-1FB149256874'], 'Data' => [ 'description' => '返回的结果数据内容。该数据需要在异步任务执行成功后，通过调用[GetAsyncJobResult](~~607824~~)接口，对其Result字段进行JSON反序列化之后得到。', 'type' => 'object', 'properties' => [ - 'VideoUrl' => [ - 'description' => '调色后的视频URL地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://algo-app-aic-vd-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/video-recolor/2021-01-21-07/46%3A05-test.mov?Expires=1611216966&OSSAccessKeyId=LTAI****************&Signature=icKn5gEQ6rNlSHmCi2zAf2tC0L****', - ], + 'VideoUrl' => ['description' => '调色后的视频URL地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://algo-app-aic-vd-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/video-recolor/2021-01-21-07/46%3A05-test.mov?Expires=1611216966&OSSAccessKeyId=LTAI****************&Signature=icKn5gEQ6rNlSHmCi2zAf2tC0L****'], ], ], - 'Message' => [ - 'description' => '提交异步任务后的提示信息。', - 'type' => 'string', - 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。', - ], + 'Message' => ['description' => '提交异步任务后的提示信息。', 'type' => 'string', 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。'], ], + 'description' => '', ], ], ], @@ -226,15 +320,26 @@ .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n", + 'changeSet' => [ + ['createdAt' => '2022-10-17T02:05:11.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:AdjustVideoColor', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + ], ], 'ChangeVideoSize' => [ - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -242,132 +347,65 @@ ], 'operationType' => 'readAndWrite', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - ], + 'systemTags' => ['operationType' => 'update'], 'parameters' => [ [ 'name' => 'VideoUrl', '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/videoenhan/ChangeVideoSize/ChangeVideoSize1.mp4', - '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/videoenhan/ChangeVideoSize/ChangeVideoSize1.mp4', 'isFileTransferUrl' => true], ], [ 'name' => 'Width', 'in' => 'formData', - 'schema' => [ - 'description' => '输出视频的宽度，单位像素，取值范围32~2160。'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'maximum' => '2160', - 'minimum' => '32', - 'example' => '600', - ], + 'schema' => ['description' => '输出视频的宽度，单位像素，取值范围32~2160。'."\n", 'type' => 'integer', 'format' => 'int32', 'required' => true, 'maximum' => '2160', 'minimum' => '32', 'example' => '600'], ], [ 'name' => 'Height', 'in' => 'formData', - 'schema' => [ - 'description' => '输出视频的高度，单位像素，取值范围32~2160。'."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'maximum' => '2160', - 'minimum' => '32', - 'example' => '1000', - ], + 'schema' => ['description' => '输出视频的高度，单位像素，取值范围32~2160。'."\n", 'type' => 'integer', 'format' => 'int32', 'required' => true, 'maximum' => '2160', 'minimum' => '32', 'example' => '1000'], ], [ 'name' => 'CropType', 'in' => 'formData', - 'schema' => [ - 'description' => '裁剪方式，可选smart、fill、cut。具体含义如下所示。'."\n" - ."\n" - .'- `smart`（智能裁剪）：根据主体位置智能决定填充还是裁剪，或者填充一部分，裁切一部分。'."\n" - ."\n" - .'- `fill`（填充）：按最长边进行画幅调整，超出部分填充模糊背景或颜色，或者进行拉伸处理。'."\n" - ."\n" - .'- `cut`（裁剪）：按最短边进行画幅调整，超出部分裁剪掉。', - 'type' => 'string', - 'required' => false, - 'example' => 'smart', - ], + 'schema' => ['description' => '裁剪方式，可选smart、fill、cut。具体含义如下所示。'."\n" + ."\n" + .'- `smart`（智能裁剪）：根据主体位置智能决定填充还是裁剪，或者填充一部分，裁切一部分。'."\n" + ."\n" + .'- `fill`（填充）：按最长边进行画幅调整，超出部分填充模糊背景或颜色，或者进行拉伸处理。'."\n" + ."\n" + .'- `cut`（裁剪）：按最短边进行画幅调整，超出部分裁剪掉。', 'type' => 'string', 'required' => false, 'example' => 'smart'], ], [ 'name' => 'FillType', 'in' => 'formData', - 'schema' => [ - 'description' => '填充方式。包括image、color、stretch。具体含义如下所示。'."\n" - ."\n" - .'- image：填充视频中间一帧的内容，填充前进行模糊处理。'."\n" - ."\n" - .'- color：指定填充颜色，表示RGB值的数组，例如红色`[255,0,0]`。 '."\n" - ."\n" - .'- stretch：通过拉伸进行填充。如果画幅调整比例较大会导致画面扭曲严重，不推荐使用。'."\n" - .' '."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'image', - ], + 'schema' => ['description' => '填充方式。包括image、color、stretch。具体含义如下所示。'."\n" + ."\n" + .'- image：填充视频中间一帧的内容，填充前进行模糊处理。'."\n" + ."\n" + .'- color：指定填充颜色，表示RGB值的数组，例如红色`[255,0,0]`。 '."\n" + ."\n" + .'- stretch：通过拉伸进行填充。如果画幅调整比例较大会导致画面扭曲严重，不推荐使用。'."\n" + .' '."\n", 'type' => 'string', 'required' => false, 'example' => 'image'], ], [ 'name' => 'Tightness', 'in' => 'formData', - 'schema' => [ - 'description' => '裁切框的紧凑度，取值范围0~1。值越大裁掉的内容越多。默认值为0.6。', - 'type' => 'number', - 'format' => 'float', - 'required' => false, - 'maximum' => '1', - 'minimum' => '0', - 'example' => '0.5', - 'default' => '0.6', - ], + 'schema' => ['description' => '裁切框的紧凑度，取值范围0~1。值越大裁掉的内容越多。默认值为0.6。', 'type' => 'number', 'format' => 'float', 'required' => false, 'maximum' => '1', 'minimum' => '0', 'example' => '0.5', 'default' => '0.6'], ], [ 'name' => 'R', 'in' => 'formData', - 'schema' => [ - 'description' => '当FillType取值为`color`时需要设置。表示RGB值中R的取值。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '255', - 'minimum' => '0', - 'example' => '0', - ], + 'schema' => ['description' => '当FillType取值为`color`时需要设置。表示RGB值中R的取值。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '255', 'minimum' => '0', 'example' => '0'], ], [ 'name' => 'G', 'in' => 'formData', - 'schema' => [ - 'description' => '当FillType取值为`color`时需要设置。表示RGB值中G的取值。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '255', - 'minimum' => '0', - 'example' => '0', - ], + 'schema' => ['description' => '当FillType取值为`color`时需要设置。表示RGB值中G的取值。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '255', 'minimum' => '0', 'example' => '0'], ], [ 'name' => 'B', 'in' => 'formData', - 'schema' => [ - 'description' => '当FillType取值为`color`时需要设置。表示RGB值中B的取值。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '255', - 'minimum' => '0', - 'example' => '0', - ], + 'schema' => ['description' => '当FillType取值为`color`时需要设置。表示RGB值中B的取值。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '255', 'minimum' => '0', 'example' => '0'], ], ], 'responses' => [ @@ -375,62 +413,35 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'C00C5A32-9F54-44F0-9778-0968DD9BF22A', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'C00C5A32-9F54-44F0-9778-0968DD9BF22A'], 'Data' => [ 'description' => '返回的数据内容。该数据需要在异步任务执行成功后，通过调用[GetAsyncJobResult](~~607824~~)接口，对其Result字段进行JSON反序列化之后得到。', 'type' => 'object', 'properties' => [ - 'VideoCoverUrl' => [ - 'description' => '输出视频封面URL地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-crop/2020-07-24-20/ZTZslWcU.jpg?Expires=1595597077&OSSAccessKeyId=LTAI****************&Signature=5cq1NNBEzS64U7RTXRBGlo7WPy****', - ], - 'VideoUrl' => [ - 'description' => '输出视频URL地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-crop/2020-07-24-20/ZTZslWcU.mp4?Expires=1595597077&OSSAccessKeyId=LTAI****************&Signature=ZyvD9AXCT2IUFkVJngQdbXMwX6****', - ], + 'VideoCoverUrl' => ['description' => '输出视频封面URL地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-crop/2020-07-24-20/ZTZslWcU.jpg?Expires=1595597077&OSSAccessKeyId=LTAI****************&Signature=5cq1NNBEzS64U7RTXRBGlo7WPy****'], + 'VideoUrl' => ['description' => '输出视频URL地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-crop/2020-07-24-20/ZTZslWcU.mp4?Expires=1595597077&OSSAccessKeyId=LTAI****************&Signature=ZyvD9AXCT2IUFkVJngQdbXMwX6****'], ], ], - 'Message' => [ - 'description' => '提交异步任务后的提示信息。', - 'type' => 'string', - 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。', - ], + 'Message' => ['description' => '提交异步任务后的提示信息。', 'type' => 'string', 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。'], ], + '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\\": \\"C00C5A32-9F54-44F0-9778-0968DD9BF22A\\",\\n \\"Data\\": {\\n \\"VideoCoverUrl\\": \\"http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-crop/2020-07-24-20/ZTZslWcU.jpg?Expires=1595597077&OSSAccessKeyId=LTAI****************&Signature=5cq1NNBEzS64U7RTXRBGlo7WPy****\\",\\n \\"VideoUrl\\": \\"http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-crop/2020-07-24-20/ZTZslWcU.mp4?Expires=1595597077&OSSAccessKeyId=LTAI****************&Signature=ZyvD9AXCT2IUFkVJngQdbXMwX6****\\"\\n },\\n \\"Message\\": \\"该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"<ChangeVideoSizeResponse>\\n <RequestId>C00C5A32-9F54-44F0-9778-0968DD9BF22A</RequestId>\\n <Message>该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>\\n</ChangeVideoSizeResponse>","errorExample":""}]', @@ -492,498 +503,188 @@ .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'EnhanceVideoQuality' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [ + ['createdAt' => '2022-10-17T02:05:11.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:ChangeVideoSize', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'DeleteFaceVideoTemplate' => [ + 'summary' => '本文介绍视频人脸融合模版删除DeleteFaceVideoTemplate的语法及示例。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'write', 'deprecated' => false, - 'systemTags' => [], + 'systemTags' => ['operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free', 'tenantRelevance' => 'publicInformation'], 'parameters' => [ [ - 'name' => 'VideoURL', - 'in' => 'formData', - 'schema' => [ - 'description' => '输入视频URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'https://invi-label.oss-cn-shanghai.aliyuncs.com/label/temp/faceswap/test_for_api/xxxx.mp4', - 'isFileTransferUrl' => true, - ], - ], - [ - 'name' => 'OutPutWidth', - 'in' => 'formData', - 'schema' => [ - 'description' => '输出视频的宽，默认为输入2倍，单位为px，取值范围`[180,7680]`。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '7680', - 'minimum' => '180', - 'example' => '2560', - ], - ], - [ - 'name' => 'OutPutHeight', - 'in' => 'formData', - 'schema' => [ - 'description' => '输出视频的高，默认为输入2倍，单位为px，取值范围`[180,4320]`。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '4320', - 'minimum' => '180', - 'example' => '1920', - ], - ], - [ - 'name' => 'FrameRate', - 'in' => 'formData', - 'schema' => [ - 'description' => '输出视频的帧率，默认50帧，取值范围`[1,120]`。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '120', - 'minimum' => '1', - 'example' => '50', - ], - ], - [ - 'name' => 'HDRFormat', - 'in' => 'formData', - 'schema' => [ - 'description' => '输出视频的HDR格式，仅支持PQ和HLG两种格式，默认为PQ。', - 'type' => 'string', - 'required' => false, - 'example' => 'PQ', - 'default' => 'PQ', - ], - ], - [ - 'name' => 'MaxIlluminance', - 'in' => 'formData', - 'schema' => [ - 'description' => '输出视频最大亮度，单位为nit。'."\n" - ."\n" - .'- 在**PQ**模式下该参数固定为600nit，输入无效。'."\n" - .'- 在**HLG**模式下该参数取值范围为500nit~1000nit，默认1000nit。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '1000', - 'minimum' => '500', - 'example' => '600', - ], - ], - [ - 'name' => 'Bitrate', + 'name' => 'TemplateId', 'in' => 'formData', - 'schema' => [ - 'description' => '输出视频码率，单位为MB，默认20MB，取值范围`[8,200]`。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '200', - 'minimum' => '8', - 'example' => '20', - ], + 'schema' => ['description' => '待删除的模板ID。', 'type' => 'string', 'required' => true, 'example' => '3bf2418c-7adf-4002-a9d6-2f7cf1889c0d'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '881F39DC-C107-4817-A6D5-000BE833CC2A', - ], - 'Data' => [ - 'description' => '返回的结果数据内容。该数据需要在异步任务执行成功后，通过调用[GetAsyncJobResult](~~607824~~)接口，对其Result字段进行JSON反序列化之后得到。', - 'type' => 'object', - 'properties' => [ - 'VideoURL' => [ - 'description' => '处理后的视频URL地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/uhd-enhance/20-11-20/Wwzf9z75GO5XdisS_20-11-20-07-13-48.mp4?Expires=1605858272&OSSAccessKeyId=LTAI****************&Signature=vvY0D%2Bl5eEzp%2BD7mPOWz0zMU7v****', - ], - ], - ], - 'Message' => [ - 'description' => '提交异步任务后的提示信息。', - 'type' => 'string', - 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '2337D184-CD63-57B5-96A2-B60AABCB7B58'], ], ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], - ], - 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], - ], - 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], - ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], - ], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"881F39DC-C107-4817-A6D5-000BE833CC2A\\",\\n \\"Data\\": {\\n \\"VideoURL\\": \\"http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/uhd-enhance/20-11-20/Wwzf9z75GO5XdisS_20-11-20-07-13-48.mp4?Expires=1605858272&OSSAccessKeyId=LTAI****************&Signature=vvY0D%2Bl5eEzp%2BD7mPOWz0zMU7v****\\"\\n },\\n \\"Message\\": \\"该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"<EnhanceVideoQualityResponse>\\n <RequestId>881F39DC-C107-4817-A6D5-000BE833CC2A</RequestId>\\n <Message>该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>\\n</EnhanceVideoQualityResponse>","errorExample":""}]', - 'title' => '视频综合增强', - 'summary' => '本文介绍视频综合增强EnhanceVideoQuality的语法及示例。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"2337D184-CD63-57B5-96A2-B60AABCB7B58\\"\\n}","errorExample":""},{"type":"xml","example":"<DeleteFaceVideoTemplateResponse>\\n <RequestId>2337D184-CD63-57B5-96A2-B60AABCB7B58</RequestId>\\n</DeleteFaceVideoTemplateResponse>","errorExample":""}]', + 'title' => '视频人脸融合模版删除', 'description' => '## 功能描述'."\n" - .'视频综合增强能力基于AI深度学习算法，可以对输入的SDR视频进行插帧、超分辨率SR、SDR转HDR综合增强处理。'."\n" + .'视频人脸融合模板删除功能可以删除用户已添加过的模板视频。'."\n" ."\n" - .'>- 生成的视频是标准HDR格式视频，请在合适的HDR设备上播放。'."\n" - .'- 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" - .'## 应用场景'."\n" - ."\n" - .'- 高清视频播放系统：对于非高清、非超高清、SDR的片源，通过视频综合增强，可以转化成高清、超高清、HDR、更高帧率的视频，给观众更好的观影体验。'."\n" - .'- 家庭视频增强：受限于过去拍摄设备的技术水平，珍贵的家庭视频以较低分辨率保存，在现在的高清设备上播放时，观看效果较差。通过视频综合增强，可以获得更高清的观看效果，适应当前的播放技术发展。'."\n" - ."\n" - .'## 特色优势'."\n" - ."\n" - .'- 真实的细节展示：能够真实推理出画面中的明暗变化细节，让您获得真正的HDR体验。'."\n" - .'- 更流畅的画面：可推理出原视频帧间的动作变化，加入更多视频帧，让画面更流畅。'."\n" - .'- 更高的分辨率：将画面分辨率提升的同时，优化画面细节、纹理和锐度等，同时抑制块噪声和压缩噪声等现象。'."\n" - ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[视频生产服务](https://vision.aliyun.com/videoenhan)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_videoenhan_public_cn#/open)。'."\n" - .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videoenhan/2020-03-20/EnhanceVideoQuality?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" - .'5. 开发接入步骤：'."\n" - .' '."\n" - .' - 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" - ."\n" - .' - 在对应语言的SDK文档中找到AI类目为视频生产（videoenhan）类目的SDK包进行安装。'."\n" + .'><notice>'."\n" + .'本能力仅限企业认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/document_detail/428525.html)。'."\n" + .'></notice>'."\n" ."\n" - .' - 参考文档中提供的示例代码进行适当修改后调用。'."\n" + .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videoenhan/2020-03-20/DeleteFaceVideoTemplate?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'5. 前提条件：已通过视频人脸融合模板增加（AddFaceVideoTemplate）创建生成了TemplateId。'."\n" + .'6. 开发接入步骤： '."\n" + .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" + .'- 在对应语言的SDK文档中找到AI类目为视频生产（videoenhan）类目的SDK包进行安装。'."\n" + .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 示例代码：该能力常用语言的示例代码，请参见[视频综合增强示例代码](~~602942~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" + .'7. 示例代码：该能力常用语言的示例代码，请参见[视频人脸融合模板删除示例代码](~~602697~~)。'."\n" ."\n" - .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'8. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" - .'- [iOS端直接调用](~~467782~~)'."\n" - ."\n" - .'## 输入限制'."\n" - ."\n" - .'- 视频类型：MP4、AVI、MKV、MOV、FLV、TS、MPG、MXF。'."\n" - .'- 视频大小：不超过1 GB。'."\n" - .'- 视频时长：不超过10分钟。'."\n" - .'- 视频分辨率：输入的视频分辨率大于360×360像素，小于1920×1080像素。设置的输出宽高应该不小于原始宽高的1/2且不大于原始宽高的4倍。'."\n" - .'- URL地址不能包含中文字符。'."\n" - ."\n" - .'## 计费说明'."\n" - .'关于视频综合增强的计费方式及报价，请参见[计费介绍](~~202487~~)。'."\n" - ."\n" - .'> 下方调试接口为付费接口。'."\n" - ."\n" - .'## 调用步骤'."\n" - .'该能力为异步能力，需分两步进行调用。'."\n" - .'第一步调用EnhanceVideoQuality接口提交任务，请求成功后，得到一个任务ID。'."\n" - .'第二步调用[GetAsyncJobResult](~~607824~~)接口查询结果，根据任务ID查询任务执行状态和结果。如果任务还在处理中，可稍等一段时间后再进行查询。当同一个任务还未处理完时，建议不要重复提交任务。', - 'requestParamsDescription' => ' ', - 'responseParamsDescription' => '## 查询结果'."\n" - .'该接口为异步接口，当前并未返回真实的请求结果，您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见[GetAsyncJobResult](~~607824~~)。'."\n" - ."\n" - .'## SDK参考'."\n" - .'阿里云视觉AI视频生产类目下的视频综合增强能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为视频生产（videoenhan）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + .'- [iOS端直接调用](~~467782~~)', + 'responseParamsDescription' => '## SDK参考'."\n" + .'阿里云视觉AI视频生产类目下的视频人脸融合模板删除能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为视频生产（videoenhan）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" - .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[视频综合增强示例代码](~~602942~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。', + .'##示例代码'."\n" + .'该能力常用语言的示例代码，请参见[视频人脸融合模板删除示例代码](~~602697~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于视频综合增强的错误码，详情请参见[常见错误码](~~159313~~)。'."\n" + .'关于视频人脸融合模板删除的错误码，详情请参见[常见错误码](~~159313~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n", - ], - 'GenerateVideo' => [ - 'methods' => [ - 'post', + 'changeSet' => [ + ['createdAt' => '2022-12-02T02:35:23.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2021-04-09T08:28:59.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteFaceVideoTemplate'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:DeleteFaceVideoTemplate', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'EnhancePortraitVideo' => [ + 'summary' => '本文介绍视频生产（videoenhan）类目下的视频人像增强EnhancePortraitVideo的语法及示例。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ - 'name' => 'Scene', - 'in' => 'formData', - 'schema' => [ - 'description' => '生成视频场景类型。取值如下：'."\n" - ."\n" - .'- costume：服饰场景（默认）'."\n" - .'- general：通用场景'."\n" - .'- keeporder：强制按输入素材顺序合成视频场景', - 'type' => 'string', - 'required' => false, - 'example' => 'costume', - ], - ], - [ - 'name' => 'Width', - 'in' => 'formData', - 'schema' => [ - 'description' => '输出视频的width，取值范围32~2160。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '640', - ], - ], - [ - 'name' => 'Height', - 'in' => 'formData', - 'schema' => [ - 'description' => '输出视频的height，取值范围32~2160。若width和height均没有设置，则按照750×750输出。如果设置了其中一个，则按照1:1输出。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '640', - ], - ], - [ - 'name' => 'Style', - 'in' => 'formData', - 'schema' => [ - 'description' => '输出视频节奏。可选normal、fast、slow。默认为normal。', - 'type' => 'string', - 'required' => false, - 'example' => 'fast', - ], - ], - [ - 'name' => 'Duration', - 'in' => 'formData', - 'schema' => [ - 'description' => '输出视频时长，单位为秒。默认为20秒。'."\n" - .'视频输出最短为5秒，最长为60秒。', - 'type' => 'number', - 'format' => 'float', - 'required' => false, - 'example' => '10', - ], - ], - [ - 'name' => 'DurationAdaption', - 'in' => 'formData', - 'schema' => [ - 'description' => '输出视频时长自适应。取值true或false，为true时`Duration`设置不生效。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], - ], - [ - 'name' => 'TransitionStyle', - 'in' => 'formData', - 'schema' => [ - 'description' => '镜头转场风格。共计15种风格。如果没有设置则按照`Style`随机。'."\n" - .'目前支持的镜头转场风格包括：basic（无）、slow（舒缓）、fast（动感）、normal（自然）、ink（水墨）、glitch（机械故障）、shift（切换）、mosaic（马赛克）、shutter（百叶窗）、zoom（缩放）、mask（遮罩）、brush（笔刷）、wind（风舞）、smog（烟雾）。', - 'type' => 'string', - 'required' => false, - 'example' => 'brush', - ], - ], - [ - 'name' => 'SmartEffect', - 'in' => 'formData', - 'schema' => [ - 'description' => '是否添加智能特效，默认为true。当前支持音画联动和静转动特效。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], - ], - [ - 'name' => 'PuzzleEffect', - 'in' => 'formData', - 'schema' => [ - 'description' => '是否动态拼图特效，支持在单镜头中通过拼图展示多个视频图像素材。默认为false。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], - ], - [ - 'name' => 'Mute', - 'in' => 'formData', - 'schema' => [ - 'description' => '生成视频是否静音。默认为false。'."\n" - ."\n" - .'> 如果没有音乐素材或视频素材无声时生成的视频没有音乐。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], - ], - [ - 'name' => 'FileList', + 'name' => 'VideoUrl', 'in' => 'formData', - 'style' => 'repeatList', - 'schema' => [ - 'description' => '1', - 'type' => 'array', - 'items' => [ - 'description' => '1', - 'type' => 'object', - 'properties' => [ - 'Type' => [ - 'description' => '输入文件类型。包括video、audio、image。'."\n" - .'可以同时输入多种素材（video+image+audio或video+image或video+audio或image+audio）。', - 'type' => 'string', - 'required' => true, - 'example' => 'video', - ], - 'FileUrl' => [ - 'description' => '输入文件URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" - .'输入限制：'."\n" - .'- 图片格式：JPG、PNG。'."\n" - .'- 图片大小：每张图片大于30 KB，小于100 MB。'."\n" - .'- 音频格式：MP3。'."\n" - .'- 视频格式：MP4、AVI、MKV、MOV。'."\n" - .'- 视频大小：不超过1 GB。'."\n" - .'- 视频素材最多5个，且总时长不超过3分钟，超过部分会被自动截断丢弃（按输入视频顺序保留前3分钟）。图像素材最多40个。音频素材最多1个。'."\n" - .'- URL地址中不能包含中文字符。'."\n", - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/videoenhan/GenerateVideo/1-video1.mp4', - 'isFileTransferUrl' => true, - ], - 'FileName' => [ - 'description' => '输入文件名称。视频音频文件格式为MP4或MP3时，可以忽略文件后缀。其他格式必须包含后缀。', - 'type' => 'string', - 'required' => true, - 'example' => '1-video1.mp4', - ], - ], - 'required' => false, - ], - 'required' => true, - 'maxItems' => 300, - ], + 'schema' => ['description' => '输入视频URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/xxx/shang/video/SD%289516100%29.mp4', 'isFileTransferUrl' => true], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => '1', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '7CB9B663-3EF8-4C9C-A464-FDA2B5F1E3A4', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'd21a2afa-4d52-4bca-803b-e65028146603'], 'Data' => [ - 'description' => '返回的结果数据内容。'."\n" - .'该数据需要在异步任务执行成功后，通过调用[GetAsyncJobResult](~~607824~~)接口，对其Result字段进行JSON反序列化之后得到。', + 'description' => '返回的结果数据内容。该数据需要在异步任务执行成功后，通过调用[GetAsyncJobResult](~~607824~~)接口，对其Result字段进行JSON反序列化之后得到。', 'type' => 'object', 'properties' => [ - 'VideoCoverUrl' => [ - 'description' => '输出视频封面URL地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-gen/2021-05-07-15/B9MGfwxu.mp4?Expires=1620372653&OSSAccessKeyId=LTAI****************&Signature=F9flL1n5GPYaae0dLl%2F8D%2Bn4j6****', - ], - 'VideoUrl' => [ - 'description' => '输出视频URL地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-gen/2021-05-07-15/B9MGfwxu.jpg?Expires=1620372653&OSSAccessKeyId=LTAI****************&Signature=djBvGvdJu8bd%2FC%2BVHdg1d57U%2Bu****', - ], + 'VideoUrl' => ['description' => '处理后的视频URL地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://vibktprfx-prod-prod-xstream-cn-shanghai.oss-cn-shanghai.aliyuncs.com/xstream-framework/upload_result_video_2023-02-10_09.45.55.mp4?Expires=1675995564&OSSAccessKeyId=LTAI****************&Signature=aIXTeM4IU4nARjy3SNA3YGhhqj****'], ], ], - 'Message' => [ - 'description' => '提交异步任务后的提示信息。', - 'type' => 'string', - 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。', - ], + 'Message' => ['description' => '提交异步任务后的提示信息。', 'type' => 'string', 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。'], ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"7CB9B663-3EF8-4C9C-A464-FDA2B5F1E3A4\\",\\n \\"Data\\": {\\n \\"VideoCoverUrl\\": \\"http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-gen/2021-05-07-15/B9MGfwxu.mp4?Expires=1620372653&OSSAccessKeyId=LTAI****************&Signature=F9flL1n5GPYaae0dLl%2F8D%2Bn4j6****\\",\\n \\"VideoUrl\\": \\"http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-gen/2021-05-07-15/B9MGfwxu.jpg?Expires=1620372653&OSSAccessKeyId=LTAI****************&Signature=djBvGvdJu8bd%2FC%2BVHdg1d57U%2Bu****\\"\\n },\\n \\"Message\\": \\"该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"<GenerateVideoResponse>\\n <RequestId>7CB9B663-3EF8-4C9C-A464-FDA2B5F1E3A4</RequestId>\\n <Message>该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>\\n</GenerateVideoResponse>","errorExample":""}]', - 'title' => '通用视频生成', - 'summary' => '本文介绍通用视频生成GenerateVideo的语法及示例。', + 'staticInfo' => ['returnType' => 'synchronous'], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"d21a2afa-4d52-4bca-803b-e65028146603\\",\\n \\"Data\\": {\\n \\"VideoUrl\\": \\"http://vibktprfx-prod-prod-xstream-cn-shanghai.oss-cn-shanghai.aliyuncs.com/xstream-framework/upload_result_video_2023-02-10_09.45.55.mp4?Expires=1675995564&OSSAccessKeyId=LTAI****************&Signature=aIXTeM4IU4nARjy3SNA3YGhhqj****\\"\\n },\\n \\"Message\\": \\"该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"<EnhancePortraitVideoResponse>\\n <RequestId>d21a2afa-4d52-4bca-803b-e65028146603</RequestId>\\n <Message>该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>\\n</EnhancePortraitVideoResponse>","errorExample":""}]', + 'title' => '视频人像增强', 'description' => '## 功能描述'."\n" - .'通用视频生成能力可以根据输入的原始视频，智能生成营销短视频。支持图像、视频、音频等素材混合处理，支持转场特效等加工效果叠加。输入视频的场景类型可选择服饰场景（默认）或通用场景，通过分析视频中的人和物，生成故事线来组织素材的顺序。您也可以通过输入参数的设置强制按输入素材顺序合成视频场景。'."\n" - ."\n" - .'通用视频生成能力主要包含以下功能点：'."\n" - .'- 输入文件类型：支持video（视频）、audio（音频）、image（图像）中的一种或多种。'."\n" - .'- 输出视频节奏：可选normal（普通）、fast（快）、slow（慢），默认为normal（普通）。'."\n" - .'- 镜头转场风格的选择：共计15种风格，如果没有设置则按照Style随机，目前支持的镜头转场风格包括：basic（无）、slow（舒缓）、fast（动感）、normal（自然）、ink（水墨）、glitch（机械故障）、shift（切换）、mosaic（马赛克）、shutter（百叶窗）、zoom（缩放）、mask（遮罩）、brush（笔刷）、wind（风舞）、smog（烟雾）。'."\n" - .'- 智能特效：当前支持音画联动和静转动特效，默认添加。'."\n" - .'- 动态拼图特效：支持在单镜头中通过拼图展示多个视频图像素材，默认不添加。'."\n" + .'视频人像增强能力基于GPEN人像增强模型，对视频中的人脸进行清晰度提升，显著增加面部细节和质感，同时通过人脸质量评估算法与动态调整融合系数，保持增强后人脸的自然和真实。'."\n" ."\n" - .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=videoenhan&children=GenerateVideo)对该能力进行更直观试用以及在线购买。'."\n" + .'>- 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?tagName=videoenhan&children=EnhancePortraitVideo)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 应用场景'."\n" - .'- 信息流广告制作：基于提供的素材批量生成广告视频，进行低成本投放。'."\n" - .'- 短视频二次加工：基于提供的视频内容和图片素材，进行新的视频素材制作。'."\n" + ."\n" + .'- 老旧视频的人脸增强修复。'."\n" + .'- 拍摄素材的清晰度提升，超高清视频制作。'."\n" ."\n" .'## 特色优势'."\n" - .'- 全自动生产：根据业务需要配置参数，自动化生产视频。'."\n" - .'- 功能丰富：支持多种素材输入，支持转场特效等，实现更丰富的业务场景应用。'."\n" + ."\n" + .'- 显著提升人脸清晰度：通过深度学习进行面部增强，显著增加面部细节和质感。'."\n" + .'- 保持人脸稳定自然：通过人脸质量评估算法与动态调整融合系数，保持增强后人脸的自然和真实。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[视频生产服务](https://vision.aliyun.com/videoenhan)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_videoenhan_public_cn#/open)。'."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videoenhan/2020-03-20/GenerateVideo?lang=JAVA&sdkStyle=dara¶ms=%7B%22FileList%22%3A%5B%7B%22FileUrl%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FGenerateVideo%2F1-video1.mp4%22%2C%22Type%22%3A%22video%22%2C%22FileName%22%3A%221-video1%22%7D%2C%7B%22FileUrl%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FGenerateVideo%2F1-video2.mp4%22%2C%22Type%22%3A%22video%22%2C%22FileName%22%3A%221-video2%22%7D%2C%7B%22FileUrl%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FGenerateVideo%2F1-pic1.jpg%22%2C%22Type%22%3A%22image%22%2C%22FileName%22%3A%221-pic1%22%7D%2C%7B%22FileUrl%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FGenerateVideo%2F1-pic2.jpg%22%2C%22Type%22%3A%22image%22%2C%22FileName%22%3A%221-pic2%22%7D%2C%7B%22FileUrl%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FGenerateVideo%2F1-pic3.jpg%22%2C%22Type%22%3A%22image%22%2C%22FileName%22%3A%221-pic3%22%7D%2C%7B%22FileUrl%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FGenerateVideo%2F1-pic4.jpg%22%2C%22Type%22%3A%22image%22%2C%22FileName%22%3A%221-pic4%22%7D%2C%7B%22FileUrl%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FGenerateVideo%2FI%2520Dunno-Grapes_spinningmerkaba.mp3%22%2C%22Type%22%3A%22audio%22%2C%22FileName%22%3A%22I%2520Dunno-Grapes_spinningmerkaba%22%7D%5D%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" - .'5. 开发接入步骤： '."\n" - .' - 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" - .' - 在对应语言的SDK文档中找到AI类目为视频生产（videoenhan）类目的SDK包进行安装。'."\n" - .' - 参考文档中提供的示例代码进行适当修改后调用。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videoenhan/2020-03-20/EnhancePortraitVideo?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'5. 开发接入步骤： '."\n" + .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" + .'- 在对应语言的SDK文档中找到AI类目为视频生产（videoenhan）类目的SDK包进行安装。'."\n" + .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 示例代码：该能力常用语言的示例代码，请参见[通用视频生成示例代码](~~478975~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[视频人像增强示例代码](~~613162~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" ."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" @@ -993,46 +694,38 @@ ."\n" .'## 输入限制'."\n" ."\n" - .'- 图片格式：JPG、PNG。'."\n" - .'- 图片大小：每张图片大于30 KB，小于100 MB。'."\n" - .'- 音频格式：MP3。'."\n" - .'- 视频格式：MP4、AVI、MKV、MOV。'."\n" + .'- 视频类型：MP4、AVI、MKV、MOV、FLV、TS、MPG、MXF。'."\n" .'- 视频大小：不超过1 GB。'."\n" - .'- 视频素材最多5个，且总时长不超过3分钟，超过部分会被自动截断丢弃（按输入视频顺序保留前3分钟）。图像素材最多40个。音频素材最多1个。'."\n" - .'- URL地址中不能包含中文字符。'."\n" - ."\n" - .'## 计费说明'."\n" - .'关于通用视频生成的计费方式及报价，请参见[计费介绍](~~202487~~)。'."\n" - .'> 下方调试接口为付费接口。'."\n" + .'- 视频分辨率：小于1920×1080像素。'."\n" + .'- URL地址不能包含中文字符。'."\n" ."\n" .'## 调用步骤'."\n" .'该能力为异步能力，需分两步进行调用。'."\n" - .'第一步调用GenerateVideo接口提交任务，请求成功后，得到一个任务ID。'."\n" - .'第二步调用[GetAsyncJobResult](~~607824~~)接口查询结果，根据任务ID查询任务执行状态和结果。如果任务还在处理中，可稍等一段时间后再进行查询。当同一个任务还未处理完时，建议不要重复提交任务。', + .'第一步调用EnhancePortraitVideo接口提交任务，请求成功后，得到一个任务ID。'."\n" + .'第二步调用[GetAsyncJobResult](~~607824~~)接口查询结果，根据任务ID查询任务执行状态和结果。如果任务还在处理中，可稍等一段时间后再进行查询。当同一个任务还未处理完时，建议不要重复提交任务。'."\n" + ."\n" + .'## 计费说明'."\n" + .'视频人像增强能力目前处于公测期，可免费调用。', 'responseParamsDescription' => '## 查询结果'."\n" - .'您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。具体操作，请参见[GetAsyncJobResult](~~607824~~)。其中Result字段为返回结果的JSON序列化字符串，JSON中字段说明请参见返回数据中的Data参数。'."\n" + .'该接口为异步接口，当前并未返回真实的请求结果，您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见[GetAsyncJobResult](~~607824~~)。'."\n" ."\n" .'## SDK参考'."\n" - .'阿里云视觉AI视频生产类目下的通用视频生成能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为视频生产（videoenhan）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + .'阿里云视觉AI视频生产类目下的视频人像增强能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为视频生产（videoenhan）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[通用视频生成示例代码](~~478975~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。'."\n", + .'该能力常用语言的示例代码，请参见[视频人像增强示例代码](~~613162~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。', 'extraInfo' => '## 错误码'."\n" - .'具体请参见[常见错误码](~~159313~~)。'."\n" + .'关于视频人像增强的错误码，详情请参见[常见错误码](~~159313~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n", + 'changeSet' => [], + 'ramActions' => [], ], - 'InterpolateVideoFrame' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'EnhanceVideoQuality' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -1045,39 +738,40 @@ [ 'name' => 'VideoURL', '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/videoenhan/InterpolateVideoFrame/InterpolateVideoFrame3.mp4', - 'isFileTransferUrl' => true, - ], + 'schema' => ['description' => '输入视频URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'https://invi-label.oss-cn-shanghai.aliyuncs.com/label/temp/faceswap/test_for_api/xxxx.mp4', 'isFileTransferUrl' => true], + ], + [ + 'name' => 'OutPutWidth', + 'in' => 'formData', + 'schema' => ['description' => '输出视频的宽，默认为输入2倍，单位为px，取值范围`[180,7680]`。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '7680', 'minimum' => '180', 'example' => '2560'], + ], + [ + 'name' => 'OutPutHeight', + 'in' => 'formData', + 'schema' => ['description' => '输出视频的高，默认为输入2倍，单位为px，取值范围`[180,4320]`。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '4320', 'minimum' => '180', 'example' => '1920'], ], [ 'name' => 'FrameRate', 'in' => 'formData', - 'schema' => [ - 'description' => '输出视频的帧率，默认输入50，取值范围`[1,120]`。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '120', - 'minimum' => '1', - 'example' => '70', - ], + 'schema' => ['description' => '输出视频的帧率，默认50帧，取值范围`[1,120]`。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '120', 'minimum' => '1', 'example' => '50'], + ], + [ + 'name' => 'HDRFormat', + 'in' => 'formData', + 'schema' => ['description' => '输出视频的HDR格式，仅支持PQ和HLG两种格式，默认为PQ。', 'type' => 'string', 'required' => false, 'example' => 'PQ', 'default' => 'PQ'], + ], + [ + 'name' => 'MaxIlluminance', + 'in' => 'formData', + 'schema' => ['description' => '输出视频最大亮度，单位为nit。'."\n" + ."\n" + .'- 在**PQ**模式下该参数固定为600nit，输入无效。'."\n" + .'- 在**HLG**模式下该参数取值范围为500nit~1000nit，默认1000nit。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '1000', 'minimum' => '500', 'example' => '600'], ], [ 'name' => 'Bitrate', 'in' => 'formData', - 'schema' => [ - 'description' => '输出视频码率，单位为Mbps，默认20 Mbps，取值范围`[8,200]`', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '200', - 'minimum' => '8', - 'example' => '30', - ], + 'schema' => ['description' => '输出视频码率，单位为MB，默认20MB，取值范围`[8,200]`。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '200', 'minimum' => '8', 'example' => '20'], ], ], 'responses' => [ @@ -1085,87 +779,70 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '7EF85B5B-FB44-4C3E-9B8F-08C6CD912CEB', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '881F39DC-C107-4817-A6D5-000BE833CC2A'], 'Data' => [ 'description' => '返回的结果数据内容。该数据需要在异步任务执行成功后，通过调用[GetAsyncJobResult](~~607824~~)接口，对其Result字段进行JSON反序列化之后得到。', 'type' => 'object', 'properties' => [ - 'VideoURL' => [ - 'description' => '处理结果视频URL地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-interp/20-12-22/mRsPNVunG7717nne_20-12-22-07-29-51.mp4?Expires=1608624020&OSSAccessKeyId=LTAI****************&Signature=NFjSLll8E7E1tkuLPFyTpr6ULi****', - ], + 'VideoURL' => ['description' => '处理后的视频URL地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/uhd-enhance/20-11-20/Wwzf9z75GO5XdisS_20-11-20-07-13-48.mp4?Expires=1605858272&OSSAccessKeyId=LTAI****************&Signature=vvY0D%2Bl5eEzp%2BD7mPOWz0zMU7v****'], ], ], - 'Message' => [ - 'description' => '提交异步任务后的提示信息。', - 'type' => 'string', - 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。', - ], + 'Message' => ['description' => '提交异步任务后的提示信息。', 'type' => 'string', 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。'], ], + '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\\": \\"7EF85B5B-FB44-4C3E-9B8F-08C6CD912CEB\\",\\n \\"Data\\": {\\n \\"VideoURL\\": \\"http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-interp/20-12-22/mRsPNVunG7717nne_20-12-22-07-29-51.mp4?Expires=1608624020&OSSAccessKeyId=LTAI****************&Signature=NFjSLll8E7E1tkuLPFyTpr6ULi****\\"\\n },\\n \\"Message\\": \\"该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"<InterpolateVideoFrameResponse>\\n <RequestId>7EF85B5B-FB44-4C3E-9B8F-08C6CD912CEB</RequestId>\\n <Message>该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>\\n</InterpolateVideoFrameResponse>","errorExample":""}]', - 'title' => '视频插帧', - 'summary' => '本文介绍视频插帧InterpolateVideoFrame的语法及示例。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"881F39DC-C107-4817-A6D5-000BE833CC2A\\",\\n \\"Data\\": {\\n \\"VideoURL\\": \\"http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/uhd-enhance/20-11-20/Wwzf9z75GO5XdisS_20-11-20-07-13-48.mp4?Expires=1605858272&OSSAccessKeyId=LTAI****************&Signature=vvY0D%2Bl5eEzp%2BD7mPOWz0zMU7v****\\"\\n },\\n \\"Message\\": \\"该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"<EnhanceVideoQualityResponse>\\n <RequestId>881F39DC-C107-4817-A6D5-000BE833CC2A</RequestId>\\n <Message>该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>\\n</EnhanceVideoQualityResponse>","errorExample":""}]', + 'title' => '视频综合增强', + 'summary' => '本文介绍视频综合增强EnhanceVideoQuality的语法及示例。', 'description' => '## 功能描述'."\n" - .'视频插帧能力基于深度学习的帧率上变换，通过插帧网络合成任意时刻的视频帧，从而优化解决视频中卡顿、抖动等画质问题。'."\n" + .'视频综合增强能力基于AI深度学习算法，可以对输入的SDR视频进行插帧、超分辨率SR、SDR转HDR综合增强处理。'."\n" ."\n" - .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=videoenhan&children=InterpolateVideoFrame)对该能力进行更直观试用以及在线购买。'."\n" + .'>- 生成的视频是标准HDR格式视频，请在合适的HDR设备上播放。'."\n" + .'- 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 应用场景'."\n" ."\n" - .'- 高帧率视频制作：视频网站通过该技术，可以将低帧率视频转化为高帧率视频，让视频观影体验更流畅，提升观看效果。'."\n" - .'- 慢动作视频制作：将普通帧率（如25帧）视频插帧后，再按正常帧率播放，成为慢动作视频。'."\n" + .'- 高清视频播放系统：对于非高清、非超高清、SDR的片源，通过视频综合增强，可以转化成高清、超高清、HDR、更高帧率的视频，给观众更好的观影体验。'."\n" + .'- 家庭视频增强：受限于过去拍摄设备的技术水平，珍贵的家庭视频以较低分辨率保存，在现在的高清设备上播放时，观看效果较差。通过视频综合增强，可以获得更高清的观看效果，适应当前的播放技术发展。'."\n" ."\n" .'## 特色优势'."\n" - .'基于深度学习算法，推理出中间帧中物体对象的变化位置，让插帧后的视频更加流畅，且无抖动、顿挫等现象。'."\n" + ."\n" + .'- 真实的细节展示：能够真实推理出画面中的明暗变化细节，让您获得真正的HDR体验。'."\n" + .'- 更流畅的画面：可推理出原视频帧间的动作变化，加入更多视频帧，让画面更流畅。'."\n" + .'- 更高的分辨率：将画面分辨率提升的同时，优化画面细节、纹理和锐度等，同时抑制块噪声和压缩噪声等现象。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[视频生产服务](https://vision.aliyun.com/videoenhan)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_videoenhan_public_cn#/open)。'."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videoenhan/2020-03-20/InterpolateVideoFrame?lang=JAVA&sdkStyle=dara¶ms=%7B%22VideoURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FInterpolateVideoFrame%2FInterpolateVideoFrame1.mp4%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videoenhan/2020-03-20/EnhanceVideoQuality?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" - .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" - .'- 在对应语言的SDK文档中找到AI类目为视频生产（videoenhan）类目的SDK包进行安装。'."\n" - .' - 参考文档中提供的示例代码进行适当修改后调用。'."\n" + .' '."\n" + .' - 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" ."\n" - .'6. 示例代码：该能力常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" + .' - 在对应语言的SDK文档中找到AI类目为视频生产（videoenhan）类目的SDK包进行安装。'."\n" + ."\n" + .' - 参考文档中提供的示例代码进行适当修改后调用。'."\n" + ."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[视频综合增强示例代码](~~602942~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" ."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" @@ -1177,43 +854,59 @@ ."\n" .'- 视频类型：MP4、AVI、MKV、MOV、FLV、TS、MPG、MXF。'."\n" .'- 视频大小：不超过1 GB。'."\n" - .'- 视频分辨率：不小于360×360像素，不大于1920×1080像素。'."\n" + .'- 视频时长：不超过10分钟。'."\n" + .'- 视频分辨率：输入的视频分辨率大于360×360像素，小于1920×1080像素。设置的输出宽高应该不小于原始宽高的1/2且不大于原始宽高的4倍。'."\n" .'- URL地址不能包含中文字符。'."\n" ."\n" .'## 计费说明'."\n" - .'关于视频插帧的计费方式及报价，请参见[计费介绍](~~202487~~)。'."\n" + .'关于视频综合增强的计费方式及报价，请参见[计费介绍](~~202487~~)。'."\n" ."\n" .'> 下方调试接口为付费接口。'."\n" - ."\n\n" + ."\n" .'## 调用步骤'."\n" .'该能力为异步能力，需分两步进行调用。'."\n" - .'第一步调用InterpolateVideoFrame接口提交任务，请求成功后，得到一个任务ID。'."\n" + .'第一步调用EnhanceVideoQuality接口提交任务，请求成功后，得到一个任务ID。'."\n" .'第二步调用[GetAsyncJobResult](~~607824~~)接口查询结果，根据任务ID查询任务执行状态和结果。如果任务还在处理中，可稍等一段时间后再进行查询。当同一个任务还未处理完时，建议不要重复提交任务。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## 查询结果'."\n" - .'该接口为异步接口，当前并未返回真实的请求结果，您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见[GetAsyncJobResult](~~607974~~)。'."\n" + .'该接口为异步接口，当前并未返回真实的请求结果，您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见[GetAsyncJobResult](~~607824~~)。'."\n" ."\n" .'## SDK参考'."\n" - .'阿里云视觉AI视频生产类目下的视频插帧能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为视频生产（videoenhan）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + .'阿里云视觉AI视频生产类目下的视频综合增强能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为视频生产（videoenhan）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" - .'# 示例代码'."\n" - .'该能力常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。', + .'## 示例代码'."\n" + .'该能力常用语言的示例代码，请参见[视频综合增强示例代码](~~602942~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于视频插帧的错误码，详情请参见[常见错误码](~~159313~~)。'."\n" + .'关于视频综合增强的错误码，详情请参见[常见错误码](~~159313~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n", - ], - 'MergeVideoFace' => [ - 'methods' => [ - 'post', - 'get', + 'changeSet' => [ + ['createdAt' => '2022-10-17T02:05:11.000Z', 'description' => '响应参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'EnhanceVideoQuality'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:EnhanceVideoQuality', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'EraseVideoLogo' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -1224,177 +917,74 @@ 'systemTags' => [], 'parameters' => [ [ - 'name' => 'VideoURL', - '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/videoenhan/MergeVideoFace/MergeVideoFace1.mp4', - 'isFileTransferUrl' => true, - ], - ], - [ - 'name' => 'ReferenceURL', - 'in' => 'formData', - 'schema' => [ - 'description' => '替换后的人脸参考图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" - .'输入限制：'."\n" - .'- 图像格式：JPEG、JPG、PNG。'."\n" - .'- 图像分辨率：大于等于128×128像素，小于等于4000×4000像素。'."\n" - .'- 图像大小：不大于20 MB。'."\n" - .'- URL地址不能包含中文字符。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/videoenhan/MergeVideoFace/MergeVideoFace-pic1.png', - 'isFileTransferUrl' => true, - ], - ], - [ - 'name' => 'AddWatermark', - 'in' => 'formData', - 'schema' => [ - 'description' => '是否添加水印。取值范围如下：'."\n" - ."\n" - .'- True（默认）：添加水印。'."\n" - .'- False：不添加水印。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'True', - 'default' => 'true', - ], - ], - [ - 'name' => 'Enhance', + 'name' => 'VideoUrl', 'in' => 'formData', - 'schema' => [ - 'description' => '是否开启人脸美颜增强。取值范围如下：'."\n" - ."\n" - .'- False（默认）：不开启人脸美颜增强。'."\n" - .'- True：开启人脸美颜增强。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'False', - 'default' => 'false', - ], + 'schema' => ['description' => '视频URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/videoenhan/EraseVideoLogo/EraseVideoLogo1.mp4', 'isFileTransferUrl' => true], ], [ - 'name' => 'WatermarkType', + 'name' => 'Boxes', 'in' => 'formData', + 'style' => 'repeatList', 'schema' => [ - 'description' => '水印类型。取值范围如下：'."\n" - ."\n" - .'- EN（默认）：英文水印。'."\n" - .'- CN：中文水印。', - 'type' => 'string', + 'description' => 'Logo区域位置信息。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'W' => ['description' => 'Logo区域宽度与视频宽度的占比值，取值0~1。', 'type' => 'number', 'format' => 'float', 'required' => false, 'example' => '1.0'], + 'H' => ['description' => 'Logo区域高度与视频高度的占比值，取值0~1。', 'type' => 'number', 'format' => 'float', 'required' => false, 'example' => '1.0'], + 'Y' => ['description' => 'Logo区域左上角点y坐标与视频高度的占比值，取值0~1。', 'type' => 'number', 'format' => 'float', 'required' => false, 'example' => '0.0'], + 'X' => ['description' => 'Logo区域左上角点x坐标与视频宽度的占比值，取值0~1。', 'type' => 'number', 'format' => 'float', 'required' => false, 'example' => '0.0'], + ], + 'required' => false, + 'description' => '', + ], 'required' => false, - 'example' => 'EN', - 'default' => 'EN', + 'maxItems' => 100, ], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'DEF90E76-B62D-45EF-8835-CA3C83842B18', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '95532F36-98FC-4DCD-815C-282BB26D2DA1'], 'Data' => [ - 'description' => '返回的结果数据内容。'."\n" - .'该数据需要在异步任务执行成功后，通过调用[GetAsyncJobResult](~~607824~~)接口，对其Result字段进行JSON反序列化之后得到。', + 'description' => '返回的结果数据内容。该数据需要在异步任务执行成功后，通过调用[GetAsyncJobResult](~~607824~~)接口，对其Result字段进行JSON反序列化之后得到。', 'type' => 'object', 'properties' => [ - 'VideoURL' => [ - 'description' => '处理后的视频URL地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-face-fusion/A657011C-82B4-4705-A5DB-69B18B7CE89D.mp4?Expires=1606378308&OSSAccessKeyId=LTAI****************&Signature=Hl3cq5XedTGCscOSr0OGVxAS2o****', - ], + 'VideoUrl' => ['description' => '输出处理后的视频URL地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://algo-app-aic-vd-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/video-delogo/2020-03-20-11/53%3A56-DGNUGG7AcRlAylhr.mp4?Expires=1584707036&OSSAccessKeyId=LTAI****************&Signature=7CvsX7X1rSU%2B%2FDxnw484lb3LCD****'], ], ], - 'Message' => [ - 'description' => '提交异步任务后的提示信息。', - 'type' => 'string', - 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。', - ], + 'Message' => ['description' => '提交异步任务后的提示信息。', 'type' => 'string', 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。'], ], + 'description' => '', ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'ParameterError', - 'errorMessage' => 'The parameter is invalid. Please check again.', - ], - ], - 403 => [ - [ - 'errorCode' => 'AuthFailed', - 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', - ], - ], - 408 => [ - [ - 'errorCode' => 'Timeout', - 'errorMessage' => 'The request has timed out.', - ], - ], - 503 => [ - [ - 'errorCode' => 'ServiceUnavailable', - 'errorMessage' => 'The service is unavailable.', - ], - ], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"DEF90E76-B62D-45EF-8835-CA3C83842B18\\",\\n \\"Data\\": {\\n \\"VideoURL\\": \\"http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-face-fusion/A657011C-82B4-4705-A5DB-69B18B7CE89D.mp4?Expires=1606378308&OSSAccessKeyId=LTAI****************&Signature=Hl3cq5XedTGCscOSr0OGVxAS2o****\\"\\n },\\n \\"Message\\": \\"该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"<MergeVideoFaceResponse>\\n <RequestId>DEF90E76-B62D-45EF-8835-CA3C83842B18</RequestId>\\n <Message>该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>\\n</MergeVideoFaceResponse>","errorExample":""}]', - 'title' => '视频人脸融合', - 'summary' => '本文介绍视频人脸融合MergeVideoFace的语法及示例。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"95532F36-98FC-4DCD-815C-282BB26D2DA1\\",\\n \\"Data\\": {\\n \\"VideoUrl\\": \\"http://algo-app-aic-vd-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/video-delogo/2020-03-20-11/53%3A56-DGNUGG7AcRlAylhr.mp4?Expires=1584707036&OSSAccessKeyId=LTAI****************&Signature=7CvsX7X1rSU%2B%2FDxnw484lb3LCD****\\"\\n },\\n \\"Message\\": \\"该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"<EraseVideoLogoResponse>\\n <RequestId>95532F36-98FC-4DCD-815C-282BB26D2DA1</RequestId>\\n <Message>该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>\\n</EraseVideoLogoResponse>","errorExample":""}]', + 'title' => '视频标志擦除', + 'summary' => '本文介绍视频标志擦除EraseVideoLogo的语法及示例。', 'description' => '## 功能描述'."\n" - .'在获得用户授权的前提下，通用视频人脸融合能力可以将视频中检测到的最大人脸，融合进另一个人的人脸特征，达到换脸的感官效果。'."\n" - .'通用视频人脸融合只需要输入一张带融合人脸图像与一段视频，就可以将图像人脸融合进视频中。'."\n" - .'适用场景：'."\n" - .'- 每次合成独立完成，无通用模板场景。'."\n" - .'- 仅支持视频中只有一张人脸的场景。'."\n" - ."\n" - .'如需使用多人场景或有固定数量的视频模板，请参见[模板视频人脸融合](~~467950~~)（MergeVideoModelFace）。'."\n" - .'为保证生成内容的安全合法，请勿使用公众人物或涉及敏感信息的图像或视频进行融合，同时，本服务也会在合成结果的左下角处添加**Generated by AI**的水印内容，效果如下图所示。'."\n" - .''."\n" + .'视频标志擦除能力可以擦除视频中的常见标志，如台标、互联网平台logo等。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=videoenhan&children=MergeVideoFace)对该能力进行更直观试用以及在线购买。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=videoenhan&children=EraseVideoLogo)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" - .'## 应用场景'."\n" - .'- 影视后期制作：在影视后期制作时，因为某些原因需要替换演员，通过视频人脸融合技术，可利用前期拍摄素材进行处理，让前期视频素材中的人物看起来是新的演员在表演，可以为制片方节省大量的重新拍摄成本。'."\n" - .'- 娱乐性短视频制作：用户可以将自己的人脸和已获授权的合法视频中的人物人脸进行融合，生成趣味性视频。'."\n" - ."\n" - .'## 特色优势'."\n" - .'- 高保真、低违和效果：融合后的人脸保留了替换者人脸身份信息的视觉特征，而融入被替换者人脸中又无违和感。'."\n" - .'- 表情肤色一致性：融合后的人脸最大限度保留被替换者的面目表情、肤色一致性。'."\n" - .'- 支持复杂人脸角度：支持模板人脸偏侧一定角度，融合后的结果真实稳定。'."\n" - ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[视频生产服务](https://vision.aliyun.com/videoenhan)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_videoenhan_public_cn#/open)。'."\n" - ."\n" - .'><notice>于2024年7月17日及以后开通该能力的用户可直接调用，不需提交申请。'."\n" - .'2024年7月17日之前开通该服务的用户如需调用，可通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们添加到白名单。'."\n" - .'></notice>'."\n" - ."\n\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videoenhan/2020-03-20/MergeVideoFace?lang=JAVA&sdkStyle=dara¶ms=%7B%22VideoURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FMergeVideoFace%2FMergeVideoFace1.mp4%22%2C%22ReferenceURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FMergeVideoFace%2FMergeVideoFace-pic1.png%22%2C%22PostURL%22%3A%22%20%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videoenhan/2020-03-20/EraseVideoLogo?lang=JAVA&sdkStyle=dara¶ms=%7B%22VideoUrl%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FEraseVideoLogo%2FEraseVideoLogo1.mp4%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为视频生产（videoenhan）类目的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 示例代码：该能力常用语言的示例代码，请参见[视频人脸融合示例代码](~~602481~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[视频标志擦除示例代码](~~477825~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" ."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" @@ -1403,61 +993,62 @@ .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" - .'- 视频类型：MP4、AVI、MKV、MOV、FLV、TS、MPG。'."\n" - .'- 视频分辨率：大于360×360像素，小于1920×1920像素。'."\n" - .'- 视频大小：不大于120 MB。'."\n" - .'- 图像格式：JPEG、JPG、PNG。'."\n" - .'- 图像分辨率：大于等于128×128像素，小于等于4000×4000像素。'."\n" - .'- 图像大小：不大于20 MB。'."\n" - .'- URL地址不能包含中文字符。'."\n" - .'- 视频只支持静态（恒定）帧率视频，暂不支持动态（可变）帧率视频。'."\n" - .'- 视频时长不大于300s，大于300s的视频请调用[模板视频人脸融合](~~467950~~)接口。'."\n" ."\n" - .'## 图像质量建议'."\n" - ."\n" - .'- 要求保证图像中的人脸清晰。图像中人脸尺寸建议大于64×64像素，人脸区域建议不大于全图区域的2/3。'."\n" - .'- 建议图像中人脸五官区域轮廓完整，无明显遮挡。人脸融合算法支持人脸偏侧一定角度，在偏侧角度不超过30度的情况下能取得更佳效果。'."\n" - .'- 建议待融合人脸的图像中只包含一张人脸，如果包含多张人脸，则默认选择图像中最大的人脸进行融合。'."\n" + .'- 视频格式：MP4。'."\n" + .'- 视频大小：不超过1 GB。'."\n" + .'- 视频分辨率：不超过1080P。'."\n" + .'- URL地址中不能包含中文字符。'."\n" + .'- 最多支持同时设置2个标志擦除区域，设置擦除区域超过2个，超出区域将会被忽略。'."\n" ."\n" - .'推荐图像示例：'."\n" - .''."\n" + .'## 计费说明'."\n" + .'关于视频标志擦除的计费方式及报价，请参见[计费介绍](~~202487~~)。'."\n" ."\n" - .'不推荐图像示例：'."\n" - .''."\n" + .'> 下方调试接口为付费接口。'."\n" ."\n" .'## 调用步骤'."\n" .'该能力为异步能力，需分两步进行调用。'."\n" - .'第一步调用MergeVideoFace接口提交任务，请求成功后，得到一个任务ID。'."\n" - .'第二步调用[GetAsyncJobResult](~~607824~~)接口查询结果，根据任务ID查询任务执行状态和结果。如果任务还在处理中，可稍等一段时间后再进行查询。当同一个任务还未处理完时，建议不要重复提交任务。'."\n" - ."\n" - .'## 计费说明'."\n" - .'关于通用视频人脸融合的计费方式及报价，请参见[计费介绍](~~202487~~)。'."\n" - ."\n" - .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=videoenhan&children=MergeVideoFace)。', + .'第一步调用EraseVideoLogo接口提交任务，请求成功后，得到一个任务ID。'."\n" + .'第二步调用[GetAsyncJobResult](~~607824~~)接口查询结果，根据任务ID查询任务执行状态和结果。如果任务还在处理中，可稍等一段时间后再进行查询。当同一个任务还未处理完时，建议不要重复提交任务。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## 查询结果'."\n" .'该接口为异步接口，当前并未返回真实的请求结果，您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见[GetAsyncJobResult](~~607824~~)。'."\n" ."\n" .'## SDK参考'."\n" - .'阿里云视觉AI视频生产类目下的通用视频人脸融合能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为视频生产（videoenhan）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + .'阿里云视觉AI视频生产类目下的视频标志擦除能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为视频生产（videoenhan）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[通用视频人脸融合示例代码](~~602481~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。', + .'该能力常用语言的示例代码，请参见[视频标志擦除示例代码](~~477825~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于视频人脸融合的错误码，详情请参见[常见错误码](~~159313~~)。'."\n" + .'具体请参见[常见错误码](~~159313~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n", - ], - 'SuperResolveVideo' => [ - 'methods' => [ - 'post', + .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', + 'changeSet' => [ + ['createdAt' => '2022-10-17T02:05:11.000Z', 'description' => '响应参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'EraseVideoLogo'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:EraseVideoLogo', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'EraseVideoSubtitles' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -1470,24 +1061,27 @@ [ 'name' => 'VideoUrl', '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/videoenhan/SuperResolveVideo/SuperResolveVideo2.mp4', - '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/videoenhan/EraseVideoSubtitles/EraseVideoSubtitles1.mp4', 'isFileTransferUrl' => true], ], [ - 'name' => 'BitRate', + 'name' => 'BX', 'in' => 'formData', - 'schema' => [ - 'description' => '输出视频编码率，单位为Mbps，默认10 Mbps。取值范围1~20。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '5', - ], + 'schema' => ['description' => '字幕区域左上角点x坐标/视频宽度，取值0~1。', 'type' => 'number', 'format' => 'float', 'required' => false, 'example' => '0'], + ], + [ + 'name' => 'BY', + 'in' => 'formData', + 'schema' => ['description' => '字幕区域左上角点y坐标/视频高度，取值0~1。', 'type' => 'number', 'format' => 'float', 'required' => false, 'example' => '0.75'], + ], + [ + 'name' => 'BW', + 'in' => 'formData', + 'schema' => ['description' => '字幕区域的宽度/视频宽度，取值0~1。', 'type' => 'number', 'format' => 'float', 'required' => false, 'example' => '1'], + ], + [ + 'name' => 'BH', + 'in' => 'formData', + 'schema' => ['description' => '字幕区域的高度/视频高度，取值0~1。', 'type' => 'number', 'format' => 'float', 'required' => false, 'example' => '0.25'], ], ], 'responses' => [ @@ -1495,63 +1089,41 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '186AC396-0EEC-46F1-AAA1-BF3585227427', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'CCB082BF-A6B1-4C28-9E49-562EEE7DE639'], 'Data' => [ 'description' => '返回的结果数据内容。该数据需要在异步任务执行成功后，通过调用[GetAsyncJobResult](~~607824~~)接口，对其Result字段进行JSON反序列化之后得到。', 'type' => 'object', 'properties' => [ - 'VideoUrl' => [ - 'description' => '输出处理后的视频URL地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://algo-app-aic-vd-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/video-super-resolution/2020-03-20-12/12%3A11-UlLVELFzIy5EAyEh.mp4?Expires=1584708132&OSSAccessKeyId=LTAI****************&Signature=0V8yKrCVybC4KIPtRuGKJDJaQT****', - ], + 'VideoUrl' => ['description' => '输出处理后的视频URL地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://algo-app-aic-vd-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/video-desubtitle/2021-04-13-10/41%3A57-TcFd6Zug7gXwbeqs.mp4?Expires=1618312317&OSSAccessKeyId=LTAI****************&Signature=LZnGSQ8019%2Br5rcR4vKOaaT2UE****'], ], ], - 'Message' => [ - 'description' => '提交异步任务后的提示信息。', - 'type' => 'string', - 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。', - ], + 'Message' => ['description' => '提交异步任务后的提示信息。', 'type' => 'string', 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。'], ], + 'description' => '', ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"186AC396-0EEC-46F1-AAA1-BF3585227427\\",\\n \\"Data\\": {\\n \\"VideoUrl\\": \\"http://algo-app-aic-vd-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/video-super-resolution/2020-03-20-12/12%3A11-UlLVELFzIy5EAyEh.mp4?Expires=1584708132&OSSAccessKeyId=LTAI****************&Signature=0V8yKrCVybC4KIPtRuGKJDJaQT****\\"\\n },\\n \\"Message\\": \\"该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"<SuperResolveVideoResponse>\\n <RequestId>186AC396-0EEC-46F1-AAA1-BF3585227427</RequestId>\\n <Message>该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>\\n</SuperResolveVideoResponse>","errorExample":""}]', - 'title' => '视频超分辨', - 'summary' => '视频超分辨率。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"CCB082BF-A6B1-4C28-9E49-562EEE7DE639\\",\\n \\"Data\\": {\\n \\"VideoUrl\\": \\"http://algo-app-aic-vd-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/video-desubtitle/2021-04-13-10/41%3A57-TcFd6Zug7gXwbeqs.mp4?Expires=1618312317&OSSAccessKeyId=LTAI****************&Signature=LZnGSQ8019%2Br5rcR4vKOaaT2UE****\\"\\n },\\n \\"Message\\": \\"该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"<EraseVideoSubtitlesResponse>\\n <RequestId>CCB082BF-A6B1-4C28-9E49-562EEE7DE639</RequestId>\\n <Message>该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>\\n</EraseVideoSubtitlesResponse>","errorExample":""}]', + 'title' => '视频字幕擦除', + 'summary' => '本文介绍视频字幕擦除EraseVideoSubtitles的语法及示例。', 'description' => '## 功能描述'."\n" - .'视频超分辨能力可以将输入视频放大2倍尺寸输出，并基于细节推断增强输出视频画质，输出视频为h264编码、MP4格式。'."\n" - ."\n" + .'视频字幕擦除能力可以擦除全视频中都出现文字的区域，如电影电视剧中下方的白色字幕。若视频中字幕位置字体较大，则擦除效果会有所降低；对于封面，视频字幕擦除能力是通过将全视频抽帧的方式来检测擦除区域，若封面中字幕出现时间不足1秒，则字幕位置会被忽略。'."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=videoenhan&children=SuperResolveVideo)对该能力进行更直观试用以及在线购买。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=videoenhan&children=EraseVideoSubtitles)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" - .'## 应用场景'."\n" - ."\n" - .'- 旧视频翻新：基于深度学习的视频超分辨算法，可将低分辨率的视频，增强转化为高分辨视频。'."\n" - .'- 网络视频播放：在低带宽条件下传输低分辨率视频，再通过视频超分辨算法，将视频在播放端还原成高分辨视频。'."\n" - ."\n" - .'## 特色优势'."\n" - ."\n" - .'- 基于深度学习算法，推理出的视频细节更真实。'."\n" - .'- 以原视频两倍尺寸输出，获得更大分辨率增加效果。'."\n" - ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[视频生产服务](https://vision.aliyun.com/videoenhan)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_videoenhan_public_cn#/open)。'."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videoenhan/2020-03-20/SuperResolveVideo?lang=JAVA&sdkStyle=dara¶ms=%7B%22VideoUrl%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FSuperResolveVideo%2FSuperResolveVideo1.mp4%22%2C%22BitRate%22%3A5%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videoenhan/2020-03-20/EraseVideoSubtitles?lang=JAVA&sdkStyle=dara¶ms=%7B%22VideoUrl%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FEraseVideoSubtitles%2FEraseVideoSubtitles1.mp4%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为视频生产（videoenhan）类目的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 示例代码：该能力常用语言的示例代码，请参见[视频超分辨示例代码](~~602945~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[视频字幕擦除示例代码](~~602965~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" ."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" @@ -1561,162 +1133,142 @@ ."\n" .'## 输入限制'."\n" ."\n" - .'- 视频格式：MP4，AVI，MKV，MOV， FLV，TS，MPG，MXF。'."\n" - .'- 视频大小：不超过1 GB。'."\n" - .'- 视频分辨率：大于360×360像素，小于1920×1080像素。'."\n" + .'- 视频格式：MP4。'."\n" + .'- 视频大小：不超过1GB。'."\n" + .'- 视频分辨率：不超过1080P。'."\n" .'- URL地址中不能包含中文字符。'."\n" + .'- 支持常规中文/英文字幕，比如纯色电影字幕。不支持复杂的花体字幕，字体笔画过于纤细的字幕。'."\n" ."\n" .'## 计费说明'."\n" - .'关于视频超分辨的计费方式及报价，请参见[计费介绍](~~202487~~)。'."\n" + .'关于视频字幕擦除的计费方式及报价，请参见[计费介绍](~~202487~~)。'."\n" ."\n" .'> 下方调试接口为付费接口。'."\n" ."\n" .'## 调用步骤'."\n" .'该能力为异步能力，需分两步进行调用。'."\n" - .'第一步调用SuperResolveVideo接口提交任务，请求成功后，得到一个任务ID。'."\n" + .'第一步调用EraseVideoSubtitles接口提交任务，请求成功后，得到一个任务ID。'."\n" .'第二步调用[GetAsyncJobResult](~~607824~~)接口查询结果，根据任务ID查询任务执行状态和结果。如果任务还在处理中，可稍等一段时间后再进行查询。当同一个任务还未处理完时，建议不要重复提交任务。', - 'requestParamsDescription' => ' ', + 'requestParamsDescription' => ' > bx、by、bw、bh，定义一个字幕区域，只有字幕区域内的字幕会被擦除，默认视频下方区域：`（bx=0,by=0.75,bw=1,bh=0.25）`。', 'responseParamsDescription' => '## 查询结果'."\n" .'该接口为异步接口，当前并未返回真实的请求结果，您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见[GetAsyncJobResult](~~607824~~)。'."\n" ."\n" .'## SDK参考'."\n" - .'阿里云视觉AI视频生产类目下的视频超分辨能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为视频生产（videoenhan）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + .'阿里云视觉AI视频生产类目下的视频字幕擦除能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为视频生产（videoenhan）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[视频超分辨示例代码](~~602945~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。', + .'该能力常用语言的示例代码，请参见[视频字幕擦除示例代码](~~602965~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。', 'extraInfo' => '## 错误码'."\n" - .'具体请参见[常见错误码](~~159313~~)。'."\n" + .'关于视频字幕擦除的错误码，具体请参见[常见错误码](~~159313~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'EraseVideoLogo' => [ - 'methods' => [ - 'post', + .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n", + 'changeSet' => [ + ['createdAt' => '2022-10-17T02:05:11.000Z', 'description' => '响应参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'EraseVideoSubtitles'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:EraseVideoSubtitles', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'GenerateHumanAnimeStyleVideo' => [ + 'summary' => '本文介绍视频生产（videoenhan）类目下的视频人像卡通化GenerateHumanAnimeStyleVideo的语法及示例。', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'VideoUrl', '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/videoenhan/EraseVideoLogo/EraseVideoLogo1.mp4', - 'isFileTransferUrl' => true, - ], + 'schema' => ['description' => '视频URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/xxx/eas/EvaluateVideoQuality/123.mp4', 'isFileTransferUrl' => true], ], [ - 'name' => 'Boxes', + 'name' => 'CartoonStyle', 'in' => 'formData', - 'style' => 'repeatList', - 'schema' => [ - 'description' => 'Logo区域位置信息。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'W' => [ - 'description' => 'Logo区域宽度与视频宽度的占比值，取值0~1。', - 'type' => 'number', - 'format' => 'float', - 'required' => false, - 'example' => '1.0', - ], - 'H' => [ - 'description' => 'Logo区域高度与视频高度的占比值，取值0~1。', - 'type' => 'number', - 'format' => 'float', - 'required' => false, - 'example' => '1.0', - ], - 'Y' => [ - 'description' => 'Logo区域左上角点y坐标与视频高度的占比值，取值0~1。', - 'type' => 'number', - 'format' => 'float', - 'required' => false, - 'example' => '0.0', - ], - 'X' => [ - 'description' => 'Logo区域左上角点x坐标与视频宽度的占比值，取值0~1。', - 'type' => 'number', - 'format' => 'float', - 'required' => false, - 'example' => '0.0', - ], - ], - 'required' => false, - ], - 'required' => false, - 'maxItems' => 100, - ], + 'schema' => ['description' => '卡通化的风格。取值如下：'."\n" + ."\n" + .'- anime：日漫风'."\n" + .'- 3d：3D特效'."\n" + .'- handdrawn：手绘风'."\n" + .'- sketch：铅笔画'."\n" + .'- artstyle：艺术特效', 'type' => 'string', 'required' => true, 'example' => 'anime'], ], ], 'responses' => [ 200 => [ + 'headers' => [], 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '95532F36-98FC-4DCD-815C-282BB26D2DA1', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'd21a2afa-4d52-4bca-803b-e65028146603'], 'Data' => [ 'description' => '返回的结果数据内容。该数据需要在异步任务执行成功后，通过调用[GetAsyncJobResult](~~607824~~)接口，对其Result字段进行JSON反序列化之后得到。', 'type' => 'object', 'properties' => [ - 'VideoUrl' => [ - 'description' => '输出处理后的视频URL地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://algo-app-aic-vd-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/video-delogo/2020-03-20-11/53%3A56-DGNUGG7AcRlAylhr.mp4?Expires=1584707036&OSSAccessKeyId=LTAI****************&Signature=7CvsX7X1rSU%2B%2FDxnw484lb3LCD****', - ], + 'VideoUrl' => ['description' => '输出处理后的视频URL地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://vibktprfx-prod-prod-xstream-cn-shanghai.oss-cn-shanghai.aliyuncs.com/xstream-framework/upload_result_video_2023-02-10_09.45.55.mp4?Expires=1675995564&OSSAccessKeyId=LTAI****************&Signature=aIXTeM4IU4nARjy3SNA3YGhhqj****'], ], ], - 'Message' => [ - 'description' => '提交异步任务后的提示信息。', - 'type' => 'string', - 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。', - ], + 'Message' => ['description' => '提交异步任务后的提示信息。', 'type' => 'string', 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。'], ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"95532F36-98FC-4DCD-815C-282BB26D2DA1\\",\\n \\"Data\\": {\\n \\"VideoUrl\\": \\"http://algo-app-aic-vd-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/video-delogo/2020-03-20-11/53%3A56-DGNUGG7AcRlAylhr.mp4?Expires=1584707036&OSSAccessKeyId=LTAI****************&Signature=7CvsX7X1rSU%2B%2FDxnw484lb3LCD****\\"\\n },\\n \\"Message\\": \\"该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"<EraseVideoLogoResponse>\\n <RequestId>95532F36-98FC-4DCD-815C-282BB26D2DA1</RequestId>\\n <Message>该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>\\n</EraseVideoLogoResponse>","errorExample":""}]', - 'title' => '视频标志擦除', - 'summary' => '本文介绍视频标志擦除EraseVideoLogo的语法及示例。', + 'staticInfo' => ['returnType' => 'synchronous'], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"d21a2afa-4d52-4bca-803b-e65028146603\\",\\n \\"Data\\": {\\n \\"VideoUrl\\": \\"http://vibktprfx-prod-prod-xstream-cn-shanghai.oss-cn-shanghai.aliyuncs.com/xstream-framework/upload_result_video_2023-02-10_09.45.55.mp4?Expires=1675995564&OSSAccessKeyId=LTAI****************&Signature=aIXTeM4IU4nARjy3SNA3YGhhqj****\\"\\n },\\n \\"Message\\": \\"该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"<GenerateHumanAnimeStyleVideoResponse>\\n <RequestId>d21a2afa-4d52-4bca-803b-e65028146603</RequestId>\\n <Message>该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>\\n</GenerateHumanAnimeStyleVideoResponse>","errorExample":""}]', + 'title' => '视频人像卡通化', 'description' => '## 功能描述'."\n" - .'视频标志擦除能力可以擦除视频中的常见标志，如台标、互联网平台logo等。'."\n" + .'根据输入的人像视频进行卡通化转换，返回风格化后的视频结果。支持日漫（anime）、3D（3d）、手绘（handdrawn）、铅笔画（sketch）、艺术特效（artstyle）风格。'."\n" + .'关于该接口功能的示例图如下：'."\n" + .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20230221/symy/GenerateHumanAnimeStyleVideo.png" width="600)'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=videoenhan&children=EraseVideoLogo)对该能力进行更直观试用以及在线购买。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?tagName=videoenhan&children=GenerateHumanAnimeStyleVideo)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" + .'## 应用场景'."\n" + .'- 趣味视频处理：上传人像视频，即可生成专属动漫化形象，塑造可爱氛围，可用于互动推广、趣味相册等应用场景。'."\n" + .'- 隐私保护：为保护图像中的人物隐私，将人物卡通化，可避免识别出原人物是谁。与马赛克等处理方法相比，更具趣味性，更易于用户接受，提升用户体验。'."\n" + ."\n" + .'## 特色优势'."\n" + .'- 内容高保真：基于深度学习算法，能有效保留原图中的人物表情、配饰、背景等细节内容特征。'."\n" + .'- 多种风格选择：提供多种不同特效的风格选择，实现差异化的制作效果，满足不同场景和数据要求。'."\n" + .'- 全身卡通化：全图的精细化风格转换，相比人脸卡通化，可避免笑场等尴尬场景。'."\n" + .'- 多人模式：可处理情侣照、家庭照、团体类照片。'."\n" + ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[视频生产服务](https://vision.aliyun.com/videoenhan)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_videoenhan_public_cn#/open)。'."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videoenhan/2020-03-20/EraseVideoLogo?lang=JAVA&sdkStyle=dara¶ms=%7B%22VideoUrl%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FEraseVideoLogo%2FEraseVideoLogo1.mp4%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videoenhan/2020-03-20/GenerateHumanAnimeStyleVideo?lang=JAVA&useCommon=true)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为视频生产（videoenhan）类目的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 示例代码：该能力常用语言的示例代码，请参见[视频标志擦除示例代码](~~477825~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[视频人像卡通化示例代码](~~608844~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" ."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" @@ -1725,46 +1277,59 @@ .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" - ."\n" - .'- 视频格式：MP4。'."\n" - .'- 视频大小：不超过1 GB。'."\n" - .'- 视频分辨率：不超过1080P。'."\n" + .'- 支持的视频类型：MP4、AVI、MKV、FLV、MOV、MPG、TS、MXF。'."\n" + .'- 建议输入视频分辨率不超过1920x1080像素。'."\n" + .'- 视频大小不超过1 GB。'."\n" .'- URL地址中不能包含中文字符。'."\n" - .'- 最多支持同时设置2个标志擦除区域，设置擦除区域超过2个，超出区域将会被忽略。'."\n" + .'- 视频帧画面里人数不超过5人，超过5人会影响实际效果。'."\n" ."\n" .'## 计费说明'."\n" - .'关于视频标志擦除的计费方式及报价，请参见[计费介绍](~~202487~~)。'."\n" - ."\n" - .'> 下方调试接口为付费接口。'."\n" + .'该接口返回结果中不会包含计费信息，视频人像卡通化按照视频**输出时长**进行计费，时长最小计量单位为秒，时长不足1秒按照1秒进行计费。计费方式及报价详情，请参见[计费介绍](~~202487~~)。'."\n" ."\n" + .'> - 下方调试接口为付费接口。'."\n" + .'- 该能力为异步能力，调用失败不计费，通过RequestId查询结果不计费。'."\n" + ."\n\n" .'## 调用步骤'."\n" .'该能力为异步能力，需分两步进行调用。'."\n" - .'第一步调用EraseVideoLogo接口提交任务，请求成功后，得到一个任务ID。'."\n" + .'第一步调用GenerateHumanAnimeStyleVideo接口提交任务，请求成功后，得到一个任务ID。'."\n" .'第二步调用[GetAsyncJobResult](~~607824~~)接口查询结果，根据任务ID查询任务执行状态和结果。如果任务还在处理中，可稍等一段时间后再进行查询。当同一个任务还未处理完时，建议不要重复提交任务。', - 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## 查询结果'."\n" .'该接口为异步接口，当前并未返回真实的请求结果，您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见[GetAsyncJobResult](~~607824~~)。'."\n" ."\n" .'## SDK参考'."\n" - .'阿里云视觉AI视频生产类目下的视频标志擦除能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为视频生产（videoenhan）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + .'阿里云视觉AI视频生产类目下的视频人像卡通化能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为视频生产（videoenhan）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[视频标志擦除示例代码](~~477825~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。', + .'该能力常用语言的示例代码，请参见[视频人像卡通化示例代码](~~608844~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。'."\n", 'extraInfo' => '## 错误码'."\n" - .'具体请参见[常见错误码](~~159313~~)。'."\n" + .'关于视频人像卡通化的错误码，具体请参见[常见错误码](~~159313~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', - ], - 'EraseVideoSubtitles' => [ - 'methods' => [ - 'post', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GenerateHumanAnimeStyleVideo'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:GenerateHumanAnimeStyleVideo', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'GenerateVideo' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -1775,112 +1340,153 @@ 'systemTags' => [], 'parameters' => [ [ - 'name' => 'VideoUrl', + 'name' => 'Scene', '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/videoenhan/EraseVideoSubtitles/EraseVideoSubtitles1.mp4', - 'isFileTransferUrl' => true, - ], + 'schema' => ['description' => '生成视频场景类型。取值如下：'."\n" + ."\n" + .'- costume：服饰场景（默认）'."\n" + .'- general：通用场景'."\n" + .'- keeporder：强制按输入素材顺序合成视频场景', 'type' => 'string', 'required' => false, 'example' => 'costume'], ], [ - 'name' => 'BX', + 'name' => 'Width', 'in' => 'formData', - 'schema' => [ - 'description' => '字幕区域左上角点x坐标/视频宽度，取值0~1。', - 'type' => 'number', - 'format' => 'float', - 'required' => false, - 'example' => '0', - ], + 'schema' => ['description' => '输出视频的width，取值范围32~2160。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '640'], ], [ - 'name' => 'BY', + 'name' => 'Height', 'in' => 'formData', - 'schema' => [ - 'description' => '字幕区域左上角点y坐标/视频高度，取值0~1。', - 'type' => 'number', - 'format' => 'float', - 'required' => false, - 'example' => '0.75', - ], + 'schema' => ['description' => '输出视频的height，取值范围32~2160。若width和height均没有设置，则按照750×750输出。如果设置了其中一个，则按照1:1输出。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '640'], ], [ - 'name' => 'BW', + 'name' => 'Style', 'in' => 'formData', - 'schema' => [ - 'description' => '字幕区域的宽度/视频宽度，取值0~1。', - 'type' => 'number', - 'format' => 'float', - 'required' => false, - 'example' => '1', - ], + 'schema' => ['description' => '输出视频节奏。可选normal、fast、slow。默认为normal。', 'type' => 'string', 'required' => false, 'example' => 'fast'], ], [ - 'name' => 'BH', + 'name' => 'Duration', + 'in' => 'formData', + 'schema' => ['description' => '输出视频时长，单位为秒。默认为20秒。'."\n" + .'视频输出最短为5秒，最长为60秒。', 'type' => 'number', 'format' => 'float', 'required' => false, 'example' => '10'], + ], + [ + 'name' => 'DurationAdaption', + 'in' => 'formData', + 'schema' => ['description' => '输出视频时长自适应。取值true或false，为true时`Duration`设置不生效。', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + ], + [ + 'name' => 'TransitionStyle', + 'in' => 'formData', + 'schema' => ['description' => '镜头转场风格。共计15种风格。如果没有设置则按照`Style`随机。'."\n" + .'目前支持的镜头转场风格包括：basic（无）、slow（舒缓）、fast（动感）、normal（自然）、ink（水墨）、glitch（机械故障）、shift（切换）、mosaic（马赛克）、shutter（百叶窗）、zoom（缩放）、mask（遮罩）、brush（笔刷）、wind（风舞）、smog（烟雾）。', 'type' => 'string', 'required' => false, 'example' => 'brush'], + ], + [ + 'name' => 'SmartEffect', + 'in' => 'formData', + 'schema' => ['description' => '是否添加智能特效，默认为true。当前支持音画联动和静转动特效。', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + ], + [ + 'name' => 'PuzzleEffect', + 'in' => 'formData', + 'schema' => ['description' => '是否动态拼图特效，支持在单镜头中通过拼图展示多个视频图像素材。默认为false。', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + ], + [ + 'name' => 'Mute', 'in' => 'formData', + 'schema' => ['description' => '生成视频是否静音。默认为false。'."\n" + ."\n" + .'> 如果没有音乐素材或视频素材无声时生成的视频没有音乐。', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + ], + [ + 'name' => 'FileList', + 'in' => 'formData', + 'style' => 'repeatList', 'schema' => [ - 'description' => '字幕区域的高度/视频高度，取值0~1。', - 'type' => 'number', - 'format' => 'float', - 'required' => false, - 'example' => '0.25', + 'description' => '1', + 'type' => 'array', + 'items' => [ + 'description' => '1', + 'type' => 'object', + 'properties' => [ + 'Type' => ['description' => '输入文件类型。包括video、audio、image。'."\n" + .'可以同时输入多种素材（video+image+audio或video+image或video+audio或image+audio）。', 'type' => 'string', 'required' => true, 'example' => 'video'], + 'FileUrl' => ['description' => '输入文件URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" + .'输入限制：'."\n" + .'- 图片格式：JPG、PNG。'."\n" + .'- 图片大小：每张图片大于30 KB，小于100 MB。'."\n" + .'- 音频格式：MP3。'."\n" + .'- 视频格式：MP4、AVI、MKV、MOV。'."\n" + .'- 视频大小：不超过1 GB。'."\n" + .'- 视频素材最多5个，且总时长不超过3分钟，超过部分会被自动截断丢弃（按输入视频顺序保留前3分钟）。图像素材最多40个。音频素材最多1个。'."\n" + .'- URL地址中不能包含中文字符。'."\n", 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/videoenhan/GenerateVideo/1-video1.mp4', 'isFileTransferUrl' => true], + 'FileName' => ['description' => '输入文件名称。视频音频文件格式为MP4或MP3时，可以忽略文件后缀。其他格式必须包含后缀。', 'type' => 'string', 'required' => true, 'example' => '1-video1.mp4'], + ], + 'required' => false, + ], + 'required' => true, + 'maxItems' => 300, ], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'CCB082BF-A6B1-4C28-9E49-562EEE7DE639', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '7CB9B663-3EF8-4C9C-A464-FDA2B5F1E3A4'], 'Data' => [ - 'description' => '返回的结果数据内容。该数据需要在异步任务执行成功后，通过调用[GetAsyncJobResult](~~607824~~)接口，对其Result字段进行JSON反序列化之后得到。', + 'description' => '返回的结果数据内容。'."\n" + .'该数据需要在异步任务执行成功后，通过调用[GetAsyncJobResult](~~607824~~)接口，对其Result字段进行JSON反序列化之后得到。', 'type' => 'object', 'properties' => [ - 'VideoUrl' => [ - 'description' => '输出处理后的视频URL地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://algo-app-aic-vd-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/video-desubtitle/2021-04-13-10/41%3A57-TcFd6Zug7gXwbeqs.mp4?Expires=1618312317&OSSAccessKeyId=LTAI****************&Signature=LZnGSQ8019%2Br5rcR4vKOaaT2UE****', - ], + 'VideoCoverUrl' => ['description' => '输出视频封面URL地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-gen/2021-05-07-15/B9MGfwxu.mp4?Expires=1620372653&OSSAccessKeyId=LTAI****************&Signature=F9flL1n5GPYaae0dLl%2F8D%2Bn4j6****'], + 'VideoUrl' => ['description' => '输出视频URL地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-gen/2021-05-07-15/B9MGfwxu.jpg?Expires=1620372653&OSSAccessKeyId=LTAI****************&Signature=djBvGvdJu8bd%2FC%2BVHdg1d57U%2Bu****'], ], ], - 'Message' => [ - 'description' => '提交异步任务后的提示信息。', - 'type' => 'string', - 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。', - ], + 'Message' => ['description' => '提交异步任务后的提示信息。', 'type' => 'string', 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。'], ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"CCB082BF-A6B1-4C28-9E49-562EEE7DE639\\",\\n \\"Data\\": {\\n \\"VideoUrl\\": \\"http://algo-app-aic-vd-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/video-desubtitle/2021-04-13-10/41%3A57-TcFd6Zug7gXwbeqs.mp4?Expires=1618312317&OSSAccessKeyId=LTAI****************&Signature=LZnGSQ8019%2Br5rcR4vKOaaT2UE****\\"\\n },\\n \\"Message\\": \\"该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"<EraseVideoSubtitlesResponse>\\n <RequestId>CCB082BF-A6B1-4C28-9E49-562EEE7DE639</RequestId>\\n <Message>该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>\\n</EraseVideoSubtitlesResponse>","errorExample":""}]', - 'title' => '视频字幕擦除', - 'summary' => '本文介绍视频字幕擦除EraseVideoSubtitles的语法及示例。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"7CB9B663-3EF8-4C9C-A464-FDA2B5F1E3A4\\",\\n \\"Data\\": {\\n \\"VideoCoverUrl\\": \\"http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-gen/2021-05-07-15/B9MGfwxu.mp4?Expires=1620372653&OSSAccessKeyId=LTAI****************&Signature=F9flL1n5GPYaae0dLl%2F8D%2Bn4j6****\\",\\n \\"VideoUrl\\": \\"http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-gen/2021-05-07-15/B9MGfwxu.jpg?Expires=1620372653&OSSAccessKeyId=LTAI****************&Signature=djBvGvdJu8bd%2FC%2BVHdg1d57U%2Bu****\\"\\n },\\n \\"Message\\": \\"该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"<GenerateVideoResponse>\\n <RequestId>7CB9B663-3EF8-4C9C-A464-FDA2B5F1E3A4</RequestId>\\n <Message>该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>\\n</GenerateVideoResponse>","errorExample":""}]', + 'title' => '通用视频生成', + 'summary' => '本文介绍通用视频生成GenerateVideo的语法及示例。', 'description' => '## 功能描述'."\n" - .'视频字幕擦除能力可以擦除全视频中都出现文字的区域，如电影电视剧中下方的白色字幕。若视频中字幕位置字体较大，则擦除效果会有所降低；对于封面，视频字幕擦除能力是通过将全视频抽帧的方式来检测擦除区域，若封面中字幕出现时间不足1秒，则字幕位置会被忽略。'."\n" + .'通用视频生成能力可以根据输入的原始视频，智能生成营销短视频。支持图像、视频、音频等素材混合处理，支持转场特效等加工效果叠加。输入视频的场景类型可选择服饰场景（默认）或通用场景，通过分析视频中的人和物，生成故事线来组织素材的顺序。您也可以通过输入参数的设置强制按输入素材顺序合成视频场景。'."\n" + ."\n" + .'通用视频生成能力主要包含以下功能点：'."\n" + .'- 输入文件类型：支持video（视频）、audio（音频）、image（图像）中的一种或多种。'."\n" + .'- 输出视频节奏：可选normal（普通）、fast（快）、slow（慢），默认为normal（普通）。'."\n" + .'- 镜头转场风格的选择：共计15种风格，如果没有设置则按照Style随机，目前支持的镜头转场风格包括：basic（无）、slow（舒缓）、fast（动感）、normal（自然）、ink（水墨）、glitch（机械故障）、shift（切换）、mosaic（马赛克）、shutter（百叶窗）、zoom（缩放）、mask（遮罩）、brush（笔刷）、wind（风舞）、smog（烟雾）。'."\n" + .'- 智能特效：当前支持音画联动和静转动特效，默认添加。'."\n" + .'- 动态拼图特效：支持在单镜头中通过拼图展示多个视频图像素材，默认不添加。'."\n" + ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=videoenhan&children=EraseVideoSubtitles)对该能力进行更直观试用以及在线购买。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=videoenhan&children=GenerateVideo)对该能力进行更直观试用以及在线购买。'."\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/videoenhan)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_videoenhan_public_cn#/open)。'."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videoenhan/2020-03-20/EraseVideoSubtitles?lang=JAVA&sdkStyle=dara¶ms=%7B%22VideoUrl%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FEraseVideoSubtitles%2FEraseVideoSubtitles1.mp4%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" - .'5. 开发接入步骤：'."\n" - .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" - .'- 在对应语言的SDK文档中找到AI类目为视频生产（videoenhan）类目的SDK包进行安装。'."\n" - .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videoenhan/2020-03-20/GenerateVideo?lang=JAVA&sdkStyle=dara¶ms=%7B%22FileList%22%3A%5B%7B%22FileUrl%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FGenerateVideo%2F1-video1.mp4%22%2C%22Type%22%3A%22video%22%2C%22FileName%22%3A%221-video1%22%7D%2C%7B%22FileUrl%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FGenerateVideo%2F1-video2.mp4%22%2C%22Type%22%3A%22video%22%2C%22FileName%22%3A%221-video2%22%7D%2C%7B%22FileUrl%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FGenerateVideo%2F1-pic1.jpg%22%2C%22Type%22%3A%22image%22%2C%22FileName%22%3A%221-pic1%22%7D%2C%7B%22FileUrl%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FGenerateVideo%2F1-pic2.jpg%22%2C%22Type%22%3A%22image%22%2C%22FileName%22%3A%221-pic2%22%7D%2C%7B%22FileUrl%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FGenerateVideo%2F1-pic3.jpg%22%2C%22Type%22%3A%22image%22%2C%22FileName%22%3A%221-pic3%22%7D%2C%7B%22FileUrl%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FGenerateVideo%2F1-pic4.jpg%22%2C%22Type%22%3A%22image%22%2C%22FileName%22%3A%221-pic4%22%7D%2C%7B%22FileUrl%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FGenerateVideo%2FI%2520Dunno-Grapes_spinningmerkaba.mp3%22%2C%22Type%22%3A%22audio%22%2C%22FileName%22%3A%22I%2520Dunno-Grapes_spinningmerkaba%22%7D%5D%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'5. 开发接入步骤： '."\n" + .' - 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" + .' - 在对应语言的SDK文档中找到AI类目为视频生产（videoenhan）类目的SDK包进行安装。'."\n" + .' - 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 示例代码：该能力常用语言的示例代码，请参见[视频字幕擦除示例代码](~~602965~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[通用视频生成示例代码](~~478975~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" ."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" @@ -1890,46 +1496,62 @@ ."\n" .'## 输入限制'."\n" ."\n" - .'- 视频格式：MP4。'."\n" - .'- 视频大小：不超过1GB。'."\n" - .'- 视频分辨率：不超过1080P。'."\n" + .'- 图片格式：JPG、PNG。'."\n" + .'- 图片大小：每张图片大于30 KB，小于100 MB。'."\n" + .'- 音频格式：MP3。'."\n" + .'- 视频格式：MP4、AVI、MKV、MOV。'."\n" + .'- 视频大小：不超过1 GB。'."\n" + .'- 视频素材最多5个，且总时长不超过3分钟，超过部分会被自动截断丢弃（按输入视频顺序保留前3分钟）。图像素材最多40个。音频素材最多1个。'."\n" .'- URL地址中不能包含中文字符。'."\n" - .'- 支持常规中文/英文字幕，比如纯色电影字幕。不支持复杂的花体字幕，字体笔画过于纤细的字幕。'."\n" ."\n" .'## 计费说明'."\n" - .'关于视频字幕擦除的计费方式及报价，请参见[计费介绍](~~202487~~)。'."\n" - ."\n" + .'关于通用视频生成的计费方式及报价，请参见[计费介绍](~~202487~~)。'."\n" .'> 下方调试接口为付费接口。'."\n" ."\n" .'## 调用步骤'."\n" .'该能力为异步能力，需分两步进行调用。'."\n" - .'第一步调用EraseVideoSubtitles接口提交任务，请求成功后，得到一个任务ID。'."\n" + .'第一步调用GenerateVideo接口提交任务，请求成功后，得到一个任务ID。'."\n" .'第二步调用[GetAsyncJobResult](~~607824~~)接口查询结果，根据任务ID查询任务执行状态和结果。如果任务还在处理中，可稍等一段时间后再进行查询。当同一个任务还未处理完时，建议不要重复提交任务。', - 'requestParamsDescription' => ' > bx、by、bw、bh，定义一个字幕区域，只有字幕区域内的字幕会被擦除，默认视频下方区域：`（bx=0,by=0.75,bw=1,bh=0.25）`。', 'responseParamsDescription' => '## 查询结果'."\n" - .'该接口为异步接口，当前并未返回真实的请求结果，您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见[GetAsyncJobResult](~~607824~~)。'."\n" + .'您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。具体操作，请参见[GetAsyncJobResult](~~607824~~)。其中Result字段为返回结果的JSON序列化字符串，JSON中字段说明请参见返回数据中的Data参数。'."\n" ."\n" .'## SDK参考'."\n" - .'阿里云视觉AI视频生产类目下的视频字幕擦除能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为视频生产（videoenhan）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + .'阿里云视觉AI视频生产类目下的通用视频生成能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为视频生产（videoenhan）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[视频字幕擦除示例代码](~~602965~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。', + .'该能力常用语言的示例代码，请参见[通用视频生成示例代码](~~478975~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。'."\n", 'extraInfo' => '## 错误码'."\n" - .'关于视频字幕擦除的错误码，具体请参见[常见错误码](~~159313~~)。'."\n" + .'具体请参见[常见错误码](~~159313~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n", - ], - 'GetAsyncJobResult' => [ - 'methods' => [ - 'get', - 'post', + 'changeSet' => [ + ['createdAt' => '2022-11-10T08:55:40.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-10-17T02:05:11.000Z', 'description' => '响应参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GenerateVideo'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:GenerateVideo', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'GetAsyncJobResult' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -1937,19 +1559,12 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'create', - ], + 'systemTags' => ['operationType' => 'create'], 'parameters' => [ [ 'name' => 'JobId', 'in' => 'formData', - 'schema' => [ - 'description' => '异步接口返回的RequestId，输入后可以查询异步接口的真实请求结果。', - 'type' => 'string', - 'required' => true, - 'example' => 'E75FE679-0303-4DD1-8252-1143B4FA8A27', - ], + 'schema' => ['description' => '异步接口返回的RequestId，输入后可以查询异步接口的真实请求结果。', 'type' => 'string', 'required' => true, 'example' => 'E75FE679-0303-4DD1-8252-1143B4FA8A27'], ], ], 'responses' => [ @@ -1958,52 +1573,28 @@ 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '43A0AEB6-45F4-4138-8E89-E1A5D63200E3', - ], + 'RequestId' => ['description' => '请求ID。', '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' => '{\\"VideoUrl\\":\\"http://algo-app-aic-vd-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/video-super-resolution/2020-03-26-02/55%3A59-XFLsuEKpPxleHl4n.mp4?Expires=1585193159&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=OqsxMwAKsFVjPO%2Brgw%2BpXHIm6v****\\"}', - ], - 'ErrorCode' => [ - 'description' => '异步任务错误码。', - 'type' => 'string', - 'example' => 'InvalidParameter', - ], - 'JobId' => [ - 'description' => '异步任务ID。', - 'type' => 'string', - 'example' => '49E2CC28-ED1D-4CC5-854D-7D0AE2B20976', - ], + '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' => '{\\"VideoUrl\\":\\"http://algo-app-aic-vd-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/video-super-resolution/2020-03-26-02/55%3A59-XFLsuEKpPxleHl4n.mp4?Expires=1585193159&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=OqsxMwAKsFVjPO%2Brgw%2BpXHIm6v****\\"}'], + 'ErrorCode' => ['description' => '异步任务错误码。', 'type' => 'string', 'example' => 'InvalidParameter'], + 'JobId' => ['description' => '异步任务ID。', 'type' => 'string', 'example' => '49E2CC28-ED1D-4CC5-854D-7D0AE2B20976'], ], ], ], @@ -2037,16 +1628,29 @@ .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n", - ], - 'AddFaceVideoTemplate' => [ - 'summary' => '本文介绍视频人脸融合模版增加AddFaceVideoTemplate的语法及示例。', - 'methods' => [ - 'post', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetAsyncJobResult'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:GetAsyncJobResult', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'InterpolateVideoFrame' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -2054,122 +1658,87 @@ ], 'operationType' => 'readAndWrite', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'create', - 'riskType' => 'none', - 'chargeType' => 'free', - 'tenantRelevance' => 'publicInformation', - ], + 'systemTags' => [], 'parameters' => [ [ 'name' => 'VideoURL', 'in' => 'formData', - 'schema' => [ - 'description' => '视频模板的URL地址。当前仅支持上海地域的OSS链接，如何生成URL请参见[文件URL处理](~~155645~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'http://invi-label.oss-cn-shanghai.aliyuncs.com/labl/temp/faceswap/test_for_api/xxxx.mp4', - '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/videoenhan/InterpolateVideoFrame/InterpolateVideoFrame3.mp4', 'isFileTransferUrl' => true], ], [ - 'name' => 'VideoScene', + 'name' => 'FrameRate', 'in' => 'formData', - 'schema' => [ - 'description' => '判断视频换脸场景。取值如下：'."\n" - .'- single（默认）：单人视频换脸。'."\n" - .'- multi：多人视频换脸。'."\n" - ."\n" - .'> - 如果输入视频为单人物视频，**VideoScene**参数可以选择不输入或者传入`single`。'."\n" - .'- 如果输入视频为多人视频，**VideoScene**参数必须传入`multi`，后续可通过模板换脸接口进行多人一对一指定人脸融合。'."\n" - .'- 如果输入视频为多人视频，但用户只想替换其中某一个ID人物，则按照多人视频场景进行模板添加，即**VideoScene**参数传入`multi`值，后续可通过模板换脸接口指定想融合的具体人物。', - 'type' => 'string', - 'required' => false, - 'example' => 'single', - ], + 'schema' => ['description' => '输出视频的帧率，默认输入50，取值范围`[1,120]`。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '120', 'minimum' => '1', 'example' => '70'], + ], + [ + 'name' => 'Bitrate', + 'in' => 'formData', + 'schema' => ['description' => '输出视频码率，单位为Mbps，默认20 Mbps，取值范围`[8,200]`', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '200', 'minimum' => '8', 'example' => '30'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'F61182AE-515B-5B0A-A877-1C9AE908FF15', - ], - 'Message' => [ - 'description' => '提交异步任务后的提示信息。', - 'type' => 'string', - 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。', - ], - 'Date' => [ - 'description' => '返回的结果数据内容。该数据需要在异步任务执行成功后，通过调用[GetAsyncJobResult](~~159423~~)接口，对其Result字段进行JSON反序列化之后得到。', + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '7EF85B5B-FB44-4C3E-9B8F-08C6CD912CEB'], + 'Data' => [ + 'description' => '返回的结果数据内容。该数据需要在异步任务执行成功后，通过调用[GetAsyncJobResult](~~607824~~)接口，对其Result字段进行JSON反序列化之后得到。', 'type' => 'object', 'properties' => [ - 'TemplateId' => [ - 'description' => '模板ID。', - 'type' => 'string', - 'example' => '6cd509ea-54fa-4730-8e9d-c94cadcda048', - ], - 'FaceInfos' => [ - 'description' => '输入视频中存在多个人脸时，返回各人脸ID和各人脸裁剪后的图像。', - 'type' => 'array', - 'items' => [ - 'description' => '输入视频中存在多个人脸时，返回各人脸ID和各人脸裁剪后的图像。', - 'type' => 'object', - 'properties' => [ - 'TemplateFaceID' => [ - 'description' => '人脸对应的子模板ID。', - 'type' => 'string', - 'example' => '7d1a2498-0f9a-42d8-bae8-c7e478188106_0', - ], - 'TemplateFaceURL' => [ - 'description' => '人脸对应的子模板ID对应的人脸图。', - 'type' => 'string', - 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-face-fusion/template/xhtest_7d1a2498-0f9a-42d8-bae8-c7e478188106/xhtest_7d1a2498-0f9a-42d8-bae8-c7e478188106_0.png?Expires=1686040781&OSSAccessKeyId=LTAI****************&Signature=WVYTf%2F3knRuUPXSVGVz%2FZi3Miu****', - ], - ], - ], - ], - 'TransResult' => [ - 'description' => '视频帧的人脸位置转换矩阵文件，用于辅助用户校验换脸信息。', - 'type' => 'string', - 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-face-fusion/template/1952059581270833_308f1611-7de8-4f16-9175-f1e997caadf6-V1/1952059581270833_308f1611-7de8-4f16-9175-f1e997caadf6-V1_trans.npy?Expires=1717055504&OSSAccessKeyId=LTAI****************&Signature=zg784H1bv5hwaKPvAywp8p5Hla****', - ], + 'VideoURL' => ['description' => '处理结果视频URL地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-interp/20-12-22/mRsPNVunG7717nne_20-12-22-07-29-51.mp4?Expires=1608624020&OSSAccessKeyId=LTAI****************&Signature=NFjSLll8E7E1tkuLPFyTpr6ULi****'], ], ], + 'Message' => ['description' => '提交异步任务后的提示信息。', 'type' => 'string', 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。'], ], + 'description' => '', ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"F61182AE-515B-5B0A-A877-1C9AE908FF15\\",\\n \\"Message\\": \\"该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\",\\n \\"Date\\": {\\n \\"TemplateId\\": \\"6cd509ea-54fa-4730-8e9d-c94cadcda048\\",\\n \\"FaceInfos\\": [\\n {\\n \\"TemplateFaceID\\": \\"7d1a2498-0f9a-42d8-bae8-c7e478188106_0\\",\\n \\"TemplateFaceURL\\": \\"http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-face-fusion/template/xhtest_7d1a2498-0f9a-42d8-bae8-c7e478188106/xhtest_7d1a2498-0f9a-42d8-bae8-c7e478188106_0.png?Expires=1686040781&OSSAccessKeyId=LTAI****************&Signature=WVYTf%2F3knRuUPXSVGVz%2FZi3Miu****\\"\\n }\\n ],\\n \\"TransResult\\": \\"http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-face-fusion/template/1952059581270833_308f1611-7de8-4f16-9175-f1e997caadf6-V1/1952059581270833_308f1611-7de8-4f16-9175-f1e997caadf6-V1_trans.npy?Expires=1717055504&OSSAccessKeyId=LTAI****************&Signature=zg784H1bv5hwaKPvAywp8p5Hla****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<AddFaceVideoTemplateResponse>\\n <RequestId>F61182AE-515B-5B0A-A877-1C9AE908FF15</RequestId>\\n <Message>该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>\\n</AddFaceVideoTemplateResponse>","errorExample":""}]', - 'title' => '视频人脸融合模版增加', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], + ], + 403 => [ + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置，操作流程可参考https://help.aliyun.com/document_detail/145025.htm。'], + ], + 408 => [ + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '算法服务报错，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。 '], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"7EF85B5B-FB44-4C3E-9B8F-08C6CD912CEB\\",\\n \\"Data\\": {\\n \\"VideoURL\\": \\"http://vibktprfx-prod-prod-aic-vd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-interp/20-12-22/mRsPNVunG7717nne_20-12-22-07-29-51.mp4?Expires=1608624020&OSSAccessKeyId=LTAI****************&Signature=NFjSLll8E7E1tkuLPFyTpr6ULi****\\"\\n },\\n \\"Message\\": \\"该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"<InterpolateVideoFrameResponse>\\n <RequestId>7EF85B5B-FB44-4C3E-9B8F-08C6CD912CEB</RequestId>\\n <Message>该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>\\n</InterpolateVideoFrameResponse>","errorExample":""}]', + 'title' => '视频插帧', + 'summary' => '本文介绍视频插帧InterpolateVideoFrame的语法及示例。', 'description' => '## 功能描述'."\n" - .'视频人脸融合模板增加功能可以将已通过内容审核的包含人脸的视频，作为视频人脸融合的模板，供模板视频人脸融合功能使用。'."\n" + .'视频插帧能力基于深度学习的帧率上变换，通过插帧网络合成任意时刻的视频帧，从而优化解决视频中卡顿、抖动等画质问题。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=videoenhan&children=InterpolateVideoFrame)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" + .'## 应用场景'."\n" + ."\n" + .'- 高帧率视频制作：视频网站通过该技术，可以将低帧率视频转化为高帧率视频，让视频观影体验更流畅，提升观看效果。'."\n" + .'- 慢动作视频制作：将普通帧率（如25帧）视频插帧后，再按正常帧率播放，成为慢动作视频。'."\n" + ."\n" + .'## 特色优势'."\n" + .'基于深度学习算法，推理出中间帧中物体对象的变化位置，让插帧后的视频更加流畅，且无抖动、顿挫等现象。'."\n" + ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[视频生产服务](https://vision.aliyun.com/videoenhan)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_videoenhan_public_cn#/open)。'."\n" - .'><notice>'."\n" - .'本能力仅限企业认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/document_detail/428525.html)。'."\n" - .'></notice>'."\n" - ."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videoenhan/2020-03-20/AddFaceVideoTemplate?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" - .'5. 开发接入步骤： '."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videoenhan/2020-03-20/InterpolateVideoFrame?lang=JAVA&sdkStyle=dara¶ms=%7B%22VideoURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FInterpolateVideoFrame%2FInterpolateVideoFrame1.mp4%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为视频生产（videoenhan）类目的SDK包进行安装。'."\n" - .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" + .' - 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 示例代码：该能力常用语言的示例代码，请参见[视频人脸融合模板增加示例代码](~~602556~~)。'."\n" + .'6. 示例代码：该能力常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" ."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" @@ -2179,155 +1748,273 @@ ."\n" .'## 输入限制'."\n" ."\n" - .'- 视频类型：MP4、AVI、MKV、MOV、FLV、TS、MPG。'."\n" - .'- 视频分辨率：大于等于320×320像素，小于等于1920×1920像素。'."\n" - .'- 视频大小：不大于120 MB。'."\n" + .'- 视频类型：MP4、AVI、MKV、MOV、FLV、TS、MPG、MXF。'."\n" + .'- 视频大小：不超过1 GB。'."\n" + .'- 视频分辨率：不小于360×360像素，不大于1920×1080像素。'."\n" .'- URL地址不能包含中文字符。'."\n" - .'- 同一用户最多可支持上传3000个视频模板。'."\n" - .'- 添加多人脸视频时，单个视频出现的人物ID个数不能大于6个，如果超过6个人脸ID，则返回出现频次最高的6个人。'."\n" - .'- 视频只支持静态（恒定）帧率视频，暂不支持动态（可变）帧率视频。'."\n" - ."\n" - .'## 出参说明'."\n" - .'- 添加模板过程中，系统会自动进行涉黄涉政的过滤检查，如不符合规范，则无法正确添加。'."\n" - .'- 多人视频中如出现多张ID人脸，系统会按照多张脸出现的时长进行排序返回。'."\n" - ."\n" - .'## 视频帧质量建议'."\n" - .'- 要求保证图像中的人脸清晰。图像中人脸尺寸建议大于64×64像素，人脸区域建议不大于全图区域的2/3。'."\n" - .'- 建议图像中人脸五官区域轮廓完整，无明显遮挡。人脸融合算法支持人脸偏侧一定角度，在偏侧角度不超过30度的情况下能取得更佳效果。'."\n" - .'- 对于多人脸视频场景，系统会自动识别出整个视频中的不同人物ID，建议视频中的人物不要出现角度过大的转动以及明显遮挡的情况，否则识别出的人物ID个数可能不准确。'."\n" - ."\n" - .'推荐图像示例：'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221114/jris/MergeImageFacetuijian.png" width="300)'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20230609/otnv/MergeVideoModelFacetuijian.png" width="300)'."\n" ."\n" - .'不推荐图像示例：'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221114/rkbx/MergeImageFacebutuijian.png" width="300)'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20230609/jcgb/MergeVideoModelFacebutuijian.png" width="300)'."\n" + .'## 计费说明'."\n" + .'关于视频插帧的计费方式及报价，请参见[计费介绍](~~202487~~)。'."\n" ."\n" + .'> 下方调试接口为付费接口。'."\n" + ."\n\n" .'## 调用步骤'."\n" .'该能力为异步能力，需分两步进行调用。'."\n" - .'第一步调用AddFaceVideoTemplate接口提交任务，请求成功后，得到一个任务ID。'."\n" - .'第二步调用[GetAsyncJobResult](~~159423~~)接口查询结果，根据任务ID查询任务执行状态和结果。如果任务还在处理中，可稍等一段时间后再进行查询。当同一个任务还未处理完时，建议不要重复提交任务。'."\n" - ."\n" - .'## 计费说明'."\n" - .'视频人脸融合模板增加能力可免费调用。', + .'第一步调用InterpolateVideoFrame接口提交任务，请求成功后，得到一个任务ID。'."\n" + .'第二步调用[GetAsyncJobResult](~~607824~~)接口查询结果，根据任务ID查询任务执行状态和结果。如果任务还在处理中，可稍等一段时间后再进行查询。当同一个任务还未处理完时，建议不要重复提交任务。', + 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## 查询结果'."\n" - .'该接口为异步接口，当前并未返回真实的请求结果，您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见[GetAsyncJobResult](~~159423~~)。'."\n" + .'该接口为异步接口，当前并未返回真实的请求结果，您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见[GetAsyncJobResult](~~607974~~)。'."\n" ."\n" .'## SDK参考'."\n" - .'阿里云视觉AI视频生产类目下的视频人脸融合模板增加能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为视频生产（videoenhan）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + .'阿里云视觉AI视频生产类目下的视频插帧能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为视频生产（videoenhan）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" - .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[视频人脸融合模板增加示例代码](~~602556~~)。'."\n", + .'# 示例代码'."\n" + .'该能力常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于视频人脸融合模板增加的错误码，详情请参见[常见错误码](~~159313~~)。'."\n" + .'关于视频插帧的错误码，详情请参见[常见错误码](~~159313~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n", - ], - 'DeleteFaceVideoTemplate' => [ - 'summary' => '本文介绍视频人脸融合模版删除DeleteFaceVideoTemplate的语法及示例。', - 'methods' => [ - 'post', + 'changeSet' => [ + ['createdAt' => '2022-10-17T02:05:12.000Z', 'description' => '响应参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'InterpolateVideoFrame'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:InterpolateVideoFrame', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'MergeVideoFace' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'readAndWrite', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - 'riskType' => 'none', - 'chargeType' => 'free', - 'tenantRelevance' => 'publicInformation', - ], + 'systemTags' => [], 'parameters' => [ [ - 'name' => 'TemplateId', + 'name' => 'VideoURL', 'in' => 'formData', - 'schema' => [ - 'description' => '待删除的模板ID。', - 'type' => 'string', - 'required' => true, - 'example' => '3bf2418c-7adf-4002-a9d6-2f7cf1889c0d', - ], + 'schema' => ['description' => '输入视频的URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/videoenhan/MergeVideoFace/MergeVideoFace1.mp4', 'isFileTransferUrl' => true], + ], + [ + 'name' => 'ReferenceURL', + 'in' => 'formData', + 'schema' => ['description' => '替换后的人脸参考图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。'."\n" + .'输入限制：'."\n" + .'- 图像格式：JPEG、JPG、PNG。'."\n" + .'- 图像分辨率：大于等于128×128像素，小于等于4000×4000像素。'."\n" + .'- 图像大小：不大于20 MB。'."\n" + .'- URL地址不能包含中文字符。', 'type' => 'string', 'required' => true, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/videoenhan/MergeVideoFace/MergeVideoFace-pic1.png', 'isFileTransferUrl' => true], + ], + [ + 'name' => 'AddWatermark', + 'in' => 'formData', + 'schema' => ['description' => '是否添加水印。取值范围如下：'."\n" + ."\n" + .'- True（默认）：添加水印。'."\n" + .'- False：不添加水印。', 'type' => 'boolean', 'required' => false, 'example' => 'True', 'default' => 'true'], + ], + [ + 'name' => 'Enhance', + 'in' => 'formData', + 'schema' => ['description' => '是否开启人脸美颜增强。取值范围如下：'."\n" + ."\n" + .'- False（默认）：不开启人脸美颜增强。'."\n" + .'- True：开启人脸美颜增强。', 'type' => 'boolean', 'required' => false, 'example' => 'False', 'default' => 'false'], + ], + [ + 'name' => 'WatermarkType', + 'in' => 'formData', + 'schema' => ['description' => '水印类型。取值范围如下：'."\n" + ."\n" + .'- EN（默认）：英文水印。'."\n" + .'- CN：中文水印。', 'type' => 'string', 'required' => false, 'example' => 'EN', 'default' => 'EN'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => '1', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '2337D184-CD63-57B5-96A2-B60AABCB7B58', + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => 'DEF90E76-B62D-45EF-8835-CA3C83842B18'], + 'Data' => [ + 'description' => '返回的结果数据内容。'."\n" + .'该数据需要在异步任务执行成功后，通过调用[GetAsyncJobResult](~~607824~~)接口，对其Result字段进行JSON反序列化之后得到。', + 'type' => 'object', + 'properties' => [ + 'VideoURL' => ['description' => '处理后的视频URL地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-face-fusion/A657011C-82B4-4705-A5DB-69B18B7CE89D.mp4?Expires=1606378308&OSSAccessKeyId=LTAI****************&Signature=Hl3cq5XedTGCscOSr0OGVxAS2o****'], + ], ], + 'Message' => ['description' => '提交异步任务后的提示信息。', 'type' => 'string', 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。'], ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"2337D184-CD63-57B5-96A2-B60AABCB7B58\\"\\n}","errorExample":""},{"type":"xml","example":"<DeleteFaceVideoTemplateResponse>\\n <RequestId>2337D184-CD63-57B5-96A2-B60AABCB7B58</RequestId>\\n</DeleteFaceVideoTemplateResponse>","errorExample":""}]', - 'title' => '视频人脸融合模版删除', + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'ParameterError', 'errorMessage' => 'The parameter is invalid. Please check again.', 'description' => '参数错误，请检查参数值'], + ], + 403 => [ + ['errorCode' => 'AuthFailed', 'errorMessage' => 'An error occurred while performing authorization. Please check your RAM configuration.', 'description' => '授权失败，请检查RAM权限配置，操作流程可参考https://help.aliyun.com/document_detail/145025.htm。'], + ], + 408 => [ + ['errorCode' => 'Timeout', 'errorMessage' => 'The request has timed out.', 'description' => '请求超时，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。'], + ], + 503 => [ + ['errorCode' => 'ServiceUnavailable', 'errorMessage' => 'The service is unavailable.', 'description' => '算法服务报错，请稍后重试。如重试后还报错请通过钉钉搜索群号23109592，加入阿里云视觉智能开放平台咨询群，与平台取得联系。 '], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"DEF90E76-B62D-45EF-8835-CA3C83842B18\\",\\n \\"Data\\": {\\n \\"VideoURL\\": \\"http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-face-fusion/A657011C-82B4-4705-A5DB-69B18B7CE89D.mp4?Expires=1606378308&OSSAccessKeyId=LTAI****************&Signature=Hl3cq5XedTGCscOSr0OGVxAS2o****\\"\\n },\\n \\"Message\\": \\"该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"<MergeVideoFaceResponse>\\n <RequestId>DEF90E76-B62D-45EF-8835-CA3C83842B18</RequestId>\\n <Message>该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>\\n</MergeVideoFaceResponse>","errorExample":""}]', + 'title' => '视频人脸融合', + 'summary' => '本文介绍视频人脸融合MergeVideoFace的语法及示例。', 'description' => '## 功能描述'."\n" - .'视频人脸融合模板删除功能可以删除用户已添加过的模板视频。'."\n" + .'在获得用户授权的前提下，通用视频人脸融合能力可以将视频中检测到的最大人脸，融合进另一个人的人脸特征，达到换脸的感官效果。'."\n" + .'通用视频人脸融合只需要输入一张带融合人脸图像与一段视频，就可以将图像人脸融合进视频中。'."\n" + .'适用场景：'."\n" + .'- 每次合成独立完成，无通用模板场景。'."\n" + .'- 仅支持视频中只有一张人脸的场景。'."\n" + ."\n" + .'如需使用多人场景或有固定数量的视频模板，请参见[模板视频人脸融合](~~467950~~)（MergeVideoModelFace）。'."\n" + .'为保证生成内容的安全合法，请勿使用公众人物或涉及敏感信息的图像或视频进行融合，同时，本服务也会在合成结果的左下角处添加**Generated by AI**的水印内容，效果如下图所示。'."\n" + .''."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=videoenhan&children=MergeVideoFace)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" + .'## 应用场景'."\n" + .'- 影视后期制作：在影视后期制作时，因为某些原因需要替换演员，通过视频人脸融合技术，可利用前期拍摄素材进行处理，让前期视频素材中的人物看起来是新的演员在表演，可以为制片方节省大量的重新拍摄成本。'."\n" + .'- 娱乐性短视频制作：用户可以将自己的人脸和已获授权的合法视频中的人物人脸进行融合，生成趣味性视频。'."\n" + ."\n" + .'## 特色优势'."\n" + .'- 高保真、低违和效果：融合后的人脸保留了替换者人脸身份信息的视觉特征，而融入被替换者人脸中又无违和感。'."\n" + .'- 表情肤色一致性：融合后的人脸最大限度保留被替换者的面目表情、肤色一致性。'."\n" + .'- 支持复杂人脸角度：支持模板人脸偏侧一定角度，融合后的结果真实稳定。'."\n" + ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[视频生产服务](https://vision.aliyun.com/videoenhan)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_videoenhan_public_cn#/open)。'."\n" - .'><notice>'."\n" - .'本能力仅限企业认证用户开通。更多实名认证操作信息，请参见[实名认证](https://help.aliyun.com/document_detail/428525.html)。'."\n" - .'></notice>'."\n" ."\n" + .'><notice>于2024年7月17日及以后开通该能力的用户可直接调用，不需提交申请。'."\n" + .'2024年7月17日之前开通该服务的用户如需调用，可通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们添加到白名单。'."\n" + .'></notice>'."\n" + ."\n\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videoenhan/2020-03-20/DeleteFaceVideoTemplate?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" - .'5. 前提条件：已通过视频人脸融合模板增加（AddFaceVideoTemplate）创建生成了TemplateId。'."\n" - .'6. 开发接入步骤： '."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videoenhan/2020-03-20/MergeVideoFace?lang=JAVA&sdkStyle=dara¶ms=%7B%22VideoURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FMergeVideoFace%2FMergeVideoFace1.mp4%22%2C%22ReferenceURL%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FMergeVideoFace%2FMergeVideoFace-pic1.png%22%2C%22PostURL%22%3A%22%20%22%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为视频生产（videoenhan）类目的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'7. 示例代码：该能力常用语言的示例代码，请参见[视频人脸融合模板删除示例代码](~~602697~~)。'."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[视频人脸融合示例代码](~~602481~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" ."\n" - .'8. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" + .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" .'- [小程序场景下直接调用](~~467780~~)'."\n" .'- [Android端直接调用](~~467781~~)'."\n" - .'- [iOS端直接调用](~~467782~~)', - 'responseParamsDescription' => '## SDK参考'."\n" - .'阿里云视觉AI视频生产类目下的视频人脸融合模板删除能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为视频生产（videoenhan）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" - .'##示例代码'."\n" - .'该能力常用语言的示例代码，请参见[视频人脸融合模板删除示例代码](~~602697~~)。', + .'## 输入限制'."\n" + .'- 视频类型：MP4、AVI、MKV、MOV、FLV、TS、MPG。'."\n" + .'- 视频分辨率：大于360×360像素，小于1920×1920像素。'."\n" + .'- 视频大小：不大于120 MB。'."\n" + .'- 图像格式：JPEG、JPG、PNG。'."\n" + .'- 图像分辨率：大于等于128×128像素，小于等于4000×4000像素。'."\n" + .'- 图像大小：不大于20 MB。'."\n" + .'- URL地址不能包含中文字符。'."\n" + .'- 视频只支持静态（恒定）帧率视频，暂不支持动态（可变）帧率视频。'."\n" + .'- 视频时长不大于300s，大于300s的视频请调用[模板视频人脸融合](~~467950~~)接口。'."\n" + ."\n" + .'## 图像质量建议'."\n" + ."\n" + .'- 要求保证图像中的人脸清晰。图像中人脸尺寸建议大于64×64像素，人脸区域建议不大于全图区域的2/3。'."\n" + .'- 建议图像中人脸五官区域轮廓完整，无明显遮挡。人脸融合算法支持人脸偏侧一定角度，在偏侧角度不超过30度的情况下能取得更佳效果。'."\n" + .'- 建议待融合人脸的图像中只包含一张人脸，如果包含多张人脸，则默认选择图像中最大的人脸进行融合。'."\n" + ."\n" + .'推荐图像示例：'."\n" + .''."\n" + ."\n" + .'不推荐图像示例：'."\n" + .''."\n" + ."\n" + .'## 调用步骤'."\n" + .'该能力为异步能力，需分两步进行调用。'."\n" + .'第一步调用MergeVideoFace接口提交任务，请求成功后，得到一个任务ID。'."\n" + .'第二步调用[GetAsyncJobResult](~~607824~~)接口查询结果，根据任务ID查询任务执行状态和结果。如果任务还在处理中，可稍等一段时间后再进行查询。当同一个任务还未处理完时，建议不要重复提交任务。'."\n" + ."\n" + .'## 计费说明'."\n" + .'关于通用视频人脸融合的计费方式及报价，请参见[计费介绍](~~202487~~)。'."\n" + ."\n" + .'> 下方调试接口为付费接口，如需免费体验调试请前往[体验中心](https://vision.aliyun.com/experience/detail?&tagName=videoenhan&children=MergeVideoFace)。', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => '## 查询结果'."\n" + .'该接口为异步接口，当前并未返回真实的请求结果，您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见[GetAsyncJobResult](~~607824~~)。'."\n" + ."\n" + .'## SDK参考'."\n" + .'阿里云视觉AI视频生产类目下的通用视频人脸融合能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为视频生产（videoenhan）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + ."\n" + .'## 示例代码'."\n" + .'该能力常用语言的示例代码，请参见[通用视频人脸融合示例代码](~~602481~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于视频人脸融合模板删除的错误码，详情请参见[常见错误码](~~159313~~)。'."\n" + .'关于视频人脸融合的错误码，详情请参见[常见错误码](~~159313~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n", + 'changeSet' => [ + ['createdAt' => '2023-10-10T06:49:10.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-08-31T07:56:43.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-08-10T01:59:08.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-12-16T05:19:00.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-11-30T06:48:45.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-10-17T02:05:11.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2022-09-29T07:59:27.000Z', 'description' => '请求参数发生变更'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'MergeVideoFace'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:MergeVideoFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + ], ], 'MergeVideoModelFace' => [ 'summary' => '本文介绍模版视频人脸融合MergeVideoModelFace的语法及示例。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -2339,72 +2026,43 @@ [ 'name' => 'TemplateId', 'in' => 'formData', - 'schema' => [ - 'description' => '视频人脸模板的模板ID。', - 'type' => 'string', - 'required' => true, - 'example' => '3bf2418c-7adf-4002-a9d6-2f7cf1889c0d', - ], + 'schema' => ['description' => '视频人脸模板的模板ID。', 'type' => 'string', 'required' => true, 'example' => '3bf2418c-7adf-4002-a9d6-2f7cf1889c0d'], ], [ 'name' => 'FaceImageURL', 'in' => 'formData', - 'schema' => [ - 'description' => '替换后的人脸参考图像URL地址（TemplateId为单人脸时不可为空）。**FaceImageURL**仅为单人视频场景时使用，此时无需输入**MergeInfos**字段。'."\n" - .'当前仅支持上海地域的OSS链接，如何生成URL请参见[文件URL处理](~~155645~~)。'."\n" - ."\n" - .'输入限制：'."\n" - .'- 图像格式：JPEG、JPG、PNG。'."\n" - .'- 图像分辨率：大于等于128×128像素，小于等于4000×4000像素。'."\n" - .'- 图像大小：不大于20 MB。'."\n" - .'- URL地址不能包含中文字符。', - 'type' => 'string', - 'required' => false, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/videoenhan/MergeVideoFace/MergeVideoFace-xxxx.png', - 'isFileTransferUrl' => true, - ], + 'schema' => ['description' => '替换后的人脸参考图像URL地址（TemplateId为单人脸时不可为空）。**FaceImageURL**仅为单人视频场景时使用，此时无需输入**MergeInfos**字段。'."\n" + .'当前仅支持上海地域的OSS链接，如何生成URL请参见[文件URL处理](~~155645~~)。'."\n" + ."\n" + .'输入限制：'."\n" + .'- 图像格式：JPEG、JPG、PNG。'."\n" + .'- 图像分辨率：大于等于128×128像素，小于等于4000×4000像素。'."\n" + .'- 图像大小：不大于20 MB。'."\n" + .'- URL地址不能包含中文字符。', 'type' => 'string', 'required' => false, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/videoenhan/MergeVideoFace/MergeVideoFace-xxxx.png', 'isFileTransferUrl' => true], ], [ 'name' => 'AddWatermark', 'in' => 'formData', - 'schema' => [ - 'description' => '是否添加水印。取值范围如下：'."\n" - ."\n" - .'- True（默认）：添加水印。'."\n" - .'- False：不添加水印。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'True', - 'default' => 'true', - ], + 'schema' => ['description' => '是否添加水印。取值范围如下：'."\n" + ."\n" + .'- True（默认）：添加水印。'."\n" + .'- False：不添加水印。', 'type' => 'boolean', 'required' => false, 'example' => 'True', 'default' => 'true'], ], [ 'name' => 'Enhance', 'in' => 'formData', - 'schema' => [ - 'description' => '是否开启人脸美颜增强。取值范围如下：'."\n" - ."\n" - .'- False（默认）：不开启人脸美颜增强。'."\n" - .'- True：开启人脸美颜增强。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'True', - 'default' => 'false', - ], + 'schema' => ['description' => '是否开启人脸美颜增强。取值范围如下：'."\n" + ."\n" + .'- False（默认）：不开启人脸美颜增强。'."\n" + .'- True：开启人脸美颜增强。', 'type' => 'boolean', 'required' => false, 'example' => 'True', 'default' => 'false'], ], [ 'name' => 'WatermarkType', 'in' => 'formData', - 'schema' => [ - 'description' => '水印类型。取值范围如下：'."\n" - ."\n" - .'- EN（默认）：英文水印。'."\n" - .'- CN：中文水印。', - 'type' => 'string', - 'required' => false, - 'example' => 'EN', - 'default' => 'EN', - ], + 'schema' => ['description' => '水印类型。取值范围如下：'."\n" + ."\n" + .'- EN（默认）：英文水印。'."\n" + .'- CN：中文水印。', 'type' => 'string', 'required' => false, 'example' => 'EN', 'default' => 'EN'], ], [ 'name' => 'MergeInfos', @@ -2423,26 +2081,11 @@ .'- 同时传入**FaceImageURL**和**MergeInfos**，以**TemplateId**为单/多人脸为准，过滤另一个入参。', 'type' => 'object', 'properties' => [ - 'TemplateFaceID' => [ - 'description' => '多脸模板对应的某个人脸的子ID。需要先在[视频人脸融合模板增加](~~468904~~)接口中获取（传入多个TemplateFaceID时，不可重复）。'."\n" - ."\n" - .'> 同时传入**TemplateFaceID**和**TemplateFaceURL**时，**TemplateFaceID**优先。', - 'type' => 'string', - 'required' => false, - 'example' => 'f913c614-d542-42ba-b173-07db2058c207_0', - ], - 'TemplateFaceURL' => [ - 'description' => '多脸模板对应的某个人脸的图像URL。此情况允许用户自己使用第三方检测模块抽帧进行人脸识别后获取相应的人脸图像。', - 'type' => 'string', - 'required' => false, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-/videoenhan/MergeVideoModelFace/xxx.jpg', - ], - 'ImageURL' => [ - 'description' => '该人脸待替换的图像URL。当前仅支持上海地域的OSS链接，如何生成URL请参见[文件URL处理](~~155645~~)。'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/MergeVideoModelFace/xxx.jpg', - ], + 'TemplateFaceID' => ['description' => '多脸模板对应的某个人脸的子ID。需要先在[视频人脸融合模板增加](~~468904~~)接口中获取（传入多个TemplateFaceID时，不可重复）。'."\n" + ."\n" + .'> 同时传入**TemplateFaceID**和**TemplateFaceURL**时，**TemplateFaceID**优先。', 'type' => 'string', 'required' => false, 'example' => 'f913c614-d542-42ba-b173-07db2058c207_0'], + 'TemplateFaceURL' => ['description' => '多脸模板对应的某个人脸的图像URL。此情况允许用户自己使用第三方检测模块抽帧进行人脸识别后获取相应的人脸图像。', 'type' => 'string', 'required' => false, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-/videoenhan/MergeVideoModelFace/xxx.jpg'], + 'ImageURL' => ['description' => '该人脸待替换的图像URL。当前仅支持上海地域的OSS链接，如何生成URL请参见[文件URL处理](~~155645~~)。'."\n", 'type' => 'string', 'required' => false, 'example' => 'http://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/MergeVideoModelFace/xxx.jpg'], ], 'required' => false, ], @@ -2458,27 +2101,14 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '334F180F-3B50-51CB-B4CB-9A86A542D3BC', - ], - 'Message' => [ - 'description' => '提交异步任务后的提示信息。', - 'type' => 'string', - 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '334F180F-3B50-51CB-B4CB-9A86A542D3BC'], + 'Message' => ['description' => '提交异步任务后的提示信息。', 'type' => 'string', 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。'], 'Data' => [ 'description' => '返回的结果数据内容。该数据需要在异步任务执行成功后，通过调用[GetAsyncJobResult](~~159423~~)接口，对其Result字段进行JSON反序列化之后得到。', 'type' => 'object', 'properties' => [ - 'VideoURL' => [ - 'description' => '处理后的视频URL地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-face-fusion/334F180F-3B50-51CB-B4CB-9A86A542D3BC-5716-20210906-074905.mp4?Expires=1630916420&OSSAccessKeyId=LTAI****************&Signature=OEtNqVYxXRwkyO4BrsYVJ8q5bx****', - ], + 'VideoURL' => ['description' => '处理后的视频URL地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-face-fusion/334F180F-3B50-51CB-B4CB-9A86A542D3BC-5716-20210906-074905.mp4?Expires=1630916420&OSSAccessKeyId=LTAI****************&Signature=OEtNqVYxXRwkyO4BrsYVJ8q5bx****'], ], ], ], @@ -2582,17 +2212,38 @@ .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n", + 'changeSet' => [ + ['createdAt' => '2023-10-10T06:49:10.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-09-14T08:47:49.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-08-10T01:59:08.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-06-09T02:22:45.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-12-02T02:35:23.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-10-17T02:05:12.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2021-04-09T08:28:59.000Z', 'description' => 'OpenAPI 下线'], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'MergeVideoModelFace'], + ], + ], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:MergeVideoModelFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + ], ], 'QueryFaceVideoTemplate' => [ 'summary' => '本文介绍视频人脸融合模版查询QueryFaceVideoTemplate的语法及示例。', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -2600,50 +2251,22 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - 'riskType' => 'none', - 'chargeType' => 'free', - 'tenantRelevance' => 'publicInformation', - ], + 'systemTags' => ['operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free', 'tenantRelevance' => 'publicInformation'], 'parameters' => [ [ 'name' => 'TemplateId', 'in' => 'query', - 'schema' => [ - 'description' => '待查询的模板ID。如果未传TemplateId，返回该用户的模板列表；如果传入TemplateId，仅返回对应的结果。', - 'type' => 'string', - 'required' => false, - 'example' => '3bf2418c-7adf-4002-a9d6-2f7cf1889c0d', - ], + 'schema' => ['description' => '待查询的模板ID。如果未传TemplateId，返回该用户的模板列表；如果传入TemplateId，仅返回对应的结果。', 'type' => 'string', 'required' => false, 'example' => '3bf2418c-7adf-4002-a9d6-2f7cf1889c0d'], ], [ 'name' => 'PageNo', 'in' => 'query', - 'schema' => [ - 'description' => '当前页数设置，默认第1页。取值范围为1~5000。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'maximum' => '5000', - 'minimum' => '1', - 'example' => '1', - 'default' => '1', - ], + 'schema' => ['description' => '当前页数设置，默认第1页。取值范围为1~5000。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'maximum' => '5000', 'minimum' => '1', 'example' => '1', 'default' => '1'], ], [ 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => '当前页条数设置，默认100条。取值范围为1~500。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'maximum' => '500', - 'minimum' => '1', - 'example' => '100', - 'default' => '100', - ], + 'schema' => ['description' => '当前页条数设置，默认100条。取值范围为1~500。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'maximum' => '500', 'minimum' => '1', 'example' => '100', 'default' => '100'], ], ], 'responses' => [ @@ -2653,22 +2276,12 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'A06E3D21-890D-500B-97DA-D8B99D2DDDC4', - ], + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => 'A06E3D21-890D-500B-97DA-D8B99D2DDDC4'], 'Data' => [ 'description' => '返回的结果数据内容。', 'type' => 'object', 'properties' => [ - 'Total' => [ - 'description' => '当前账号下的可用模板总数量。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '20', - ], + 'Total' => ['description' => '当前账号下的可用模板总数量。', 'type' => 'integer', 'format' => 'int64', 'example' => '20'], 'Elements' => [ 'description' => '模板列表。', 'type' => 'array', @@ -2676,32 +2289,12 @@ 'description' => '1', 'type' => 'object', 'properties' => [ - 'CreateTime' => [ - 'description' => '模板创建时间。', - 'type' => 'string', - 'example' => '2021-09-06 15:17:19', - ], - 'UpdateTime' => [ - 'description' => '模板更新时间。', - 'type' => 'string', - 'example' => '2021-09-06 15:18:15', - ], - 'UserId' => [ - 'description' => '用户ID。', - 'type' => 'string', - 'example' => 'zhangsan', - ], - 'TemplateId' => [ - 'description' => '模板ID。', - 'type' => 'string', - 'example' => '3bf2418c-7adf-4002-a9d6-2f7cf1889c0d', - ], - 'TemplateURL' => [ - 'description' => '新增模板时设置的视频人脸模板地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/image-face-fusion/OriginUrl/user/2021-09-06/e4d6ecf6-8dc8-4dac-acb5-56a737ccbc06?Expires=1630914551&OSSAccessKeyId=LTAI****************&Signature=kBcLm66y7%2FZ3eIMgwXJg1zNP7k****', - ], + 'CreateTime' => ['description' => '模板创建时间。', 'type' => 'string', 'example' => '2021-09-06 15:17:19'], + 'UpdateTime' => ['description' => '模板更新时间。', 'type' => 'string', 'example' => '2021-09-06 15:18:15'], + 'UserId' => ['description' => '用户ID。', 'type' => 'string', 'example' => 'zhangsan'], + 'TemplateId' => ['description' => '模板ID。', 'type' => 'string', 'example' => '3bf2418c-7adf-4002-a9d6-2f7cf1889c0d'], + 'TemplateURL' => ['description' => '新增模板时设置的视频人脸模板地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/image-face-fusion/OriginUrl/user/2021-09-06/e4d6ecf6-8dc8-4dac-acb5-56a737ccbc06?Expires=1630914551&OSSAccessKeyId=LTAI****************&Signature=kBcLm66y7%2FZ3eIMgwXJg1zNP7k****'], 'FaceInfos' => [ 'description' => '用户输入视频为多个人脸时，返回各人脸ID和位置信息。'."\n" ."\n" @@ -2713,16 +2306,8 @@ .'> 只有在添加模板时选择了多人视频换脸场景（即**VideoScene**参数必须传入`multi`值）时，才会返回**FaceInfos**信息。', 'type' => 'object', 'properties' => [ - 'TemplateFaceID' => [ - 'description' => '人脸对应的子模板ID。', - 'type' => 'string', - 'example' => '7d1a2498-0f9a-42d8-bae8-c7e478188106_0', - ], - 'TemplateFaceURL' => [ - 'description' => '人脸对应的子模板ID对应的人脸图。', - 'type' => 'string', - 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-face-fusion/template/xhtest_7d1a2498-0f9a-42d8-bae8-c7e478188106/xhtest_7d1a2498-0f9a-42d8-bae8-c7e478188106_0.png?Expires=1686040781&OSSAccessKeyId=LTAI****************&Signature=WVYTf%2F3knRuUPXSVGVz%2FZi3Miu****', - ], + 'TemplateFaceID' => ['description' => '人脸对应的子模板ID。', 'type' => 'string', 'example' => '7d1a2498-0f9a-42d8-bae8-c7e478188106_0'], + 'TemplateFaceURL' => ['description' => '人脸对应的子模板ID对应的人脸图。', 'type' => 'string', 'example' => 'http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-face-fusion/template/xhtest_7d1a2498-0f9a-42d8-bae8-c7e478188106/xhtest_7d1a2498-0f9a-42d8-bae8-c7e478188106_0.png?Expires=1686040781&OSSAccessKeyId=LTAI****************&Signature=WVYTf%2F3knRuUPXSVGVz%2FZi3Miu****'], ], ], ], @@ -2780,122 +2365,101 @@ .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n", - ], - 'GenerateHumanAnimeStyleVideo' => [ - 'summary' => '本文介绍视频生产（videoenhan）类目下的视频人像卡通化GenerateHumanAnimeStyleVideo的语法及示例。', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [ + ['createdAt' => '2024-03-13T06:44:46.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ['createdAt' => '2023-06-09T02:22:45.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2022-12-02T02:35:23.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-09-27T09:41:06.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2021-04-09T08:28:59.000Z', 'description' => 'OpenAPI 下线'], + ], + 'ramActions' => [ + [ + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:QueryFaceVideoTemplate', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'SuperResolveVideo' => [ + 'methods' => ['post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'VideoUrl', 'in' => 'formData', - 'schema' => [ - 'description' => '视频URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/xxx/eas/EvaluateVideoQuality/123.mp4', - '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/videoenhan/SuperResolveVideo/SuperResolveVideo2.mp4', 'isFileTransferUrl' => true], ], [ - 'name' => 'CartoonStyle', + 'name' => 'BitRate', 'in' => 'formData', - 'schema' => [ - 'description' => '卡通化的风格。取值如下：'."\n" - ."\n" - .'- anime：日漫风'."\n" - .'- 3d：3D特效'."\n" - .'- handdrawn：手绘风'."\n" - .'- sketch：铅笔画'."\n" - .'- artstyle：艺术特效', - 'type' => 'string', - 'required' => true, - 'example' => 'anime', - ], + 'schema' => ['description' => '输出视频编码率，单位为Mbps，默认10 Mbps。取值范围1~20。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '5'], ], ], 'responses' => [ 200 => [ - 'headers' => [], 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'd21a2afa-4d52-4bca-803b-e65028146603', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '186AC396-0EEC-46F1-AAA1-BF3585227427'], 'Data' => [ 'description' => '返回的结果数据内容。该数据需要在异步任务执行成功后，通过调用[GetAsyncJobResult](~~607824~~)接口，对其Result字段进行JSON反序列化之后得到。', 'type' => 'object', 'properties' => [ - 'VideoUrl' => [ - 'description' => '输出处理后的视频URL地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://vibktprfx-prod-prod-xstream-cn-shanghai.oss-cn-shanghai.aliyuncs.com/xstream-framework/upload_result_video_2023-02-10_09.45.55.mp4?Expires=1675995564&OSSAccessKeyId=LTAI****************&Signature=aIXTeM4IU4nARjy3SNA3YGhhqj****', - ], + 'VideoUrl' => ['description' => '输出处理后的视频URL地址。'."\n" + .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', 'type' => 'string', 'example' => 'http://algo-app-aic-vd-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/video-super-resolution/2020-03-20-12/12%3A11-UlLVELFzIy5EAyEh.mp4?Expires=1584708132&OSSAccessKeyId=LTAI****************&Signature=0V8yKrCVybC4KIPtRuGKJDJaQT****'], ], ], - 'Message' => [ - 'description' => '提交异步任务后的提示信息。', - 'type' => 'string', - 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。', - ], + 'Message' => ['description' => '提交异步任务后的提示信息。', 'type' => 'string', 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。'], ], + 'description' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"d21a2afa-4d52-4bca-803b-e65028146603\\",\\n \\"Data\\": {\\n \\"VideoUrl\\": \\"http://vibktprfx-prod-prod-xstream-cn-shanghai.oss-cn-shanghai.aliyuncs.com/xstream-framework/upload_result_video_2023-02-10_09.45.55.mp4?Expires=1675995564&OSSAccessKeyId=LTAI****************&Signature=aIXTeM4IU4nARjy3SNA3YGhhqj****\\"\\n },\\n \\"Message\\": \\"该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"<GenerateHumanAnimeStyleVideoResponse>\\n <RequestId>d21a2afa-4d52-4bca-803b-e65028146603</RequestId>\\n <Message>该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>\\n</GenerateHumanAnimeStyleVideoResponse>","errorExample":""}]', - 'title' => '视频人像卡通化', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"186AC396-0EEC-46F1-AAA1-BF3585227427\\",\\n \\"Data\\": {\\n \\"VideoUrl\\": \\"http://algo-app-aic-vd-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/video-super-resolution/2020-03-20-12/12%3A11-UlLVELFzIy5EAyEh.mp4?Expires=1584708132&OSSAccessKeyId=LTAI****************&Signature=0V8yKrCVybC4KIPtRuGKJDJaQT****\\"\\n },\\n \\"Message\\": \\"该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"<SuperResolveVideoResponse>\\n <RequestId>186AC396-0EEC-46F1-AAA1-BF3585227427</RequestId>\\n <Message>该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>\\n</SuperResolveVideoResponse>","errorExample":""}]', + 'title' => '视频超分辨', + 'summary' => '视频超分辨率。', 'description' => '## 功能描述'."\n" - .'根据输入的人像视频进行卡通化转换，返回风格化后的视频结果。支持日漫（anime）、3D（3d）、手绘（handdrawn）、铅笔画（sketch）、艺术特效（artstyle）风格。'."\n" - .'关于该接口功能的示例图如下：'."\n" - .'![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20230221/symy/GenerateHumanAnimeStyleVideo.png" width="600)'."\n" + .'视频超分辨能力可以将输入视频放大2倍尺寸输出，并基于细节推断增强输出视频画质，输出视频为h264编码、MP4格式。'."\n" ."\n" .'> - 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?tagName=videoenhan&children=GenerateHumanAnimeStyleVideo)对该能力进行更直观试用以及在线购买。'."\n" + .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?&tagName=videoenhan&children=SuperResolveVideo)对该能力进行更直观试用以及在线购买。'."\n" .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" ."\n" .'## 应用场景'."\n" - .'- 趣味视频处理：上传人像视频，即可生成专属动漫化形象，塑造可爱氛围，可用于互动推广、趣味相册等应用场景。'."\n" - .'- 隐私保护：为保护图像中的人物隐私，将人物卡通化，可避免识别出原人物是谁。与马赛克等处理方法相比，更具趣味性，更易于用户接受，提升用户体验。'."\n" + ."\n" + .'- 旧视频翻新：基于深度学习的视频超分辨算法，可将低分辨率的视频，增强转化为高分辨视频。'."\n" + .'- 网络视频播放：在低带宽条件下传输低分辨率视频，再通过视频超分辨算法，将视频在播放端还原成高分辨视频。'."\n" ."\n" .'## 特色优势'."\n" - .'- 内容高保真：基于深度学习算法，能有效保留原图中的人物表情、配饰、背景等细节内容特征。'."\n" - .'- 多种风格选择：提供多种不同特效的风格选择，实现差异化的制作效果，满足不同场景和数据要求。'."\n" - .'- 全身卡通化：全图的精细化风格转换，相比人脸卡通化，可避免笑场等尴尬场景。'."\n" - .'- 多人模式：可处理情侣照、家庭照、团体类照片。'."\n" + ."\n" + .'- 基于深度学习算法，推理出的视频细节更真实。'."\n" + .'- 以原视频两倍尺寸输出，获得更大分辨率增加效果。'."\n" ."\n" .'## 接入指引'."\n" .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" .'2. 开通能力：请确保您已开通[视频生产服务](https://vision.aliyun.com/videoenhan)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_videoenhan_public_cn#/open)。'."\n" .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videoenhan/2020-03-20/GenerateHumanAnimeStyleVideo?lang=JAVA&useCommon=true)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" + .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videoenhan/2020-03-20/SuperResolveVideo?lang=JAVA&sdkStyle=dara¶ms=%7B%22VideoUrl%22%3A%22http%3A%2F%2Fviapi-test.oss-cn-shanghai.aliyuncs.com%2Fviapi-3.0domepic%2Fvideoenhan%2FSuperResolveVideo%2FSuperResolveVideo1.mp4%22%2C%22BitRate%22%3A5%7D&tab=DEMO)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" .'5. 开发接入步骤：'."\n" .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" .'- 在对应语言的SDK文档中找到AI类目为视频生产（videoenhan）类目的SDK包进行安装。'."\n" .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" ."\n" - .'6. 示例代码：该能力常用语言的示例代码，请参见[视频人像卡通化示例代码](~~608844~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" + .'6. 示例代码：该能力常用语言的示例代码，请参见[视频超分辨示例代码](~~602945~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" ."\n" .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" .'- [Web前端直接调用](~~467779~~)'."\n" @@ -2904,174 +2468,476 @@ .'- [iOS端直接调用](~~467782~~)'."\n" ."\n" .'## 输入限制'."\n" - .'- 支持的视频类型：MP4、AVI、MKV、FLV、MOV、MPG、TS、MXF。'."\n" - .'- 建议输入视频分辨率不超过1920x1080像素。'."\n" - .'- 视频大小不超过1 GB。'."\n" + ."\n" + .'- 视频格式：MP4，AVI，MKV，MOV， FLV，TS，MPG，MXF。'."\n" + .'- 视频大小：不超过1 GB。'."\n" + .'- 视频分辨率：大于360×360像素，小于1920×1080像素。'."\n" .'- URL地址中不能包含中文字符。'."\n" - .'- 视频帧画面里人数不超过5人，超过5人会影响实际效果。'."\n" ."\n" .'## 计费说明'."\n" - .'该接口返回结果中不会包含计费信息，视频人像卡通化按照视频**输出时长**进行计费，时长最小计量单位为秒，时长不足1秒按照1秒进行计费。计费方式及报价详情，请参见[计费介绍](~~202487~~)。'."\n" + .'关于视频超分辨的计费方式及报价，请参见[计费介绍](~~202487~~)。'."\n" + ."\n" + .'> 下方调试接口为付费接口。'."\n" ."\n" - .'> - 下方调试接口为付费接口。'."\n" - .'- 该能力为异步能力，调用失败不计费，通过RequestId查询结果不计费。'."\n" - ."\n\n" .'## 调用步骤'."\n" .'该能力为异步能力，需分两步进行调用。'."\n" - .'第一步调用GenerateHumanAnimeStyleVideo接口提交任务，请求成功后，得到一个任务ID。'."\n" + .'第一步调用SuperResolveVideo接口提交任务，请求成功后，得到一个任务ID。'."\n" .'第二步调用[GetAsyncJobResult](~~607824~~)接口查询结果，根据任务ID查询任务执行状态和结果。如果任务还在处理中，可稍等一段时间后再进行查询。当同一个任务还未处理完时，建议不要重复提交任务。', + 'requestParamsDescription' => ' ', 'responseParamsDescription' => '## 查询结果'."\n" .'该接口为异步接口，当前并未返回真实的请求结果，您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见[GetAsyncJobResult](~~607824~~)。'."\n" ."\n" .'## SDK参考'."\n" - .'阿里云视觉AI视频生产类目下的视频人像卡通化能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为视频生产（videoenhan）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" + .'阿里云视觉AI视频生产类目下的视频超分辨能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为视频生产（videoenhan）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" ."\n" .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[视频人像卡通化示例代码](~~608844~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。'."\n", + .'该能力常用语言的示例代码，请参见[视频超分辨示例代码](~~602945~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。', 'extraInfo' => '## 错误码'."\n" - .'关于视频人像卡通化的错误码，具体请参见[常见错误码](~~159313~~)。'."\n" + .'具体请参见[常见错误码](~~159313~~)。'."\n" ."\n" .'## 安全声明'."\n" .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。', + 'changeSet' => [ + ['createdAt' => '2022-10-17T02:05:11.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [], ], - 'EnhancePortraitVideo' => [ - 'summary' => '本文介绍视频生产（videoenhan）类目下的视频人像增强EnhancePortraitVideo的语法及示例。', - 'methods' => [ - 'post', + ], + 'endpoints' => [ + ['regionId' => 'cn-shanghai', 'regionName' => '华东2（上海）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'videoenhan.cn-shanghai.aliyuncs.com', 'endpoint' => 'videoenhan.cn-shanghai.aliyuncs.com', 'vpc' => 'videoenhan-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' => 'Url不合法，请检查url能否正常打开', '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.Decode', 'message' => 'Failed to decode the image.', '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是否填写正确。'], + ['code' => 'InvalidAccessKeyId.NotFound', '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' => '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' => '产品未开通，请开通产品：https://common-buy.aliyun.com/?commodityCode=viapi_videoenhan_public_cn#/open', 'http_code' => 400, 'description' => '产品未开通，请开通产品：https://common-buy.aliyun.com/?commodityCode=viapi_videoenhan_public_cn#/open'], + ['code' => 'InvalidApi.OutOfService', 'message' => '产品未开通，请开通产品：https://common-buy.aliyun.com/?commodityCode=viapi_videoenhan_public_cn#/open', 'http_code' => 400, 'description' => '产品未开通，请开通产品：https://common-buy.aliyun.com/?commodityCode=viapi_videoenhan_public_cn#/open'], + ['code' => 'InvalidFile.Category', 'message' => 'The file content category does not meet requirements.', 'http_code' => 400, 'description' => '文件内容类目不符合要求。'], + ['code' => 'InvalidFile.Content', 'message' => 'The content format of the image or video is invalid.', 'http_code' => 400, 'description' => '请参考算法文档检查文件内容，更换包含符合算法要求的 '], + ['code' => 'InvalidFile.Decode', 'message' => 'Failed to decode the file.', 'http_code' => 400, 'description' => '请检查文件是否能够正常打开 '], + ['code' => 'InvalidFile.Download', 'message' => 'Failed to download the file.', 'http_code' => 400, 'description' => '文件无法下载，请检查链接是否可访问和本地网络情况 - 非上海OSS图片链接请参考：https://help.aliyun.com/document\\_detail/155645.html。请检查OSS链接是否过期等。 '], + ['code' => 'InvalidFile.Region', 'message' => 'The URL format of the file is invalid.', 'http_code' => 400, 'description' => '文件链接地域不对，非上海OSS图片链接请参考：https://help.aliyun.com/document\\_detail/155645.html '], + ['code' => 'InvalidFile.Resolution', 'message' => 'The resolution of the image or video is invalid.', 'http_code' => 400, 'description' => '文件分辨率超出限制，请检查文件分辨率和内容，修改文件分辨率后重试 '], + ['code' => 'InvalidFile.Type', 'message' => 'The file type of the image or video is invalid.', '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' => 'The URL format of the file is invalid.', 'http_code' => 400, 'description' => '文件无法下载，请检查链接是否可访问和本地网络情况 - 非上海OSS图片链接请参考：https://help.aliyun.com/document\\_detail/155645.html。请检查OSS链接是否过期等。 '], + ['code' => 'InvalidImage.Content', 'message' => '请参考算法文档检查图片内容，更换包含符合算法要求的', 'http_code' => 400, 'description' => '请参考算法文档检查图片内容，更换包含符合算法要求的'], + ['code' => 'InvalidImage.Decode', 'message' => '请检查图片是否能够正常打开', 'http_code' => 400, 'description' => '请检查图片是否能够正常打开'], + ['code' => 'InvalidImage.Download', 'message' => '图片无法下载，请检查链接是否可访问和本地网络情况 - 非上海OSS图片链接请参考：https://help.aliyun.com/document_detail/155645.html', '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' => '图片链接地域不对，非上海OSS图片链接请参考：https://help.aliyun.com/document_detail/155645.html', 'http_code' => 400, 'description' => '图片链接地域不对，非上海OSS图片链接请参考：https://help.aliyun.com/document_detail/155645.html'], + ['code' => 'InvalidImage.Resolution', 'message' => '文件分辨率超出限制，请检查文件分辨率和内容，修改文件分辨率后重试', '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.URL', 'message' => '图片链接非法，请检查图片链接是否可访问 - 非上海OSS图片链接请参考：https://help.aliyun.com/document_detail/155645.html', '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' => 'The request parameter or the data has an error.', 'http_code' => 400, 'description' => '参数错误，请根据算法API文档和报错Message检查参数值。是否参数值前后多了空格或者其他特殊字符等。 '], + ['code' => 'InvalidParameter.Format', 'message' => 'The entry format is incorrect.', 'http_code' => 400, 'description' => '入参格式错误。'], + ['code' => 'InvalidParameter.NotFound', 'message' => '参数错误，请根据算法API文档和报错Message检查参数值。是否参数值前后多了空格或者其他特殊字符等。', 'http_code' => 400, 'description' => '参数错误，请根据算法API文档和报错Message检查参数值。是否参数值前后多了空格或者其他特殊字符等。'], + ['code' => 'InvalidParameter.TooLarge', 'message' => '参数错误，文件大小超出限制，请参考算法API文档调整文件大小', 'http_code' => 400, 'description' => '参数错误，文件大小超出限制，请参考算法API文档调整文件大小'], + ['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' => '时间戳过期，请更新时间戳', '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' => '签名不正确，请重新计算签名。关于签名可参考文档：https://help.aliyun.com/document_detail/144904.html', 'http_code' => 400, 'description' => '签名不正确，请重新计算签名。可以参考https://help.aliyun.com/document\\_detail/144904.html文档计算请求签名。如果您的语言比较常用，推荐使用SDK进行调用，详情可参考：https://help.aliyun.com/document\\_detail/145033.html '], + ['code' => 'SignatureNonceUsed', 'message' => '签名已经被使用过，请重新计算签名。关于签名可参考文档：https://help.aliyun.com/document_detail/144904.html', '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权限，请联系主账号给你添加AliyunVIAPIFullAccess权限，操作流程可参考https://help.aliyun.com/document_detail/145025.htm', 'http_code' => 400, 'description' => '没有Ram权限，请联系主账号给你添加AliyunVIAPIFullAccess权限，操作流程可参考https://help.aliyun.com/document_detail/145025.htm'], + ], + 'changeSet' => [ + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'AddFaceVideoTemplate'], ], - 'schemes' => [ - 'http', - 'https', + 'createdAt' => '2024-05-30T09:21:55.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'QueryFaceVideoTemplate'], ], - 'security' => [ - [ - 'AK' => [], + 'createdAt' => '2024-03-13T06:44:54.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'MergeVideoFace'], + ['description' => '请求参数发生变更', 'api' => 'MergeVideoModelFace'], + ], + 'createdAt' => '2023-10-10T06:49:17.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'MergeVideoModelFace'], + ], + 'createdAt' => '2023-09-14T08:47:55.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'MergeVideoFace'], + ], + 'createdAt' => '2023-08-31T07:56:49.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'MergeVideoFace'], + ['description' => '请求参数发生变更', 'api' => 'MergeVideoModelFace'], + ], + 'createdAt' => '2023-08-10T01:59:14.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'AddFaceVideoTemplate'], + ['description' => '请求参数发生变更', 'api' => 'MergeVideoModelFace'], + ['description' => '响应参数发生变更', 'api' => 'QueryFaceVideoTemplate'], + ], + 'createdAt' => '2023-06-09T02:22:50.000Z', + 'description' => '', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'MergeVideoFace'], + ], + 'createdAt' => '2022-12-16T05:19:16.000Z', + 'description' => '修改入参为不可见', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'AddFaceVideoTemplate'], + ['description' => '请求参数发生变更', 'api' => 'DeleteFaceVideoTemplate'], + ['description' => '请求参数发生变更', 'api' => 'MergeVideoModelFace'], + ['description' => '请求参数发生变更', 'api' => 'QueryFaceVideoTemplate'], + ], + 'createdAt' => '2022-12-02T02:35:38.000Z', + 'description' => '设置userId为不可见', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'MergeVideoFace'], + ], + 'createdAt' => '2022-11-30T06:49:39.000Z', + 'description' => '更改入参PostURL为非必选', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'GenerateVideo'], + ], + 'createdAt' => '2022-11-10T08:56:57.000Z', + 'description' => 'url支持本地多文件上传', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'AbstractEcommerceVideo'], + ['description' => '响应参数发生变更', 'api' => 'AbstractFilmVideo'], + ['description' => '响应参数发生变更', 'api' => 'AddFaceVideoTemplate'], + ['description' => '响应参数发生变更', 'api' => 'AdjustVideoColor'], + ['description' => '响应参数发生变更', 'api' => 'ChangeVideoSize'], + ['description' => '响应参数发生变更', 'api' => 'ConvertHdrVideo'], + ['description' => '响应参数发生变更', 'api' => 'EnhanceVideoQuality'], + ['description' => '响应参数发生变更', 'api' => 'EraseVideoLogo'], + ['description' => '响应参数发生变更', 'api' => 'EraseVideoSubtitles'], + ['description' => '响应参数发生变更', 'api' => 'GenerateVideo'], + ], + 'createdAt' => '2022-10-17T02:05:25.000Z', + 'description' => '修改异步任务Message为可见', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'MergeVideoFace'], + ], + 'createdAt' => '2022-09-29T07:59:33.000Z', + 'description' => '多url参数支持本地文件上传', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'QueryFaceVideoTemplate'], + ], + 'createdAt' => '2022-09-27T09:41:12.000Z', + 'description' => '修改obj为可见', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI 下线', 'api' => 'AddFaceVideoTemplate'], + ['description' => 'OpenAPI 下线', 'api' => 'DeleteFaceVideoTemplate'], + ['description' => 'OpenAPI 下线', 'api' => 'MergeVideoModelFace'], + ['description' => 'OpenAPI 下线', 'api' => 'QueryFaceVideoTemplate'], + ], + 'createdAt' => '2021-04-12T02:24:15.000Z', + 'description' => '第一次发布', + ], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'EnhanceVideoQuality'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GenerateHumanAnimeStyleVideo'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'InterpolateVideoFrame'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'EraseVideoLogo'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'AdjustVideoColor'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'ChangeVideoSize'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'SuperResolveVideo'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GetAsyncJobResult'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'AddFaceVideoTemplate'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'GenerateVideo'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'QueryFaceVideoTemplate'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'DeleteFaceVideoTemplate'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'EnhancePortraitVideo'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'EraseVideoSubtitles'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'MergeVideoModelFace'], + ['threshold' => '100', 'countWindow' => 1, 'regionId' => '*', 'api' => 'MergeVideoFace'], + ], + ], + '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' => 'AddFaceVideoTemplate', + 'description' => '视频人脸融合模板增加', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:AddFaceVideoTemplate', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'MergeVideoFace', + 'description' => '通用视频人脸融合', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:MergeVideoFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'EnhancePortraitVideo', + 'description' => '视频人像增强', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:EnhancePortraitVideo', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'SuperResolveVideo', + 'description' => '视频超分辨', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:SuperResolveVideo', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'GenerateHumanAnimeStyleVideo', + 'description' => '视频人像卡通化', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:GenerateHumanAnimeStyleVideo', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'InterpolateVideoFrame', + 'description' => '视频插帧', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:InterpolateVideoFrame', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'AdjustVideoColor', + 'description' => '视频校色', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:AdjustVideoColor', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'EnhanceVideoQuality', + 'description' => '视频综合增强', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:EnhanceVideoQuality', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DeleteFaceVideoTemplate', + 'description' => '视频人脸融合模版删除', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:DeleteFaceVideoTemplate', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], - 'deprecated' => false, - 'systemTags' => [], - 'parameters' => [ - [ - 'name' => 'VideoUrl', - 'in' => 'formData', - 'schema' => [ - 'description' => '输入视频URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见[文件URL处理](~~155645~~)。', - 'type' => 'string', - 'required' => true, - 'example' => 'https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/xxx/shang/video/SD%289516100%29.mp4', - 'isFileTransferUrl' => true, + [ + 'apiName' => 'GetAsyncJobResult', + 'description' => '查询异步任务结果', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:GetAsyncJobResult', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => 'd21a2afa-4d52-4bca-803b-e65028146603', - ], - 'Data' => [ - 'description' => '返回的结果数据内容。该数据需要在异步任务执行成功后，通过调用[GetAsyncJobResult](~~607824~~)接口，对其Result字段进行JSON反序列化之后得到。', - 'type' => 'object', - 'properties' => [ - 'VideoUrl' => [ - 'description' => '处理后的视频URL地址。'."\n" - .'> 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。', - 'type' => 'string', - 'example' => 'http://vibktprfx-prod-prod-xstream-cn-shanghai.oss-cn-shanghai.aliyuncs.com/xstream-framework/upload_result_video_2023-02-10_09.45.55.mp4?Expires=1675995564&OSSAccessKeyId=LTAI****************&Signature=aIXTeM4IU4nARjy3SNA3YGhhqj****', - ], - ], - ], - 'Message' => [ - 'description' => '提交异步任务后的提示信息。', - 'type' => 'string', - 'example' => '该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。', - ], - ], + [ + 'apiName' => 'EraseVideoLogo', + 'description' => '视频标志擦除', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:EraseVideoLogo', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + [ + 'apiName' => 'QueryFaceVideoTemplate', + 'description' => '视频人脸融合模板查询', + 'operationType' => 'none', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:QueryFaceVideoTemplate', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'MergeVideoModelFace', + 'description' => '模板视频人脸融合', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:MergeVideoModelFace', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'ChangeVideoSize', + 'description' => '视频画幅变换', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:ChangeVideoSize', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'EraseVideoSubtitles', + 'description' => '视频字幕擦除', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:EraseVideoSubtitles', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'GenerateVideo', + 'description' => '通用视频生成', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'viapi-videoenhan:GenerateVideo', + 'authLevel' => 'operate', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'VisualIntelligenceAPI', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"d21a2afa-4d52-4bca-803b-e65028146603\\",\\n \\"Data\\": {\\n \\"VideoUrl\\": \\"http://vibktprfx-prod-prod-xstream-cn-shanghai.oss-cn-shanghai.aliyuncs.com/xstream-framework/upload_result_video_2023-02-10_09.45.55.mp4?Expires=1675995564&OSSAccessKeyId=LTAI****************&Signature=aIXTeM4IU4nARjy3SNA3YGhhqj****\\"\\n },\\n \\"Message\\": \\"该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。\\"\\n}","errorExample":""},{"type":"xml","example":"<EnhancePortraitVideoResponse>\\n <RequestId>d21a2afa-4d52-4bca-803b-e65028146603</RequestId>\\n <Message>该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。</Message>\\n</EnhancePortraitVideoResponse>","errorExample":""}]', - 'title' => '视频人像增强', - 'description' => '## 功能描述'."\n" - .'视频人像增强能力基于GPEN人像增强模型，对视频中的人脸进行清晰度提升，显著增加面部细节和质感，同时通过人脸质量评估算法与动态调整融合系数，保持增强后人脸的自然和真实。'."\n" - ."\n" - .'>- 您可以进入[在线咨询](https://www.aliyun.com/core/online-consult?from=aZgW6LJHr2)获取在线人工帮助。'."\n" - .'- 当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击[立即试用](https://vision.aliyun.com/experience/detail?tagName=videoenhan&children=EnhancePortraitVideo)对该能力进行更直观试用以及在线购买。'."\n" - .'- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。'."\n" - ."\n" - .'## 应用场景'."\n" - ."\n" - .'- 老旧视频的人脸增强修复。'."\n" - .'- 拍摄素材的清晰度提升，超高清视频制作。'."\n" - ."\n" - .'## 特色优势'."\n" - ."\n" - .'- 显著提升人脸清晰度：通过深度学习进行面部增强，显著增加面部细节和质感。'."\n" - .'- 保持人脸稳定自然：通过人脸质量评估算法与动态调整融合系数，保持增强后人脸的自然和真实。'."\n" - ."\n" - .'## 接入指引'."\n" - .'1. 注册阿里云账号：打开[阿里云官网](https://www.aliyun.com)，在阿里云官网右上角，单击**立即注册**，按照操作提示完成账号注册。'."\n" - .'2. 开通能力：请确保您已开通[视频生产服务](https://vision.aliyun.com/videoenhan)，若未开通服务请[立即开通](https://common-buy.aliyun.com/?commodityCode=viapi_videoenhan_public_cn#/open)。'."\n" - .'3. 创建AccessKey：请确保您已[创建AccessKey](~~175144~~)，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见[RAM授权](~~145025~~)。'."\n" - .'4. 在线调试（可选）：您可以通过[OpenAPI Explorer](https://next.api.aliyun.com/api/videoenhan/2020-03-20/EnhancePortraitVideo?lang=JAVA)在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。'."\n" - .'5. 开发接入步骤： '."\n" - .'- 在[SDK总览](~~145033~~)中选择您要接入使用的SDK语言。'."\n" - .'- 在对应语言的SDK文档中找到AI类目为视频生产（videoenhan）类目的SDK包进行安装。'."\n" - .'- 参考文档中提供的示例代码进行适当修改后调用。'."\n" - ."\n" - .'6. 示例代码：该能力常用语言的示例代码，请参见[视频人像增强示例代码](~~613162~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。'."\n" - ."\n" - .'7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。'."\n" - .'- [Web前端直接调用](~~467779~~)'."\n" - .'- [小程序场景下直接调用](~~467780~~)'."\n" - .'- [Android端直接调用](~~467781~~)'."\n" - .'- [iOS端直接调用](~~467782~~)'."\n" - ."\n" - .'## 输入限制'."\n" - ."\n" - .'- 视频类型：MP4、AVI、MKV、MOV、FLV、TS、MPG、MXF。'."\n" - .'- 视频大小：不超过1 GB。'."\n" - .'- 视频分辨率：小于1920×1080像素。'."\n" - .'- URL地址不能包含中文字符。'."\n" - ."\n" - .'## 调用步骤'."\n" - .'该能力为异步能力，需分两步进行调用。'."\n" - .'第一步调用EnhancePortraitVideo接口提交任务，请求成功后，得到一个任务ID。'."\n" - .'第二步调用[GetAsyncJobResult](~~607824~~)接口查询结果，根据任务ID查询任务执行状态和结果。如果任务还在处理中，可稍等一段时间后再进行查询。当同一个任务还未处理完时，建议不要重复提交任务。'."\n" - ."\n" - .'## 计费说明'."\n" - .'视频人像增强能力目前处于公测期，可免费调用。', - 'responseParamsDescription' => '## 查询结果'."\n" - .'该接口为异步接口，当前并未返回真实的请求结果，您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见[GetAsyncJobResult](~~607824~~)。'."\n" - ."\n" - .'## SDK参考'."\n" - .'阿里云视觉AI视频生产类目下的视频人像增强能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为视频生产（videoenhan）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见[SDK总览](~~145033~~)。'."\n" - ."\n" - .'## 示例代码'."\n" - .'该能力常用语言的示例代码，请参见[视频人像增强示例代码](~~613162~~)，常用语言查询异步任务结果的示例代码，请参见[查询异步任务结果示例代码](~~607974~~)。', - 'extraInfo' => '## 错误码'."\n" - .'关于视频人像增强的错误码，详情请参见[常见错误码](~~159313~~)。'."\n" - ."\n" - .'## 安全声明'."\n" - .'- 请确保上传的图片或文件来源符合相应的法律法规。'."\n" - .'- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。'."\n", - ], - ], - 'endpoints' => [ - [ - 'regionId' => 'cn-shanghai', - 'endpoint' => 'videoenhan.cn-shanghai.aliyuncs.com', ], + 'resourceTypes' => [], ], ]; |