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_text

POST
/add_text
添加文字
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.capcutapi.top/cut_jianying/add_text' \
--header 'Authorization: Bearer your-api-key' \
--header 'Content-Type: application/json' \
--data-raw '{
    "text": "你好!Hello",  // 文本内容(必填,核心显示内容)
    "start": 0,  // 文本在时间线的起始时间(秒,必填)
    "end": 5,  // 文本在时间线的结束时间(秒,必填)
    "draft_id": "your_draft_id",  // 草稿ID(选填,用于关联操作的草稿)
    "transform_y": 0,  // Y轴变换参数(选填,默认0)
    "transform_x": 0,  // X轴变换参数(选填,默认0)
    "font": "文轩体",  // 字体(选填,默认"系统")
    "font_color": "#FF0000",  // 字体颜色(选填,默认红色#FF0000)
    "font_size": 8.0,  // 字体大小(选填,默认8.0)
    "track_name": "text_main",  // 轨道名称(选填,默认"text_main")
    "vertical": false,  // 是否垂直显示(选填,默认false)
    "font_alpha": 1.0,  // 字体透明度(选填,默认1.0,范围0.0-1.0)
    "fixed_width": -1,  // 固定宽度(选填,默认-1,-1表示不固定)
    "fixed_height": -1,  // 固定高度(选填,默认-1,-1表示不固定)
    // 描边参数
    "border_alpha": 1.0,  // 描边透明度(选填,默认1.0)
    "border_color": "#000000",  // 描边颜色(选填,默认黑色#000000)
    "border_width": 0.0,  // 描边宽度(选填,默认0.0)
    // 背景参数
    "background_color": "#000000",  // 背景颜色(选填,默认黑色#000000)
    "background_style": 0,  // 背景样式(选填,默认0,需与业务支持的样式枚举匹配)
    "background_alpha": 0.0,  // 背景透明度(选填,默认0.0)
    // 入场动画
    "intro_animation": "向下飞入",  // 入场动画类型(选填,如"向下飞入"等)
    "intro_duration": 0.5,  // 入场动画持续时间(秒,选填,默认0.5)
    // 出场动画
    "outro_animation": "向下滑动",  // 出场动画类型(选填,如"向下滑动"淡出等)
    "outro_duration": 0.5,  // 出场动画持续时间(秒,选填,默认0.5)
    "width": 1080,  // 画布宽度(选填,默认1080)
    "height": 1920,  // 画布高度(选填,默认1920)
    "text_styles": [
        {
            "start": 0, // 开始字符位置,包含
            "end": 2,  // 结束字符位置,不包含
            "style": {
                "size": 50.0,
                "bold": true,
                "italic": true,
                "underline": true,
                "color": "#00FF00"
            },
            "border": {
                "alpha": 1,
                "color": "#FFFFFF",
                "width": 40
            },
            "font": "挥墨体"
        }
    ]
}'
响应示例响应示例
{
    "error": "",
    "output": {
        "draft_id": "dfd_cat_1752371354_d9fa0aaf",
        "draft_url": "https://www.install-ai-guider.top/draft/downloader?draft_id=dfd_cat_1752371354_d9fa0aaf"
    },
    "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-12 07:24:51
上一页
get_font_types
下一页
add_subtitle
Built with