JianYingAPI
main
  • main
  • afanti
  1. 默认模块
JianYingAPI
main
  • main
  • afanti
  • 默认模块
    • 一分钟,了解 流光剪辑!
    • 扣子工作流示例
    • 如何下载草稿
    • 在线预览草稿
    • 获取API Key
    • 使用工作流功能
    • 飞书智能表格示例
    • 直播间演示
    • 文本
      • 使用花字
      • 使用文字模版
      • 如何上传文字模板
      • get_text_intro_types
      • get_text_outro_types
      • get_text_loop_anim_types
      • get_font_types
      • add_text
      • add_subtitle
      • search_artist
      • add_text_template
    • 图片
      • get_intro_animation_types
      • get_outro_animation_types
      • get_combo_animation_types
      • add_image
    • 视频
      • add_video
    • 转场
      • get_transition_types
    • 蒙版
      • get_mask_types
    • 音频
      • get_audio_effect_types
      • add_audio
    • 关键帧
      • add_video_keyframe
    • 特效
      • get_video_character_effect_types
      • get_video_scene_effect_types
      • add_effect
    • 贴纸
      • search_sticker
      • add_sticker
    • 云渲染
      • generate_video
      • task_status
    • 工作流
      • 工作流脚本技术文档
      • 工作流 AI Prompt 提示词
      • execute_workflow
    • 模版/预设
      • 如何使用模版/预设功能
      • 如何上传模版
      • add_preset
    • 滤镜
      • add_filter
      • get_filter_types
    • create_draft
      POST
    • save_draft
      POST
    • get_duration
      POST
  1. 默认模块

使用工作流功能

串行多个请求是低效且重复的工作。为此,我们开发了工作流excute_workflow功能,方便开发者快速上手。
举个例子

原来:#

1.
create_draft创建草稿
2.
add_text添加字幕
3.
add_image添加图片
4.
add_image添加图片
5.
...众多请求组合
6.
generate_video云端渲染

现在:#

1.excute_workflow快速执行工作流
5. generate_video云端渲染

如何使用#

1
第一步
先通过分散的步骤,验证自己的剪辑逻辑,例如我这里的剪辑流程是先创建一个草稿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"
}
利用在线预览,或者下载草稿,确认剪辑效果正确
image.png
2
第二步
制作工作流
工作流本质上是剪辑功能的组合,我们需要给出剪辑的步骤流程,这样就不需要重复请求。针对这里的情况,我们可以制作如下剪辑工作流:
{
    "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文件,要注意以下几点:
1.
steps字段记录了每一步的操作,利用index控制顺序
2.
如果设置了最外层的draft_id,表示基于已有草稿继续编辑,如果为空则默认创建新草稿
3.
不需要给每一步设置draft_id,程序会读取第一步操作生成的draft_id
4.
action_type的取值范围是:
add_text
add_subtitle
add_text_template
add_image
add_video
add_audio
add_video_keyframe
add_effect
add_sticker
create_draft
5.
action的内容参考上述接口的请求体
3
发送请求
目前只支持纯文本的方式发送工作流,不支持工作流文件链接,不支持工作流文件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在线预览草稿,下载草稿。
修改于 2025-10-22 15:55:35
上一页
获取API Key
下一页
飞书智能表格示例
Built with