调用 AsyncVCreativeTask 接口提交异步 AI 视频智剪任务。

使用说明

• 本接口是一个可扩展的 AI 视频智剪任务提交入口，旨在通过统一的 API 承载不断丰富的 AI 视频剪辑能力。您可以通过指定不同的 Scene，来调用后台不同的 AI 工作流。每个工作流都有其专属的参数配置，通过 ParamObj 传入。当前支持的工作流：
  • AI 漫剧转绘：支持将真人实拍的视频（如短剧），通过 AI 自动转换为具有多样化艺术风格的视频（例如动漫风、3D卡通风、素描风）。
  • AI 文字成片：支持用户输入一段文本，通过 AI 自动生成一个包含 AI 绘画、智能配音和字幕的短视频（30 秒左右）。
• 本接口为异步接口，调用成功后会返回一个任务 ID。您可通过以下方式获取处理结果：
  • 调用 GetVCreativeTaskResult 接口主动查询。
  • 配置 AI 智剪完成事件。

注意事项

• 本接口的单用户 QPS 限制为 1 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 API QPS 限制。

请求说明

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

调试

请求参数

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

Query

Body

返回参数

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

请求示例

AI 漫剧转绘

POST https://vod.volcengineapi.com?Action=AsyncVCreativeTask&Version=2018-01-01
{
  "Uploader": "your_output_space_name",
  "Scene": "videostyletrans",
  "CallbackArgs": "task_for_cartoon_style",
  "ParamObj": {
    "input": "vid://v022d2g10065d***bcde123456",
    "style": "3D卡通风格",
    "resolution": "1080p"
  }
}

AI 文字成片

POST https://vod.volcengineapi.com?Action=AsyncVCreativeTask&Version=2018-01-01
{
  "Uploader": "your_output_space_name",
  "Scene": "aigclongvideo",
  "CallbackArgs": "task_for_story_generation",
  "ParamObj": {
    "story": "一个关于勇敢的小狐狸在森林里寻找友谊的温暖故事",
    "resolution": "720p"
  }
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20230604110420****100232280022D31",
    "Service": "vod",
    "Region": "cn-north-1",
    "Action": "AsyncVCreativeTask",
    "Version": "2018-01-01"
  },
  "Result": {
    "VCreativeId": "20251010v1****0c070c0e43cbf4063aaf9c657781b5tob",
    "Code": 0,
    "BaseResp": {
      "StatusMessage": "success",
      "StatusCode": 0
    }
  }
}

错误码

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