快速开始

服务地址：https://your-domain.example/api

1. 准备请求头

所有接口都需要 API Key（/health 除外）：

export VECTCUT_API=https://your-domain.example/api
export VECTCUT_KEY=<你的 API Key>

2. 创建草稿

curl -s -X POST $VECTCUT_API/create_draft \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $VECTCUT_KEY" \
  -d '{"width":1080,"height":1920}'

返回里的 output.draft_id 就是后续所有操作的句柄，例如 dfd_cat_1791366350_543979b6。

3. 添加素材

素材只传 URL，服务端不会去下载：

curl -s -X POST $VECTCUT_API/add_image \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $VECTCUT_KEY" \
  -d '{
    "draft_id": "dfd_cat_xxx",
    "image_url": "https://example.com/a.png",
    "start": 0,
    "end": 3
  }'

音频、视频、文字、字幕、特效同理，参数见接口总览。

4. 导出草稿结构

curl -s -X POST $VECTCUT_API/export_draft \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $VECTCUT_KEY" \
  -d '{"draft_id":"dfd_cat_xxx"}'

返回两部分：

• files：草稿目录下的全部文件，文本直接给内容，二进制给 base64
• assets：需要下载的素材清单，每条含 url、name、type、placeholder

草稿文件里，素材路径此时是 __VECTCUT_ASSET_0001__ 这样的占位符。

5. 在本地生成草稿

用本地下载器填上 API 地址、API Key、草稿 ID，点一下就会：

1. 下载所有素材到草稿目录的 assets/ 下
2. 把占位符替换成绝对路径（图片还会回填真实宽高）
3. 写入剪映草稿目录

重启剪映，草稿列表里就能看到并直接编辑。

也可以只拿 zip

如果只想在别的机器上手工处理，用 save_draft 让服务端打包：

curl -s -X POST $VECTCUT_API/save_draft \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $VECTCUT_KEY" \
  -d '{"draft_id":"dfd_cat_xxx"}'

返回的 draft_url 指向 https://your-domain.example/api/draft/downloader?draft_id=...，可直接下载 zip。打包完成后服务器会删掉草稿目录，只留压缩包。