视频智能调整

您可通过视频智能调整发起视频智能调整任务，并通过创意中心通用接口来获取视频工具任务当前执行状态以及相关信息。

一、 产品功能

智能识别视频内容和人物，进行智能智能调整，以满足不同规格的投放要求，降低广告主操作成本。您可在创意中心-智能编辑进行体验。

您有两种使用方式：一种是根据需求，自己手工来调整视频，参考如下的“手工调整”。另外一种是系统根据创意规格的投放要求自动帮广告主调整视频，参考如下的“一键适配”。

二、手工调整

根据您的调整需求，可限定具体的目标调整尺寸、尺寸调整方式、目标调整时长、时长调整方式以及是否需要随机配乐，调用“手工调整”，生成一个符合需求的视频，落入视频资产可直接投放。

1、尺寸调整（size_adjustment）：

• 目标尺寸（target_size）：您期望调整的目标尺寸，当前支持 VERTICALVERSION_750_1536（微信750:1536）、VERTICALVERSION_750_1334（微信750:1334）、VERTICALVERSION_1080_1920（闪屏）、VERTICALVERSION（9:16，720:1280）、HORIZONTALVERSION_4_3（4:3，640:480）、HORIZONTALVERSION（16:9，1280:720）。
• 调整尺寸方式（size_adjustment_method）：您期望调整尺寸的方式，当前支持 GAUSSIAN（高斯模糊）、COLOR（指定颜色）、SMART_CLIP（智能剪裁）、SMART_IMAGE（智能取图）。
• 高斯模糊（GAUSSIAN）：超出画框部分将剪裁掉，空缺部分将以原视频的高斯模糊的形式填充。
• 指定颜色（COLOR）：超出画框部分将剪裁掉，空缺部分将以指定颜色填充。
• 智能剪裁（SMART_CLIP）：通过智能识别视频主体内容，动态调整裁剪区域（裁剪可能导致尾帧和字幕出错，建议使用原视频剪辑后再添加字幕和尾帧）。
• 智能取图（SMART_IMAGE）：系统从视频中提取关键帧截图，填充在空缺区域。

2、时长调整（length_adjustment）：

• 目标时长（target_length）：您期望调整的目标时长，当前支持 5-120s。
• 调整时长方式（length_adjustment_method）：您期望调整时长的方式，当前支持 OVERFLOW_CLIP（溢出剪裁）、SMART_SPEED_CHANGE（智能变速）。
• 溢出剪裁（OVERFLOW_CLIP）：若视频原时长 x 秒小于调整目标时长 y 秒，则自动为多余的 y – x 秒添加黑屏；若视频原时长 x 秒>调整目标时长 y 秒，则自动剪裁多余的 x – y 秒。
• 智能变速（SMART_SPEED_CHANGE）：若视频原时长 x 秒，调整目标时长 y 秒，则自动将视频播放速度调整为原 y/x 倍，自动拉伸/缩短至目标时长。

3、 音乐调整（music_adjustment）：

• 添加音乐方式（music_adjustment_method）：您期望添加音乐的方式，当前支持 RECOMMENDATION（推荐音乐）。

4、手工调整示例

假如您需要将视频利用高斯模糊、智能变速方式调整成750:1536、30s的视频，并为视频添加音乐，请求示例如下：

curl 'https://api.e.qq.com/v1.1/videomaker_autoadjustment/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=111111111' \
-d 'video_file=@/usr/local/my/video.mp4' \
-d 'signature=19efcaeda3c30e1cf28170d86ecbf5e0' \
-d 'adjustment_type=MANUAL_ADJUSTMENT' \
-d 'manual_adjustment = {
    "size_adjustment":{
        "target_size":"VERTICALVERSION_750_1536",
        "size_adjustment_method":"GAUSSIAN"
    },
    "length_adjustment":{
        "target_length":30,
        "length_adjustment_method":"SMART_SPEED_CHANGE"
    },
    "music_adjustment":{
        "music_adjustment_method":"RECOMMENDATION"
    }
}'

三、一键适配

1、适配方式

根据推广计划类型（campaign_type）、推广目标类型（promoted_object_type）、投放版位（site_set）和创意形式（adcreative_template_id ）进行一键适配，也即系统会自动把您的视频相关参数（尺寸、时长等）调整成能符合系统的视频指标，从而让您可以直接投放，无需其它操作。您可通过创意形式查询工具或创意信息查询接口（adcreative_templates/get）进行相关参数查询。

系统会采用几种尺寸调整方式，规则如下：

若原视频尺寸比例与创意形式要求尺寸比例相近，则调用一键适配会采用“拉伸”（视频自动放缩）的尺寸调整方式生成1个合规视频，落入视频资产可直接投放（例如9:16视频转成750:1334，则只会通过拉伸生成一个目标视频）。

若原视频为竖版视频，创意形式要求横版视频，则调用一键适配会根据算法，使用“高斯模糊”、“智能取色”和“智能取图”3个尺寸调整方式生成3个合规视频，供广告主选择。视频全部落入投放库可直接投放。

若原视频为横版视频，创意形式要求竖版视频，则调用一键适配会根据算法识别用5个最优的尺寸调整方式生成5个合规视频（例如使用高斯模糊、智能取色、智能取图、精彩镜头、三宫格这5种尺寸调整方式生成5个视频，供广告主选择），全部落入投放库可直接投放。

2、一键适配示例

假如您需要将适配具体创意形式规格，请求示例如下：

curl 'https://api.e.qq.com/v1.1/videomaker_autoadjustment/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=111111111' \
-d 'video_file=@/usr/local/my/video.mp4' \
-d 'signature=19efcaeda3c30e1cf28170d86ecbf5e0' \
-d 'adjustment_type=SMART_ADJUSTMENT' \
-d 'smart_adjustment = {
    "adcreative_template_id":271,
    "campaign_type":"CAMPAIGN_TYPE_NORMAL",
    "promoted_object_type":"PROMOTED_OBJECT_TYPE_LINK",
    "site_set":["SITE_SET_WECHAT"]
}'

四、查询任务

在您成功提交智能调整任务后，系统会返回任务id（1个任务id对应1个视频）。您可通过创意中心通用接口来获取视频工具任务当前执行状态以及相关信息。任务完成后，根据返回的video_id可直接用于投放。

假如您需要查询智能调整任务，请求示例如下：

curl 'https://api.e.qq.com/v1.1/videomaker_autoadjustment/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=111111111' \
-d 'task_id=eda3c30e1cf28170'

五、智能调整结果示例

调整前：

调整后：