文档首页/ 视频点播 VOD/ API参考/ 媒资编辑管理/ 创建编辑任务 - CreateAssetEditTask
更新时间：2026-05-13 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建编辑任务 - CreateAssetEditTask

功能介绍

创建编辑任务

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    vod:asset:createEditTask

    Write

    assets *

    vod:AssetLabel

    -

    -

URI

POST /v1/{project_id}/asset/editing/tasks

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

否

String

用户Token，使用Token鉴权方式时必选。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

Authorization

否

String

使用AK/SK方式认证时必选，携带的鉴权信息。

X-Sdk-Date

否

String

使用AK/SK方式认证时必选，请求的发生时间。
表3 请求Body参数

参数

是否必选

参数类型

描述

inputs

是

Array of EditInput objects

待编辑媒资列表，最多支持20个。

editing_settings

否

VodEditingSetting object

剪辑配置
表4 EditInput

参数

是否必选

参数类型

描述

asset_id

是

String

媒资ID

timeline_start

是

String

剪切开始时间，单位：秒，最大长度支持32，支持整数秒，不支持小数等传参，从0开始，若为0则表示从媒资起始位置开始剪切。

timeline_end

是

String

剪切结束时间，单位：秒，最大长度支持32，支持整数秒，不支持小数等传参，支持0值，0表示剪切到媒资的最后位置。
表5 VodEditingSetting

参数

是否必选

参数类型

描述

resolution_adaptation

否

Boolean

分辨率自适应策略, 选值：true, false（默认true）

输入为true时，width表示长边，height表示短边

输入为false时，width表示宽度，height表示长度

resolution_upsample

否

Boolean

分辨率上采样开关, 选值：true, false（默认false），若为false则按照原片源输出，分辨率不会上浮。

format

否

String

输出封装格式，HLS、MP4（默认MP4）、MP3、MOV、FLV、AVI。

不支持将视频文件输出成音频封装格式。

width

否

Integer

输出宽或长边，整型，输入小数向下取整，默认0，按源

  • 当width、height均为0，则分辨率取片源分辨率；

  • 当width为0，height非0，则width按片源分辨率比例缩放；

  • 当width非0，height为0，则height按片源分辨率比例缩放；

  • 当width、height均非0，则分辨率按用户指定。

  • 当视频编码为H.264时，则width最小值为32，最大值为4096。

  • 当视频编码为H.265，则width最小值为160，最大值为4096。

height

否

Integer

输出高或短边，整型，输入小数向下取整，默认0，按源

  • 当Width、Height均为0，则分辨率取片源分辨率；

  • 当Width为0，Height非0，则Width按片源分辨率比例缩放；

  • 当Width非0，Height为0，则Height按片源分辨率比例缩放；

  • 当Width、Height 均非0，则分辨率按用户指定。

  • 当视频编码为H.264时，则height最小值为32，最大值为2880。

  • 当视频编码为H.265，则height最小值为160，最大值为2880。

reference

否

String

输出参考基准，可选，默认为NONE

  • NONE 输出分辨率按输入的第一个片源为主，码率按输出分辨率自适应

  • MAX_BITRATE 按码率最大的输入片源参数为基准

  • MAX_RESOLUTION 按分辨率最大的输入片源参数为基准

video_codec

否

Integer

视频编码格式，默认为1。

取值如下：

  • 1：VIDEO_CODEC_H264

  • 2：VIDEO_CODEC_H265

响应参数

状态码：200

表6 响应Body参数

参数

参数类型

描述

task_id

String

编辑任务ID

asset_id

String

媒资ID

状态码：400

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

创建编辑任务

POST https://{endpoint}/v1/{project_id}/asset/editing/tasks

{
  "inputs" : [ {
    "asset_id" : "xxxxxx",
    "timeline_start" : "0",
    "timeline_end" : "5687"
  } ],
  "editing_settings" : {
    "format" : "MP4"
  }
}

响应示例

状态码：200

处理成功返回。

{
  "task_id" : "5723efduytasfd752352635",
  "asset_id" : "xxxxxxxxx"
}

状态码

状态码

描述

200

处理成功返回。

400

处理失败返回。

错误码

请参见错误码。

父主题： 媒资编辑管理

相关文档