JianYingAPI
main
  • main
  • afanti
  1. 文本
JianYingAPI
main
  • main
  • afanti
  • 默认模块
    • 一分钟,了解 流光剪辑!
    • 扣子工作流示例
    • 如何下载草稿
    • 在线预览草稿
    • 获取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
      • search_artist
        POST
      • add_text_template
        POST
    • 图片
      • 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. 文本

add_subtitle

POST
/add_subtitle
添加srt格式字幕,快速,但是支持的属性比add_text方法少

请求参数

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_subtitle' \
--header 'Authorization: Bearer  <token>' \
--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
}
修改于 2025-12-03 03:21:13
上一页
add_text
下一页
search_artist
Built with