跳到主要内容

Add_Captions - 添加字幕

向草稿中添加文字字幕，支持字体、颜色、动画等丰富的样式设置。

📋 功能说明​

Add_Captions 节点允许您向剪映草稿中添加文字内容，支持多种字体样式和动画特效。

🌐 API调用​

接口地址​

POST https://jy-api.0x0.chat/v1/add_captions.php

请求头​

Content-Type: application/json

📥 输入参数​

参数名类型必填说明
idsString✅通过 Create_Draft 获取的草稿 ID
textsArray✅文字内容数组，单个文字请使用 Str_Array 转换
timelinesArray✅文字显示的时间线数组
fontString❌文字字体名称
text_colorString❌字体颜色，十六进制格式 #000000
font_sizeInteger❌字体大小
borderString❌文字描边样式
border_colorString❌描边颜色，十六进制格式 #000000
alignmentInteger❌对齐方式：0=左对齐，1=居中，2=右对齐
letter_spacingNumber❌字间距
line_spacingNumber❌行间距
transform_xInteger❌X轴位置调整
transform_yInteger❌Y轴位置调整
in_animationString❌入场动画名称
in_animation_durationInteger❌入场动画时长（微秒）
out_animationString❌出场动画名称
out_animation_durationInteger❌出场动画时长（微秒）

💡 请求示例​

基础文字​

{
  "ids": "{{Create_Draft.ids}}",
  "texts": ["欢迎使用剪映小助手！"],
  "timelines": [{"start": 0, "end": 3000000}]
}

多段文字​

{
  "ids": "{{Create_Draft.ids}}",
  "texts": ["大家好", "我是AI技师"],
  "timelines": [
    {"start": 0, "end": 2000000},      // "大家好"：0-2秒
    {"start": 2000000, "end": 4000000} // "我是AI技师"：2-4秒
  ]
}

完整样式配置​

{
  "ids": "{{Create_Draft.ids}}",
  "texts": ["剪映小助手"],
  "timelines": [{"start": 0, "end": 5000000}],
  "font": "新青年体",
  "font_size": 24,
  "text_color": "#FFFFFF",
  "border": "粗描边",
  "border_color": "#000000",
  "alignment": 1,                    // 居中对齐
  "transform_y": -600,               // 向上移动
  "in_animation": "逐字打印",
  "in_animation_duration": 2000000   // 2秒动画
}

🎨 字体和样式​

字体选择​

支持 127+ 种字体，常用字体包括：

  • 新青年体 - 现代简洁
  • 思源黑体 - 经典易读
  • 站酷快乐体 - 活泼可爱
  • 阿里巴巴普惠体 - 商务专业
字体列表

查看完整字体列表：剪映小助手文字字体

颜色设置​

{
  "text_color": "#FFFFFF",    // 白色文字
  "border_color": "#000000"   // 黑色描边
}

常用颜色：

  • 白色：#FFFFFF
  • 黑色：#000000
  • 红色：#FF0000
  • 蓝色：#0000FF
  • 金色：#FFD700

字体大小​

{
  "font_size": 24  // 推荐大小 16-32
}

📐 位置和对齐​

对齐方式​

{
  "alignment": 0  // 0=左对齐, 1=居中, 2=右对齐
}

位置调整​

{
  "transform_x": 0,     // 水平位置：正值向右，负值向左
  "transform_y": -600   // 垂直位置：正值向下，负值向上
}

间距设置​

{
  "letter_spacing": 2.0,  // 字间距
  "line_spacing": 1.5     // 行间距
}

✨ 文字动画​

入场动画​

常用入场动画：

  • 渐显 - 淡入效果
  • 逐字打印 - 打字机效果
  • 飞入 - 从边缘飞入
  • 缩放 - 从小到大
{
  "in_animation": "逐字打印",
  "in_animation_duration": 2000000  // 2秒动画
}

出场动画​

{
  "out_animation": "渐隐",
  "out_animation_duration": 1000000  // 1秒动画
}
动画限制

入场动画和出场动画仅可二选一，不能同时设置。

📊 时间线配置​

字幕时间线​

{
  "texts": ["第一句话", "第二句话"],
  "timelines": [
    {"start": 0, "end": 3000000},      // 第一句：0-3秒
    {"start": 3000000, "end": 6000000} // 第二句：3-6秒
  ]
}

重叠显示​

{
  "texts": ["主标题", "副标题"],
  "timelines": [
    {"start": 0, "end": 5000000},      // 主标题：0-5秒
    {"start": 1000000, "end": 4000000} // 副标题：1-4秒（重叠显示）
  ]
}

🎯 使用场景​

视频字幕​

{
  "texts": ["大家好，欢迎观看本期视频"],
  "font": "思源黑体",
  "font_size": 18,
  "text_color": "#FFFFFF",
  "border": "细描边",
  "border_color": "#000000",
  "alignment": 1,
  "transform_y": 600  // 底部字幕位置
}

标题文字​

{
  "texts": ["剪映小助手教程"],
  "font": "新青年体",
  "font_size": 32,
  "text_color": "#FFD700",
  "alignment": 1,
  "transform_y": -400,
  "in_animation": "渐显"
}

提示标签​

{
  "texts": ["点击关注"],
  "font": "站酷快乐体",
  "font_size": 20,
  "text_color": "#FF4444",
  "alignment": 2,
  "transform_x": 400,
  "transform_y": -800
}

⚠️ 注意事项​

  1. 数组长度：文字数组与时间线数组长度必须一致
  2. 字体名称：使用支持的字体名称，参考字体列表
  3. 颜色格式：必须使用十六进制颜色代码格式
  4. 位置坐标：基于画布大小，可通过剪映预览调整

🔧 故障排除​

Q: 文字不显示？ A: 检查文字内容是否为空，时间线是否正确设置。

Q: 字体显示异常？ A: 确认使用的字体名称在支持列表中。

Q: 文字位置不对？ A: 调整 transform_x 和 transform_y 参数，注意坐标系统。

Q: 动画效果无效？ A: 检查动画名称是否正确，参考动画特效列表。

🎯 相关功能​