EnhanceVideoQuality
视频综合增强EnhanceVideoQuality的语法及示例
服务地址:
华东2(上海)
输入参数
只看必填
VideoURL输入视频URL地址
OutPutWidth输出视频的宽
OutPutHeight输出视频的高
FrameRate输出视频的帧率
HDRFormat输出视频的HDR格式
MaxIlluminance输出视频最大亮度
Bitrate输出视频码率
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

功能描述

视频综合增强能力基于 AI 深度学习算法,可以对输入的 SDR 视频进行插帧、超分辨率 SR、SDR 转 HDR 综合增强处理。

说明
  • 生成的视频是标准 HDR 格式视频,请在合适的 HDR 设备上播放。
    • 您可以进入在线咨询获取在线人工帮助。
    • 阿里云视觉智能开放平台视觉 AI 能力 API 接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。

    应用场景

    • 高清视频播放系统:对于非高清、非超高清、SDR 的片源,通过视频综合增强,可以转化成高清、超高清、HDR、更高帧率的视频,给观众更好的观影体验。
    • 家庭视频增强:受限于过去拍摄设备的技术水平,珍贵的家庭视频以较低分辨率保存,在现在的高清设备上播放时,观看效果较差。通过视频综合增强,可以获得更高清的观看效果,适应当前的播放技术发展。

    特色优势

    • 真实的细节展示:能够真实推理出画面中的明暗变化细节,让您获得真正的 HDR 体验。
    • 更流畅的画面:可推理出原视频帧间的动作变化,加入更多视频帧,让画面更流畅。
    • 更高的分辨率:将画面分辨率提升的同时,优化画面细节、纹理和锐度等,同时抑制块噪声和压缩噪声等现象。

    接入指引

    1. 注册阿里云账号:打开阿里云官网,在阿里云官网右上角,单击立即注册,按照操作提示完成账号注册。

    2. 开通能力:请确保您已开通视频生产服务,若未开通服务请立即开通

    3. 创建 AccessKey:请确保您已创建 AccessKey,如果您使用的是子账号 AccessKey,您需要给子账号赋予 AliyunVIAPIFullAccess 权限,具体操作,请参见 RAM 授权

    4. 在线调试(可选):您可以通过OpenAPI Explorer在线调试能力,查看完整的调用示例代码及 SDK 依赖信息,也可以下载完整的工程。

    5. 开发接入步骤:

      • SDK 总览中选择您要接入使用的 SDK 语言。

      • 在对应语言的 SDK 文档中找到 AI 类目为视频生产(videoenhan)类目的 SDK 包进行安装。

      • 参考文档中提供的示例代码进行适当修改后调用。

    6. 示例代码:该能力常用语言的示例代码,请参见视频综合增强示例代码,常用语言查询异步任务结果的示例代码,请参见查询异步任务结果示例代码

    7. 客户端直接调用:该能力常用的客户端调用方式包括以下几种。

    输入限制

    • 视频类型:MP4、AVI、MKV、MOV、FLV、TS、MPG、MXF。
    • 视频大小:不超过 1 GB。
    • 视频时长:不超过 10 分钟。
    • 视频分辨率:输入的视频分辨率大于 360×360 像素,小于 1920×1080 像素。设置的输出宽高应该不小于原始宽高的 1/2 且不大于原始宽高的 4 倍。
    • URL 地址不能包含中文字符。

    计费说明

    关于视频综合增强的计费方式及报价,请参见计费介绍

    说明 下方调试接口为付费接口。

    调用步骤

    该能力为异步能力,需分两步进行调用。 第一步调用 EnhanceVideoQuality 接口提交任务,请求成功后,得到一个任务 ID。 第二步调用 GetAsyncJobResult 接口查询结果,根据任务 ID 查询任务执行状态和结果。如果任务还在处理中,可稍等一段时间后再进行查询。

    请求参数

    字段名称字段详情
    VideoURLstring

    输入视频 URL 地址。推荐使用上海地域的 OSS 链接,对于文件在本地或者非上海地域 OSS 链接的情况,请参见文件 URL 处理

    示例值:https://invi-label.oss-cn-shanghai.aliyuncs.com/label/temp/faceswap/test_for_api/xxxx.mp4参考取值来源:
      ToneSdrVideo
      MergeVideoFace
      ConvertHdrVideo
    OutPutWidthinteger<int32>

    输出视频的宽,默认为输入 2 倍,单位为 px,取值范围[180,7680]

    示例值:2560取值 <= 7680
    OutPutHeightinteger<int32>

    输出视频的高,默认为输入 2 倍,单位为 px,取值范围[180,4320]

    示例值:1920取值 <= 4320
    FrameRateinteger<int32>

    输出视频的帧率,默认 50 帧,取值范围[1,120]

    示例值:50取值 <= 120
    HDRFormatstring

    输出视频的 HDR 格式,仅支持 PQ 和 HLG 两种格式,默认为 PQ。

    示例值:PQ
    MaxIlluminanceinteger<int32>

    输出视频最大亮度,单位为 nit。展开详情

    示例值:600取值 <= 1000
    Bitrateinteger<int32>

    输出视频码率,单位为 MB,默认 20MB,取值范围[8,200]

    示例值:20取值 <= 200

    返回参数

    字段名称字段详情
    RequestIdstring

    请求 ID。

    示例值:881F39DC-C107-4817-A6D5-000BE833CC2A
    Dataobject

    返回的结果数据内容。该数据需要在异步任务执行成功后,通过调用 GetAsyncJobResult 接口,对其 Result 字段进行 JSON 反序列化之后得到。

    Messagestring

    提交异步任务后的提示信息。

    示例值:该调用为异步调用,任务已提交成功,请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。

    返回说明

    查询结果

    该接口为异步接口,当前并未返回真实的请求结果,您需要通过返回的 RequestId 调用 GetAsyncJobResult 接口来获取该接口的真实请求结果。详情请参见 GetAsyncJobResult

    SDK 参考

    阿里云视觉 AI 视频生产类目下的视频综合增强能力推荐使用 SDK 调用,支持多种编程语言,调用时请选择 AI 类目为视频生产(videoenhan)的 SDK 包,文件参数通过 SDK 调用可支持本地文件及任意 URL,具体可参见 SDK 总览

    示例代码

    该能力常用语言的示例代码,请参见视频综合增强示例代码,常用语言查询异步任务结果的示例代码,请参见查询异步任务结果示例代码

    变更历史
    变更时间变更内容概要操作
    2022-10-17
    变更返回参数