调用 SubmitDirectEditTaskAsync 接口提交异步的直接剪辑任务。

使用说明

本接口是直接剪辑模式，适用于一次性、无需保存剪辑配置的视频剪辑场景。您可以将包含多轨道、素材、特效、转场等所有剪辑信息的 EditParam 参数一次性传入，系统将在后端进行异步合成。此模式不会创建可复用的剪辑工程，如果需要保存和复用剪辑配置，请使用工程化剪辑模式。
提交任务后，您可以通过以下方式追踪任务状态和获取结果：

• 主动查询：
  • 调用 GetDirectEditProgress 接口查询任务进度。
  • 调用 GetDirectEditResult 接口获取任务的详细结果。
• 事件通知：配置视频剪辑完成事件来接收异步回调通知。

注意事项

• 费用说明：视频剪辑功能按剪辑输出文件的编码格式、分辨率和时长计费，具体价格请参见视频剪辑计费。
• 如需获取剪辑任务产物的播放地址，请在提交剪辑任务前，请完成以下操作：
  • 添加点播域名。
  • 空间内开启视频自动发布。

请求说明

• 请求方式：POST
• 请求地址：https://vod.volcengineapi.com?Action=SubmitDirectEditTaskAsync&Version=2018-01-01

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。

Query

Body

返回参数

下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。

请求示例

POST https://vod.volcengineapi.com?Action=SubmitDirectEditTaskAsync&Version=2018-01-01
POST https://vod.volcengineapi.com?Action=SubmitDirectEditTaskAsync&Version=2018-01-01{
  "Application": "VideoTrackToB",
  "CallbackArgs": "",
  "Uploader": "edit_tob",
  "CreateAt": "2022-02-28T16:38:49+08:00",
  "EditParam": {
    "Canvas": {
      "Height": 2160,
      "Width": 3840
    },
    "Output": {
      "Alpha": false,
      "Codec": {
        "AudioBitrate": 128,
        "AudioCodec": "aac",
        "Crf": 23,
        "Preset": "slow",
        "VideoCodec": "h264"
      },
      "DisableAudio": false,
      "DisableVideo": false,
      "Fps": 30
    },
    "Track": [
      [
        {
          "TargetTime": [
            0,
            195000
          ],
          "Type": "video"
          "Source": "vid://v02b6d970***5pi6vambf9r4s5qhg",
        }
      ]
    ],
    "Upload": {
      "SpaceName": "edit_tob",
      "VideoName": "编辑测试项目 2022年8月28日",
      "FileName": "demo/.mp4"
    },
    "Uploader": "edit_tob"
  }
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20220228******09170404E144",
    "Action": "SubmitDirectEditTaskAsync",
    "Version": "2018-01-01",
    "Service": "vod",
    "Region": "cn-north-1"
  },
  "Result": {
    "ReqId": "3b5fece1a47******443a6aeea5abc"
  }
}

错误码

下表列举了本接口特有的错误码。如需了解更多错误码，详见视频点播公共错误码。

服务端 SDK

点播 OpenAPI 提供了配套的服务端 SDK，支持多种编程语言，帮助您实现快速开发。建议使用服务端 SDK 来调用 API，此 API 各语言调用的示例代码，请参考如下：

• Java
• Python
• PHP
• Go