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
      • get_video_scene_effect_types
        GET
      • add_effect
        POST
    • 贴纸
      • 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. 特效

add_effect

POST
/add_effect
添加特效

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Body 参数application/json

示例

返回响应

🟢200成功
application/json
Body

请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.capcutapi.top/cut_jianying/add_effect' \
--header 'Authorization: Bearer  <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "effect_type": "MV封面",  // 特效类型名称(必填,需从系统支持的特效列表中选择,如:MV封面)
    "start": 0,  // 特效开始时间(秒,选填,默认0)
    "end": 3.0,  // 特效结束时间(秒,选填,默认3.0)
    "draft_id": "draft_789",  // 草稿ID(选填,指定要添加特效的目标草稿,若未传或对应草稿不存在,可能自动创建新草稿)
    "track_name": "effect_01",  // 特效轨道名称(选填,默认"effect_01",用于区分不同特效轨道)
    "params": [35,45],  // 特效参数列表(选填,未提供的参数将使用默认值,具体参数取决于特效类型),
    "width": 1080,  // 画布宽度(选填,默认1080)
    "height": 1920  // 画布高度(选填,默认1920)
}'
响应示例响应示例
{
    "error": "",
    "output": {
        "draft_id": "dfd_cat_1752375207_f11441ac",
        "draft_url": "https://www.install-ai-guider.top/draft/downloader?draft_id=dfd_cat_1752375207_f11441ac"
    },
    "purchase_link": "https://www.coze.cn/store/project/7498257920212647946?entity_id=1&bid=6g6miqtbk3009",
    "success": true
}
修改于 2025-12-03 06:52:00
上一页
get_video_scene_effect_types
下一页
search_sticker
Built with