智能多媒体服务

    • 智能多媒体服务 > API 文档 > 音视频处理 >音视频分段（segment）

    音视频分段（segment）

    最近更新时间: 2025-04-08 15:58:01

    简介

    音视频分段(segment)，用于按时长或时间点对原视频分段，不改变原音/视频的编码格式、分辨率、码率等，将原音/视频切成多个较小的文件。

    注意：如果原音视频文件的编码格式无法封装到目标封装格式，那么会返回错误。

    参数规格

    segment/<Format>
            /segtime/<SegmentTime>
            /savePattern/<savePattern>
    参数名称 类别 必填 说明
    <Format> A/V 是 指定分段文件的封装格式，不改变原音/视频的编码情况下可以改变封装格式，如 h264+aac 编码的 mp4文件可以分段为h264+aac 编码的 mkv 小文件。
    /segtime/<SegmentTime> A/V 否 自定义分段后每一小段音/视频流的播放时长。单位为秒，最小值为5，默认值为5。
    /savePattern/<savePattern> A/V 是 自定义分段后每一小段音/视频流的文件名称。
    命名支持使用变量：
    1. 可以使用 $(变量名)或${变量名} 形式求值，魔法变量使用说明，参考 文件名变量 。
    2. 注意：$(count)为必填项，必须存在的六位占位符数字串。

    示例：
    源文件名为：input.mp4，cmd为：avthumb/mp4/segtime/10/savePattern/JChrZXliYXNlKSQoY291bnQpLm1wNCA= ，其中 JChrZXliYXNlKSQoY291bnQpLm1wNCA= 是自定义分段后的文件名， $(keybase)$(count).mp4 的URL安全的Base64编码。最后得到类似：input000000.mp4,input000001.mp4,……,input000006.mp4 命名的文件，跟源文件命名是关联的。

    操作方式

    您可以通过以下几种方式来创建任务：

    方式一：使用任务触发器

    • 对符合规则策略的上传文件自动触发：在具体空间下，选择任务与工作流，进入任务触发器页面，点击新建 任务触发器；创建完成后，需要开启 上传触发开关，然后通过左侧文件管理或 API/SDK 上传文件到触发器指定的输入路径；将对符合规则策略的上传文件自动触发多媒体处理，并将结果文件保存到目标路径。

      img

    方式二：使用对象存储控制台

    • 上传文件手动触发：在具体空间下， 上传文件 时，指定工作流模板 。

      img

    • 指定文件手动触发：有两种指定单个文件创建任务的入口

      • 第一个入口：在具体空间下，在文件列表中指定文件，在操作栏【更多】中点击【创建多媒体任务】。

        img

        注意：仅对音视频/gif动图/webp动图文件提供该操作。

      • 第二个入口：在具体空间下，选择任务与工作流，进入任务管理页面，点击【新建任务】。

        img

    操作示例

    用户可以根据需要自定义命令，例如：

    segment/mp4/segtime/10/pattern/cWluaXUtJChmbmFtZSkkKGNvdW50KQ== 命令的调用将对原音/视频以10秒左右的时间进行分段，最后将生成多个小段音视频文件。

    响应内容

    如果请求成功，返回类似如下内容的 JSON 字符串

    "result": [
    {
        "index": 0,
        "segment_end_time": "10.857422",
        "segment_filename": "qiniu-000000",
        "segment_start_time": "0.000000"
    },
    {
        "index": 1,
        "segment_end_time": "21.177422",
        "segment_filename": "qiniu-000001",
        "segment_start_time": "10.857422"
    },
    {
        "index": 2,
        "segment_end_time": "21.857422",
        "segment_filename": "qiniu-000002",
        "segment_start_time": "21.177422"
    }
]

    计费说明

    音视频分段服务涉及转封装但不涉及转码，服务价格=音视频装封装价格，定价参考 智能多媒体服务定价 。

    以上内容是否对您有帮助？
    • Close