视频制作参数说明：轨道、输出、应用ID及画布等相关信息

Region

String

公共参数，此参数为可选参数。

Tracks.N

Array of

输入的媒体轨道列表价格最低 Ollama 接口，包括视频、音频、图片等素材组成的多个轨道信息，其中：输入的多个轨道在时间轴上和输出媒体文件的时间轴对齐；时间轴上相同时间点的各个轨道的素材进行重叠，视频或者图片按轨道顺序进行图像的叠加，轨道顺序高的素材叠加在上面，音频素材进行混音；视频、音频、图片，每一种类型的轨道最多支持 10 个。所有类型的轨道上放置的媒体片段数量总和最多支持 500 个。

Output

输出的媒体文件信息。

SubAppId

Integer

点播应用 ID。从2023年12月25日起开通点播的客户，如访问点播应用中的资源（无论是默认应用还是新创建的应用），必须将该字段填写为应用 ID。

示例值：1500000001

Canvas

制作视频文件时使用的画布。

SessionContext

String

标识来源上下文，用于透传用户请求信息，在ComposeMediaComplete回调将返回该字段值Flux api，最长 1000个字符。

示例值：”sessioncontext”

SessionId

String

用于任务去重的识别码，如果三天内曾有过相同的识别码的请求，则本次的请求会返回错误。最长 50 个字符，不带或者带空字符串表示不做去重。

示例值：”sessionid”

3. 输出参数参数名称类型描述

TaskId

String

制作媒体文件的任务 ID，可以通过该 ID 查询制作任务（任务类型为 MakeMedia）的状态。

示例值：125xxx65-ComposeMedia-bffb15f07530b57bc1aabb01fac74bca

RequestId

String

唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例示例1 对两个视频流进行裁剪后拼接在一起

取5285485487985271487的第2秒到第62秒，5285485487985271488的第6秒到81秒进行拼接，中间设置5秒的淡入淡出转场video api，从视频的3秒到18秒贴上一个图片5285485487985271489，位置为（20px，20px），宽高为（100px，100px）。

输入示例

POST / HTTP/1.1
Host: vod.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ComposeMedia

{
    "Output": {
        "Container": "mp4",
        "FileName": "output"
    },
    "Tracks": [
        {
            "TrackItems": [
                {
                    "StickerItem": {
                        "CoordinateOrigin": "TopLeft",
                        "XPos": "20px",
                        "YPos": "20px",
                        "Height": "100px",
                        "Width": "100px",
                        "StartTime": 3,
                        "Duration": 15,
                        "SourceMedia": "5285485487985271489"
                    },
                    "Type": "Sticker"
                }
            ],
            "Type": "Sticker"
        },
        {
            "TrackItems": [
                {
                    "TransitionItem": {
                        "Duration": 5,
                        "MediaTransitions": [
                            {
                                "Type": "ImageFadeInFadeOut"
                            }
                        ]
                    },
                    "Type": "Transition"
                },
                {
                    "Type": "Video",
                    "VideoItem": {
                        "Duration": 60,
                        "SourceMedia": "5285485487985271487",
                        "SourceMediaStartTime": 2
                    }
                },
                {
                    "Type": "Video",
                    "VideoItem": {
                        "Duration": 75,
                        "SourceMedia": "5285485487985271488",
                        "SourceMediaStartTime": 6
                    }
                }
            ],
            "Type": "Video"
        }
    ]
}

输出示例

{
    "Response": {
        "RequestId": "6ca31e3a-6b8e-4b4e-9256-fdc700064ef3",
        "TaskId": "125xxx65-ComposeMedia-bffb15f07530b57bc1aabb01fac74bc2"
    }
}

示例2 对点播中的视频进行配音

对 5285485487985271487 消除原来的音频，从5秒开始使用5285485487985271488进行配音，从20秒开始使用5285485487985271489的第2到第16秒进行配音，生成一个新的点播视频。

输入示例

POST / HTTP/1.1
Host: vod.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ComposeMedia

{
    "Output": {
        "Container": "mp4",
        "FileName": "output"
    },
    "Tracks": [
        {
            "TrackItems": [
                {
                    "Type": "Empty",
                    "EmptyItem": {
                        "Duration": 5
                    }
                },
                {
                    "AudioItem": {
                        "SourceMedia": "5285485487985271488",
                        "Duration": 15
                    },
                    "Type": "Audio"
                },
                {
                    "AudioItem": {
                        "Duration": 14,
                        "SourceMedia": "5285485487985271489",
                        "SourceMediaStartTime": 2
                    },
                    "Type": "Audio"
                }
            ],
            "Type": "Audio"
        },
        {
            "TrackItems": [
                {
                    "Type": "Video",
                    "VideoItem": {
                        "SourceMedia": "5285485487985271487",
                        "AudioOperations": [
                            {
                                "VolumeParam": {
                                    "Mute": 1
                                },
                                "Type": "Volume"
                            }
                        ]
                    }
                }
            ],
            "Type": "Video"
        }
    ]
}

输出示例

{
    "Response": {
        "RequestId": "6ca31e3a-6b8e-4b4e-9256-fdc700064ef3",
        "TaskId": "125xxx65-ComposeMedia-bffb15f07530b57bc1aabb01fac74bca"
    }
}

示例3 将一个视频作为另一个视频的画中画

将5285485487985271487的视频作为画中画的主画面；将5285485487985271488的视频作为画中画的子画面；子画面的中心偏移主画面25%（即在主画面右下角），宽度占画面的30%。

输入示例

POST / HTTP/1.1
Host: vod.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ComposeMedia

{
    "Output": {
        "Container": "mp4",
        "FileName": "output"
    },
    "Tracks": [
        {
            "TrackItems": [
                {
                    "Type": "Video",
                    "VideoItem": {
                        "SourceMedia": "5285485487985271487"
                    }
                }
            ],
            "Type": "Video"
        },
        {
            "TrackItems": [
                {
                    "Type": "Video",
                    "VideoItem": {
                        "CoordinateOrigin": "Center",
                        "Width": "30%",
                        "SourceMedia": "5285485487985271488",
                        "XPos": "25%",
                        "YPos": "25%"
                    }
                }
            ],
            "Type": "Video"
        }
    ]
}

输出示例

{
    "Response": {
        "RequestId": "6ca31e3a-6b8e-4b4e-9256-fdc700064ef3",
        "TaskId": "125xxx65-ComposeMedia-bffb15f07530b57bc1aabb01fac74bca"
    }
}