add_beauty

POST /add_beauty

接口说明

给视频片段添加美颜、美型、美妆或美体。接口写入剪映真实美化素材 ID，打开剪映后仍可在人像面板继续调整；支持多个视频片段分别处理。

给视频片段添加美颜、美型、美妆或美体。接口把剪映真实素材 ID 写入草稿，打开剪映后仍可在人像面板中调整。

请求参数

参数	类型	必填	说明
draft_id	string	是	草稿 ID
segment_ids	string[]	否	目标视频片段 ID 列表；省略时使用草稿中唯一的视频片段
skin	object	否	美颜组
shape	object	否	美型组
makeup	object	否	美妆组
body	object	否	美体组

所有滑杆范围都是 0-100，传 0 或省略表示不写入。

skin

支持：even、plump、smooth、dewrinkle、bright_eye、dark_circle、whitening、white_teeth。

肤色预设使用 skin_tone，支持 冷白、暖白，并可用 temperature（0-99）和 intensity（0-100）调节。

shape

支持：small_face、slim、v_shape、jaw、cheekbone、shorten、contour_smooth、lower、middle、upper、hairline。

makeup

look 使用剪映中文妆容名，例如 淡人妆、裸妆、原生、初恋。intensity 默认 80，face_id 默认 -1 表示全部人脸。

body

支持：small_head、swan_neck、slim_arm、straight_shoulder、slim_body、slim_waist、long_leg、plump_breast、slim_hip、smooth、whitening。

请求示例

curl -X POST https://your-domain.example/api/add_beauty \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $VECTCUT_API_KEY" \
  -d '{
    "draft_id": "dfd_cat_demo_001",
    "segment_ids": ["a1b2c3d4e5f6"],
    "skin": {
      "smooth": 50,
      "whitening": 30,
      "skin_tone": "冷白",
      "temperature": 11,
      "intensity": 60
    },
    "shape": {
      "small_face": 20,
      "slim": 30
    },
    "makeup": {
      "look": "淡人妆",
      "intensity": 80
    },
    "body": {
      "slim_waist": 30
    }
  }'

返回示例

{
  "success": true,
  "output": {
    "draft_id": "dfd_cat_demo_001",
    "draft_url": "https://your-domain.example/api/draft/downloader?draft_id=dfd_cat_demo_001",
    "affected_segments": ["a1b2c3d4e5f6"],
    "figure_ids": ["f001", "f002", "f003"]
  },
  "error": ""
}

figure_ids 包含写入的美化素材 ID；任意美化参数生效时还会补一条 makeup-root。