如何使用

第一步

先通过分散的步骤，验证自己的剪辑逻辑，例如我这里的剪辑流程是先创建一个草稿create_draft

{
    "width": 1080,  // 视频宽度（选填，默认 1080 ）
    "height": 1920  // 视频高度（选填，默认 1920 ）
}

再通过add_text添加一个字幕

{
   "text": "你好!Hello",  // 文本内容（必填，核心显示内容）
   "start": 0,  // 文本在时间线的起始时间（秒，必填）
   "end": 5,  // 文本在时间线的结束时间（秒，必填）
   "draft_id": "create_draft生成的id"
}

再给这个草稿添加一张图片add_image

{
  "image_url": "https://cdn.wanx.aliyuncs.com/wanx/1719234057367822001/text_to_image_v2/d6e33c84d7554146a25b1093b012838b_0.png?x-oss-process=image/resize,w_500/watermark,image_aW1nL3dhdGVyMjAyNDExMjkwLnBuZz94LW9zcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxtX2ZpeGVkLHdfMTQ1LGhfMjU=,t_80,g_se,x_10,y_10/format,webp",
  "start": 0,
  "end": 5.0,
  "draft_id": "create_draft生成的id"
}

利用在线预览，或者下载草稿，确认剪辑效果正确

第二步

制作工作流
工作流本质上是剪辑功能的组合，我们需要给出剪辑的步骤流程，这样就不需要重复请求。针对这里的情况，我们可以制作如下剪辑工作流：

{
    "steps": [
        {
            "index": 0,
            "action_type": "create_draft",
            "action": "{\"width\": 1080, \"height\": 1920}"
        },
        {
            "index": 1,
            "action_type": "add_text",
            "action": "{\"text\": \"你好!Hello\",  \"start\": 0,  \"end\": 5}"
        },
        {
            "index": 2,
            "action_type": "add_image",
            "action": "{\"image_url\": \"https://cdn.wanx.aliyuncs.com/wanx/1719234057367822001/text_to_image_v2/d6e33c84d7554146a25b1093b012838b_0.png?x-oss-process=image/resize,w_500/watermark,image_aW1nL3dhdGVyMjAyNDExMjkwLnBuZz94LW9zcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxtX2ZpeGVkLHdfMTQ1LGhfMjU=,t_80,g_se,x_10,y_10/format,webp\",  \"start\": 0,  \"end\": 5.0}"
        }
    ]
}

工作流是一个json文件，要注意以下几点：

steps字段记录了每一步的操作，利用index控制顺序

如果设置了最外层的draft_id，表示基于已有草稿继续编辑，如果为空则默认创建新草稿

不需要给每一步设置draft_id，程序会读取第一步操作生成的draft_id

action_type的取值范围是:

add_text

add_subtitle

add_text_template

add_image

add_video

add_audio

add_video_keyframe

add_effect

add_sticker

create_draft

action的内容参考上述接口的请求体

发送请求

目前只支持纯文本的方式发送工作流，不支持工作流文件链接，不支持工作流文件ID的方式创建工作流，请求的返回体如下：

{
    "error": "",
    "output": {
        "draft_id": "dfd_cat_1760946180_fc9a8560",
        "draft_url": "https://cn.capcutapi.top/draft/downloader?draft_id=dfd_cat_1760946180_fc9a8560&is_capcut=0&api_key_hash=15b082f53a67b381693cc2c62982d3bf662463523721ca35544106af2d2bb57c"
    },
    "purchase_link": "https://www.coze.cn/store/project/7498257920212647946?entity_id=1&bid=6g6miqtbk3009",
    "success": true
}

利用draft_id可以进行下一步的云渲染generate_video,或者打开draft_url在线预览草稿，下载草稿。

使用工作流功能

原来：#

现在：#

如何使用#

原来：

现在：

如何使用