详细每个节点使用说明：

图片[1]-add_text 添加字幕 – 剪映助手-爱智特agent,一站式企业智能体推荐平台,扣子企业智能体,扣子工作流免费复制下载

为视频添加文本内容，支持自定义文本样式、位置、动画效果及显示时间范围。

请求参数

参数名	类型	必选	默认值	说明
text	string	是	–	文本内容
start	number (秒)	是	0	文本开始时间（秒）
end	number (秒)	是	5	文本结束时间（秒）
draft_id	string	否	–	草稿ID，不填则创建新草稿
transform_x	float	否	0	X轴位置（以视频中心为原点，对应视频宽度）
transform_y	float	否	0	Y轴位置（以视频中心为原点，对应视频高度）
font	string	否	“文轩体”	字体，支持的字体参考：add_text
font_color	string	否	“#FF0000”	字体颜色（HEX格式，如：#FF0000）
font_size	float	否	8.0	字体大小
vertical	boolean	否	false	是否竖排显示
font_alpha	float	否	1.0	文字透明度（范围0.0-1.0）
track_name	string	否	“text_main”	轨道名称
border_alpha	float	否	1.0	描边透明度（范围0.0-1.0）
border_color	string	否	“#000000”	描边颜色（HEX格式）
border_width	float	否	0.0	描边宽度
background_color	string	否	“#000000”	背景颜色（HEX格式）
background_style	integer	否	0	背景样式（0 或者 2）
background_alpha	float	否	0.0	背景透明度（范围0.0-1.0）
intro_animation	string	否	–	支持的入场动画：add_text
intro_duration	float (秒)	否	0.5	入场动画持续时间（秒）
outro_animation	string	否	–	支持的出场动画：add_text
outro_duration	float (秒)	否	0.5	出场动画持续时间（秒）
width	integer	否	1080	视频宽度
height	integer	否	1920	视频高度
fixed_width	float	否	-1	文字宽度限制，-1表示不限制，1表示1个视频宽度
fixed_height	float	否	-1	文字高度限制，-1表示不限制，1表示1个视频高度
bubble_effect_id	string	否	–	气泡效果ID
bubble_resource_id	string	否	–	气泡资源ID
effect_effect_id	string	否	–	花字效果ID
text_styles	array	否	[]	多样式文本配置，数组内为样式区间对象（见下表）

text_styles 数组内的样式区间对象结构：

子参数名	类型	必选	默认值	说明
start	integer	否	–	样式生效的文本起始位置（字符索引，从0开始）
end	integer	否	–	样式生效的文本结束位置（字符索引，不含该位置，即 [start, end) 区间）
style	object	否	–	文本样式配置（见下表）
border	object	否	–	文本描边配置（见下表），不填则使用外层默认描边参数
font	string	否	外层font值	该区间文本的字体，优先级高于外层全局字体

style 子对象（文本样式配置）：

子参数名	类型	必选	默认值	说明
size	float	否	外层font_size值	字体大小，优先级高于外层
bold	boolean	否	false	是否加粗
italic	boolean	否	false	是否斜体
underline	boolean	否	false	是否下划线
color	string	否	外层font_color	字体颜色（HEX格式），优先级高于外层
alpha	float	否	外层font_alpha	文字透明度（0.0-1.0），优先级高于外层
align	integer	否	1	对齐方式（1：左对齐；2：居中；3：右对齐）
vertical	boolean	否	外层vertical值	是否竖排显示，优先级高于外层
letter_spacing	float	否	0	字间距（像素或相对单位）
line_spacing	float	否	0	行间距（像素或相对单位）

border 子对象（文本描边配置）：

子参数名	类型	必选	默认值	说明
alpha	float	否	外层border_alpha	描边透明度（0.0-1.0），优先级高于外层
color	string	否	外层border_color	描边颜色（HEX格式），优先级高于外层
width	float	否	外层border_width	描边宽度，优先级高于外层

注意事项

坐标系统说明：
1. 以视频中心为原点(0,0)
2. 实际移动像素计算方式：
  - 水平移动像素 = transform_x * 视频宽度
  - 垂直移动像素 = transform_y * 视频高度
3. 示例：
  - 对于1920×1080的视频，transform_x=0.5 表示向右移动 960 像素
  - transform_y=-0.8 表示向下移动 864 像素
透明度参数0.0表示完全透明，1.0表示完全不透明
颜色值需使用标准HEX格式（如：#FF0000）
text_styles 用于对同一段文本的不同区间设置差异化样式（如部分文字加粗、变色等），未被覆盖的区间使用外层全局参数。
所有子参数的优先级规则：text_styles 数组内的样式 > 外层全局样式。
若 text_styles 为空数组或不填，则所有文本使用外层全局样式。

返回结果

字段	类型	说明
success	boolean	请求是否成功
output	object	处理结果结构体，包含：`draft_id`：字符串类型，生成的草稿ID
error	string	错误信息（失败时返回，包含帮助链接）
purchase_link	string	购买链接（用于错误提示）