JianYingAPI
  1. 文本
JianYingAPI
  • 一分钟,了解 剪映API!
  • 如何下载草稿
  • 在线预览草稿
  • 获取API Key
  • 文本
    • get_text_intro_types
      GET
    • get_text_outro_types
      GET
    • get_text_loop_anim_types
      GET
    • get_font_types
      GET
    • add_text
      POST
    • add_subtitle
      POST
  • 图片
    • get_intro_animation_types
      GET
    • get_outro_animation_types
      GET
    • get_combo_animation_types
      GET
    • add_image
      POST
  • 视频
    • add_video
      POST
  • 转场
    • get_transition_types
      GET
  • 蒙版
    • get_mask_types
      GET
  • 音频
    • get_audio_effect_types
      GET
    • add_audio
      POST
  • 关键帧
    • add_video_keyframe
      POST
  • 特效
    • get_video_character_effect_types
      GET
    • get_video_scene_effect_types
      GET
    • add_effect
      POST
  • 贴纸
    • search_sticker
    • add_sticker
  • 云渲染
    • generate_video
    • task_status
  • create_draft
    POST
  • save_draft
    POST
  • get_duration
    POST
  1. 文本

add_subtitle

POST
/add_subtitle
向指定草稿添加字幕,比add_text方法多了直接添加srt格式字幕的能力,但是不支持动画
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.capcutapi.top/cut_jianying/add_subtitle' \
--header 'Authorization: Bearer your-api-key' \
--header 'Content-Type: application/json' \
--data-raw '{
    "srt": "1\\n00:00:00,000 --> 00:00:04,433\\n你333好,我是孙观楠开发的剪映草稿助手。",  // 字幕内容或SRT文件URL(必填,支持直接传字幕文本或文件路径/URL)
    "draft_id": "your_draft_id_123",  // 草稿ID(选填,用于指定要添加字幕的草稿)
    "time_offset": 0.0,  // 字幕时间偏移量(秒,选填,默认0.0,可整体调整字幕显示时间)
    // 字体样式参数
    "font_size": 5.0,  // 字体大小(选填,默认5.0)
    "font": "挥墨体",
    "bold": false,  // 是否加粗(选填,默认false)
    "italic": false,  // 是否斜体(选填,默认false)
    "underline": false,  // 是否下划线(选填,默认false)
    "font_color": "#FFFFFF",  // 字体颜色(选填,默认白色#FFFFFF,支持十六进制色值)
    "vertical": false,  // 是否垂直显示(选填,默认false)
    "alpha": 1,  // 字体透明度(选填,默认1,范围0-1,1为完全不透明)
    // 边框参数
    "border_alpha": 1.0,  // 边框透明度(选填,默认1.0)
    "border_color": "#000000",  // 边框颜色(选填,默认黑色#0a00000)
    "border_width": 0.0,  // 边框宽度(选填,默认0.0)
    // 背景参数
    "background_color": "#000000",  // 背景颜色(选填,默认黑色#000000)
    "background_style": 0,  // 背景样式(选填,默认0,需与业务支持的样式枚举匹配,如0为无背景、1为矩形背景等)
    "background_alpha": 0.0,  // 背景透明度(选填,默认0.0)
    // 图像调节参数
    "transform_x": 0.0,  // X轴位置偏移(选填,默认0.0)
    "transform_y": -0.8,  // Y轴位置偏移(选填,默认-0.8)
    "scale_x": 1.0,  // X轴缩放比例(选填,默认1.0)
    "scale_y": 1.0,  // Y轴缩放比例(选填,默认1.0)
    "rotation": 0.0,  // 旋转角度(选填,默认0.0,单位为度)
    "track_name": "subtitle",  // 轨道名称(选填,默认"subtitle")
    "width": 1080,  // 画布宽度(选填,默认1080)
    "height": 1920  // 画布高度(选填,默认1920)
}'
响应示例响应示例
{
    "error": "",
    "output": {
        "draft_id": "dfd_cat_1752373713_c3229c85",
        "draft_url": "https://www.install-ai-guider.top/draft/downloader?draft_id=dfd_cat_1752373713_c3229c85"
    },
    "purchase_link": "https://www.coze.cn/store/project/7498257920212647946?entity_id=1&bid=6g6miqtbk3009",
    "success": true
}

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功
application/json
Body

修改于 2025-08-08 01:11:35
上一页
add_text
下一页
get_intro_animation_types
Built with