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

使用说明

• 本接口是一个可扩展的 AI 视频智剪任务提交入口，旨在通过统一的 API 承载不断丰富的 AI 视频剪辑能力。您可以通过指定不同的 WorkflowId，来调用后台不同的 AI 工作流。每个工作流都有其专属的参数配置，通过 ParamJson 传入。当前支持的工作流：
  • AI 漫剧转绘：将真人视频智能转换为动漫风格视频。该流程首先对输入视频进行智能场景切分，然后对每个片段进行内容理解和视觉风格转换。最后，利用 AI 生成技术重新绘制视频画面，并与原始的音频和字幕相结合，最终合成为一部完整的动漫风格视频。
• 本接口为异步接口，调用成功后会返回一个任务 ID。您可通过以下方式获取处理结果：
  • 调用 GetVCreativeTaskResult 接口主动查询。
  • 配置 AI 智剪完成事件。

注意事项

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

请求说明

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

调试

请求参数

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

Query

Body

返回参数

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

请求示例

POST https://vod.volcengineapi.com?Action=AsyncVCreativeTask&Version=2018-01-01
{
  "Uploader": "edit_test",
  "ParamJson": "{\"input\":\"vid://v022d2g10065d3rk***vg\",\"space_name\":\"your_space_name\",\"style\":\"漫画风\",\"resolution\":\"720p\"}",
  "WorkflowId": "loki://154160112",
  "CallbackArgs": "Your_Callback_Args"
}

返回示例

{
  "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
    }
  }
}

错误码

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