文档

使用 S3 协议输出成片

更新时间:

本文档介绍了在使用 SubmitMediaProducingJob 接口时,如何配置 S3 协议类型的输出方式。

重要

本功能当前公测阶段暂不额外收费,正式商业发布后会重新定价

一、背景

SubmitMediaProducingJob 接口已经支持配置 S3 协议类型的输出,如果您需要将剪辑制作的成片直接输出到其它云厂商的存储产品中,可以采用 S3 协议来进行输出配置。

二、介绍

涉及接口:SubmitMediaProducingJob - 提交剪辑合成作业

涉及入参:

  1. OutputMediaTarget,本参数需要设置为「S3」,用于标识本次使用 S3 协议输出

  2. OutputMediaConfig,在此入参中,配置与 S3 协议所需的参数,子参数包括:

    1. Endpoint:目标云厂商提供的 Endpoint

    2. Bucket:目标云厂商的存储 Bucket

    3. ObjectKey:输出对象名

    4. AccessKeyId:目标云厂商的临时 AccessKeyId

    5. AccessKeySecret:目标云厂商的临时 AccessKeySecret

三、示例

3.1 输出到腾讯云对象存储 COS

{
    "OutputMediaTarget": "S3",
    "OutputMediaConfig": {
        "Endpoint": "https://your_bucket.cos.ap-shanghai.myqcloud.com",
        "Bucket": "test-directory",
        "ObjectKey": "test.mp4",
        "AccessKeyId": "XXX",
        "AccessKeySecret": "XXX"
    }
}
说明

腾讯云 COS 新版访问域名中已经包含了 Bucket 信息,使用新版域名时,Bucket 入参中填入的字段会作为父级目录,也就是说,按照上面的示例,输出文件的路径为:https://your_bucket.cos.ap-shanghai.myqcloud.com/test-directory/test.mp4

3.2 输出到华为云对象存储服务 OBS

{
    "OutputMediaTarget": "S3",
    "OutputMediaConfig": {
        "Endpoint": "https://obs.cn-east-3.myhuaweicloud.com",
        "Bucket": "your-bucket",
        "ObjectKey": "test.mp4",
        "AccessKeyId": "XXX",
        "AccessKeySecret": "XXX"
    }
}

3.3 输出到阿里云对象存储 OSS 其它区域

您也可以通过 S3 协议,将成品输出到其它区域的 OSS 对下存储中,比如:使用上海区域的剪辑服务,将成片输出到杭州区域的 OSS 中。

{
    "OutputMediaTarget": "S3",
    "OutputMediaConfig": {
        "Endpoint": "https://oss-cn-hangzhou.aliyuncs.com",
        "Bucket": "your-bucket",
        "ObjectKey": "test.mp4",
        "AccessKeyId": "XXX",
        "AccessKeySecret": "XXX"
    }
}