SubmitEditTaskAsync - 提交工程化异步剪辑任务--视频点播-火山引擎

文档中心

立即注册

导航

SubmitEditTaskAsync - 提交工程化异步剪辑任务

最近更新时间：2025.10.24 21:15:23首次发布时间：2025.10.24 19:49:14

调用 SubmitEditTaskAsync 接口基于指定的剪辑工程（ProjectId）异步提交一个视频剪辑任务。

注意事项

调用本接口前，您需要先调用 CreateProject 接口创建剪辑工程。

请求说明

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

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

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

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`SubmitEditTaskAsync`	接口名称。当前 API 的名称为 `SubmitEditTaskAsync`。
Version	String	是	`2018-01-01`	接口版本。当前 API 的版本为 `2018-01-01`。

Body

参数	类型	是否必选	示例值	描述
GroupId	String	是	`g03cexxxxxxxxxxxxxxxxxqt2g`	剪辑工程所属的组 ID。
ProjectId	String	是	`p03ef0xxxxxxxxxxxxx4bm0`	剪辑工程 ID。
ProjectType	String	是	`track`	剪辑工程的类型，当前仅支持 `track`类型。
EditParam	Object	是	`-`	剪辑工程的参数。详见视频剪辑参数。
Project	Object	是	`-`	基本信息。
Version	String	是	`1.0.0`	剪辑工程的版本。
Name	String	是	`新建项目-lozm19gfpr`	剪辑工程的名称。长度在 1-128 个字符之间。
CreateTime	Integer	是	`1759060604253`	剪辑工程的创建时间。单位为毫秒。
UpdateTime	Integer	是	`1760844323139`	剪辑工程的最后更新时间。单位为毫秒。
Tag	String	是	`TrackEditor`	剪辑工程的标签。
Upload	Object	是	`-`	上传配置。
SpaceName	String	是	`yhss`	上传的空间。提交完成后工程会被上传至此空间。
VideoName	String	是	`新建项目-lozm19gfpr-1019-11:25`	上传视频的名称。字数控制在 1-128 个字符。
FileName	String	是	`/新建项目-lozm19gfpr-1019-11:25.mp4`	上传工程的文件路径和名称。
Output	Object	是	`-`	输出视频的配置参数。
Alpha	Boolean	是	`false`	输出视频中是否包含 alpha 通道。默认值为 `false`。说明 `Alpha` 的优先级高于 `VideoCodec`。当 `Alpha` 为 `true` 时，`VideoCodec` 默认采用 `VP9`，而不再关注您设置的 `VideoCodec` 参数。
Fps	Integer	是	`30`	输出视频的帧率。单位为 fps。默认值为 30。
Codec	Object	是	`-`	音视频编码设置。
VideoCodec	String	是	`h264`	视频编码格式。取值如下： `h264`: （默认）H.264 `vp9`: VP9 `h265`: H.265
Preset	String	是	`slow`	用于调节视频编码速度和质量。默认值为 `medium`。仅当 `VideoCodec` 设为 `h264`、`h265` 时生效。
Crf	Integer	是	`23`	恒定质量因子 CRF。默认值为 `23`。说明仅当 `VideoCodec` 设为 `h264`、`h265` 时生效。
AudioCodec	String	是	`aac`	音频编码格式。默认值为 `aac`。
AudioBitrate	Integer	是	`128`	音频编码码率。默认值为 128。单位为 kbps。
DisableVideo	Boolean	是	`false`	是否仅输出音频。 `false`：（默认）保存视频。 `true` ：输出结果中将不包含视频内容，仅保留音频。
DisableAudio	Boolean	是	`false`	是否仅输出视频。 `false`：（默认）保存音频。 `true` ：输出结果中将不包含音频内容，仅保留视频。
Cover	Object	是	`-`	封面设置。
DisableCover	Boolean	是	`false`	是否禁用封面生成。默认值为 `false`。 `false`：生成封面； `true`：不生成封面。
CoverTime	Integer[]	是	`[1000,5000,10000]`	封面生成的时间点数组，单位为毫秒。当 `DisableCover` 为 `false`时，系统会根据该数组中的时间点生成对应的封面。
Format	String	是	`mp4`	视频输出的格式类型，取值如下。 `MP4` `DASH` `HLS` `FLV` `TS`
Canvas	Object	是	`-`	画布设置。
Width	Integer	是	`1920`	画布的宽度，单位为像素。取值范围为 [160,8192]。
Height	Integer	是	`1080`	画布的高度，单位为像素。取值范围为 [160,8192]。
BackgroundColor	String	是	`#000000FF`	画布的背景颜色。RGBA 类型，默认值为 `#00000000`。
Track	String[][]	是	`-`	剪辑工程中的轨道信息，用于指定视频、音频等素材在时间轴上的排列顺序和组合方式。

返回参数

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

参数	类型	示例值	描述
TaskId	String	`e070c0xxxxxxxxxx1fc7b6143`	任务 ID，用于后续查询任务状态或结果。

请求示例

POST https://vod.volcengineapi.com?Action=SubmitEditTaskAsync&Version=2018-01-01
{
  "GroupId": "g03cexxxxxxxxxxxxxxxxxqt2g",
  "ProjectId": "p03ef0xxxxxxxxxxxxx4bm0",
  "ProjectType": "track",
  "EditParam": {
    "Project": {
      "Version": "1.0.0",
      "Name": "新建项目-lozm19gfpr",
      "CreateTime": 1759060604253,
      "UpdateTime": 1760844323139,
      "Tag": "TrackEditor"
    },
    "Upload": {
      "SpaceName": "yhss",
      "VideoName": "新建项目-lozm19gfpr-1019-11:25",
      "FileName": "/新建项目-lozm19gfpr-1019-11:25.mp4"
    },
    "Output": {
      "Alpha": false,
      "Fps": 30,
      "Codec": {
        "VideoCodec": "h264",
        "Preset": "slow",
        "Crf": 23,
        "AudioCodec": "aac",
        "AudioBitrate": 128
      },
      "DisableVideo": true,
      "DisableAudio": false,
      "Cover": {
        "DisableCover": true,
        "CoverTime": [
          null
        ]
      },
      "Format": "mp4"
    },
    "Canvas": {
      "Width": 1920,
      "Height": 1080,
      "BackgroundColor": "#000000FF"
    },
    "Track": [
      [
        ""
      ]
    ]
  }
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20230604110420****100232280022D31",
    "Action": "SubmitEditTaskAsync",
    "Version": "2018-01-01",
    "Service": "vod",
    "Region": "cn-north-1"
  },
  "Result": {
    "TaskId": "e070c0xxxxxxxxxx1fc7b6143"
  }
}

错误码

本接口无特有的错误码。更多信息请见公共错误码。