add_subtitle

POST /add_subtitle

接口说明

导入 SRT 字幕内容或 SRT URL，自动按时间轴拆成多条字幕片段。适合整段视频字幕；如果只需要一条标题或说明文字，使用 add_text 更直接。

请求参数

参数	必填	默认值	说明
srt	是	—	SRT 字幕内容或 SRT URL
draft_id	是	—	草稿 ID，创建草稿后获得
time_offset	否	0.0	字幕整体时间偏移，单位秒
font	否	'思源粗宋'	字体名称；先查询 get_font_types
font_size	否	5.0	字号
bold	否	False	是否加粗
italic	否	False	是否斜体
underline	否	False	是否下划线
font_color	否	'#FFFFFF'	文字颜色
vertical	否	False
alpha	否	1	透明度，1.0 为不透明
border_alpha	否	1.0	描边透明度
border_color	否	'#000000'	描边颜色
border_width	否	0.0	描边宽度
background_color	否	'#000000'	背景颜色
background_style	否	0	背景样式
background_alpha	否	0.0	背景透明度
transform_x	否	0.0	X 轴位置偏移
transform_y	否	-0.8	Y 轴位置偏移
scale_x	否	1.0	X 轴缩放比例
scale_y	否	1.0	Y 轴缩放比例
rotation	否	0.0	旋转角度
track_name	否	'subtitle'	目标轨道名称
width	否	1080	画布或素材宽度
height	否	1920	画布或素材高度

调用示例

curl -X POST https://your-domain.example/api/add_subtitle \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $VECTCUT_API_KEY" \
  -d '{
    "draft_id": "dfd_cat_demo_001",
    "srt": "1\n00:00:00,000 --> 00:00:02,000\n第一行字幕\n\n2\n00:00:02,000 --> 00:00:04,000\n第二行字幕",
    "font": "思源粗宋",
    "font_size": 5.0,
    "font_color": "#FFFFFF",
    "transform_y": -0.8
  }'

返回格式

{
  "success": true,
  "output": {
    "draft_id": "dfd_cat_demo_001",
    "draft_url": "https://your-domain.example/api/draft/downloader?draft_id=dfd_cat_demo_001"
  },
  "error": ""
}