You need to enable JavaScript to run this app.
导航
CreateProject - 创建剪辑工程
最近更新时间:2025.10.24 19:49:14首次发布时间:2025.10.24 19:49:14
复制全文
我的收藏
有用
有用
无用
无用

调用 CreateProject 接口创建剪辑工程。

注意事项

  • 使用该接口前,请确保您已充分了解视频点播的收费方式和价格。视频剪辑为付费功能,具体请见按量计费
  • 本接口的单用户 QPS 限制为10 次/秒。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见 API QPS 限制

请求说明

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

调试

请求参数

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

Query

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

Body

参数
类型
是否必选
示例值
描述
ProjectName
String
新建项目-yh

剪辑工程的名称。长度建议控制在 1-128 个字符之间。支持以下字符类型:

  • 汉字
  • 大小写字母
  • 数字
  • 中划线(-)
  • 下划线(_)
Space
String
test

点播空间名。您可通过以下方式获取空间名称:

  • 在视频点播控制台空间管理页面查看当前账号下所有空间的名称。
  • 调用 ListSpace 接口获取当前账号下所有空间的名称。
EditParam
JSONMap
-
剪辑工程的参数。详见视频剪辑参数
ProjectType
String
track
剪辑工程的类型,当前仅支持 track类型。

返回参数

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

参数
类型
示例值
描述
ProjectId
String
p03ef0xxxxxxxxxxxxx4bm0
剪辑工程 ID。
GroupId
String
g03cexxxxxxxxxxxxxxxxxqt2g
剪辑工程所属的组 ID。

请求示例

POST https://vod.volcengineapi.com?Action=CreateProject&Version=2018-01-01
{
  "ProjectName": "新建项目-test",
  "Space": "test",
  "EditParam": {
    "Project": {
      "Version": "1.0.0",
      "Name": "新建项目-test",
      "CreateTime": 1757142958344,
      "UpdateTime": 1757142958344,
      "Tag": "TrackEditor"
    },
    "Upload": {
      "SpaceName": "test",
      "VideoName": "新建项目-test"
    },
    "Output": {
      "Alpha": false,
      "Fps": 25,
      "Codec": {
        "VideoCodec": "h264",
        "Preset": "slow",
        "Crf": 23,
        "AudioCodec": "aac",
        "AudioBitrate": 128
      },
      "DisableVideo": false,
      "DisableAudio": false,
      "Cover": {
        "DisableCover": false,
        "CoverTime": [
          0
        ]
      }
    },
    "Canvas": {
      "Width": 1920,
      "Height": 1080,
      "BackgroundColor": "#000000FF"
    }
  },
  "ProjectType": "track"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20230604110420****100232280022D31",
    "Action": "CreateProject",
    "Version": "2018-01-01",
    "Service": "vod",
    "Region": "cn-north-1"
  },
  "Result": {
    "ProjectId": "p0ccxxxxxxxxxx",
    "GroupId": "g0c9xxxxxxxxxx"
  }
}

错误码

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

状态码错误码错误信息说明
400InvalidParameter.InvalidParamparamater error参数错误