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

功能描述

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

前提条件

请确保您已开通视频生产服务,具体请参见服务开通

输入限制

  • 视频分辨率:视频最长边要求不超过3840,超过后系统会自动对原始视频进行缩放。
  • URL地址中不能包含中文字符。

调试

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

请求参数

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

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

Mode String LogC

指定调色模式,具体请参见调色模式说明。

VideoUrl String http://public-vigen-video.oss-cn-shanghai.aliyuncs.com/zhuxun.lx/test1.mp4

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

VideoBitrate String 15000k

输出视频的码率,默认为输入视频码率。

VideoCodec String h264

输出视频编码格式。

VideoFormat String mov

输出视频格式,可选mov和mp4。默认输出视频格式为mov。

调色模式如下。

mode标识

名称

说明

LogC

灰片调色

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

Rec709

普通调色

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

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。

VideoUrl String http://public-vigen-video.oss-cn-shanghai.aliyuncs.com/zhuxun.lx/test1.mp4

调色后的视频URL地址。

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

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=AdjustVideoColor
&Mode=LogC
&VideoUrl=http://public-vigen-video.oss-cn-shanghai.aliyuncs.com/zhuxun.lx/test1.mp4
&<公共请求参数>

正常返回示例

XML 格式

<RequestId>C4EB5E0B-0718-42CC-9B2C-1FB149256874</RequestId>

JSON 格式

{
  "RequestId": "C4EB5E0B-0718-42CC-9B2C-1FB149256874"
}

查询任务结果

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

错误码

具体请参见常见错误码

SDK参考

单击SDK简介查看SDK信息。