本文介绍视频校色AdjustVideoColor的语法及示例。

功能描述

视频校色可以对输入的视频进行调色,可根据视频之间的相似性进行关联调色。

前提条件

请确保您已开通视频生产服务,若未开通服务请立即开通

输入限制

  • 视频格式:MP4,AVI,MKV,MOV,FLV,TS,MPG,MXF。
  • 视频分辨率:大于360×360像素,小于3840×2160像素,超过后系统会自动对原始视频进行缩放。
  • URL地址中不能包含中文字符。

计费说明

关于视频校色的计费方式及报价,请参见计费介绍

说明 下方调试接口为付费接口,如需免费体验调试请前往体验中心

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String AdjustVideoColor

要执行的操作。取值:AdjustVideoColor。

VideoUrl String http://viapi-test.oss-cn-shanghai.aliyuncs.com/sanjiye-meizi/%E8%A7%86%E9%A2%91/%E8%A7%86%E9%A2%91%E8%B0%83%E8%89%B2.mp4

视频URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

VideoBitrate Long 20

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

VideoCodec String h264

输出视频编码格式,可选h264、hevc、prores三种。默认值为h264。

VideoFormat String mp4

输出视频格式,可选mp4、mov两种。默认值为mp4。

Mode String LogC

指定调色模式,默认值为LogC。具体请参见调色模式说明。

调色模式如下。

mode标识

名称

说明

LogC

灰片调色

输入为低对比的灰片,通常为10bit。

Rec709

普通调色

输入为普通视频,通常为8bit。

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。

VideoUrl String 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=LTAI4FoLmvQ9urWXgSRp****&Signature=icKn5gEQ6rNlSHmCi2zAf2tC0L****

调色后的视频URL地址。

RequestId String C4EB5E0B-0718-42CC-9B2C-1FB149256874

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=AdjustVideoColor
&VideoUrl=http://viapi-test.oss-cn-shanghai.aliyuncs.com/sanjiye-meizi/%E8%A7%86%E9%A2%91/%E8%A7%86%E9%A2%91%E8%B0%83%E8%89%B2.mp4
&<公共请求参数>

正常返回示例

XML格式

<RequestId>C4EB5E0B-0718-42CC-9B2C-1FB149256874</RequestId>
<Data>
    <VideoUrl>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&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=icKn5gEQ6rNlSHmCi2zAf2tC0L****</VideoUrl>
</Data>

JSON格式

{
    "RequestId": "C4EB5E0B-0718-42CC-9B2C-1FB149256874",
    "Data": {
        "VideoUrl": "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&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=icKn5gEQ6rNlSHmCi2zAf2tC0L****"
    }
}

查询任务结果

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

错误码

具体请参见常见错误码

SDK参考

阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。