调用 SubmitDirectEditTaskAsync 提交异步视频剪辑任务。

使用说明

提交剪辑任务后，您可通过以下方式获取视频剪辑任务相关信息：

• 调用 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
{
  "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"
        }
      ]
    ],
    "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