add_sticker

POST /add_sticker

接口说明

把选中的贴纸添加到草稿，并设置显示区间、位置、缩放、旋转、透明度和翻转。sticker_id 通常来自 search_sticker 的搜索结果。

请求参数

参数	必填	默认值	说明
sticker_id	是	—	贴纸 ID，通常来自 search_sticker
start	否	0	源素材开始时间，单位秒
end	否	5.0	源素材结束时间，单位秒
draft_id	是	—	草稿 ID，创建草稿后获得
transform_y	否	0	Y 轴位置偏移
transform_x	否	0	X 轴位置偏移
alpha	否	1.0	透明度，1.0 为不透明
flip_horizontal	否	False
flip_vertical	否	False
rotation	否	0.0	旋转角度
scale_x	否	1.0	X 轴缩放比例
scale_y	否	1.0	Y 轴缩放比例
track_name	否	'sticker_main'	目标轨道名称
relative_index	否	0	轨道叠加顺序
width	否	1080	画布或素材宽度
height	否	1920	画布或素材高度

调用示例

curl -X POST https://your-domain.example/api/add_sticker \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $VECTCUT_API_KEY" \
  -d '{
    "draft_id": "dfd_cat_demo_001",
    "sticker_id": "7050494369782123814",
    "start": 0,
    "end": 3,
    "scale_x": 0.8,
    "scale_y": 0.8,
    "transform_x": 0,
    "transform_y": 0.2
  }'

返回格式

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