add_text

POST /add_text

接口说明

向草稿添加一条文字或标题，支持字体、字号、颜色、透明度、描边、背景、阴影、位置、动画和分段样式。适合标题、说明、重点词和需要精确控制的单条文字。

请求参数

参数	必填	默认值	说明
`text`	是	—	文字内容
`start`	否	`0`	源素材开始时间，单位秒
`end`	否	`5`	源素材结束时间，单位秒
`draft_id`	是	—	草稿 ID，创建草稿后获得
`transform_y`	否	`0`	Y 轴位置偏移
`transform_x`	否	`0`	X 轴位置偏移
`font`	否	`'文轩体'`	字体名称；先查询 get_font_types
`color`	否	`data.get('font_color', '#FF0000')`	文字颜色
`size`	否	`data.get('font_size', 8.0)`	字号
`track_name`	否	`'text_main'`	目标轨道名称
`vertical`	否	`False`
`alpha`	否	`data.get('font_alpha', 1.0)`	透明度，1.0 为不透明
`bold`	否	`False`	是否加粗
`italic`	否	`False`	是否斜体
`underline`	否	`False`	是否下划线
`alignment`	否	`data.get('align', 'center')`	对齐方式
`outro_animation`	否	`None`	出场动画名称
`outro_duration`	否	`0.5`
`width`	否	`1080`	画布或素材宽度
`height`	否	`1920`	画布或素材高度
`fixed_width`	否	`-1`	固定宽度，-1 表示不限制
`fixed_height`	否	`-1`	固定高度，-1 表示不限制
`border_alpha`	否	`1.0`	描边透明度
`border_color`	否	`'#000000'`	描边颜色
`border_width`	否	`0.0`	描边宽度
`background_color`	否	`'#000000'`	背景颜色
`background_style`	否	`0`	背景样式
`background_alpha`	否	`0.0`	背景透明度
`background_round_radius`	否	`0.0`
`background_height`	否	`0.14`
`background_width`	否	`0.14`
`background_horizontal_offset`	否	`0.5`
`background_vertical_offset`	否	`0.5`
`shadow_enabled`	否	`False`	是否启用阴影
`shadow_alpha`	否	`0.9`	阴影透明度
`shadow_angle`	否	`-45.0`
`shadow_color`	否	`'#000000'`	阴影颜色
`shadow_distance`	否	`5.0`	阴影距离
`shadow_smoothing`	否	`0.15`	阴影平滑度
`bubble_effect_id`	是	—	气泡效果 ID
`bubble_resource_id`	是	—	气泡资源 ID
`effect_effect_id`	是	—	文字特效或花字 ID
`intro_animation`	是	—	入场动画名称
`intro_duration`	否	`0.5`
`text_styles`	否	`[]`	分段文字样式数组
`font_color`	否	`'#FF0000'`	文字颜色
`font_size`	否	`8.0`	字号
`font_alpha`	否	`1.0`	文字透明度
`align`	否	`'center'`	对齐方式
`line_spacing`	否	`0.25`	行间距
`letter_spacing`	否	`0.0`	字间距

调用示例

bash

curl -X POST https://your-domain.example/api/add_text \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $VECTCUT_API_KEY" \
  -d '{
    "draft_id": "dfd_cat_demo_001",
    "text": "今日推荐",
    "start": 0,
    "end": 5,
    "font": "CC_Captial",
    "font_size": 8.0,
    "font_color": "#FFFFFF",
    "intro_animation": "冲屏位移",
    "outro_animation": "右上弹出",
    "transform_x": 0,
    "transform_y": -0.8
  }'

返回格式

json

{
  "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": ""
}

add_text ​

接口说明 ​

请求参数 ​

调用示例 ​

返回格式 ​

add_text

接口说明

请求参数

调用示例

返回格式