query_script

POST /query_script

接口说明

读取草稿当前的 JSON 脚本，用于确认轨道、片段 ID、素材引用和编辑结果。大模型在添加蒙版、关键帧或美颜前，通常先用这个接口拿到真实的 segment_id，不要凭猜测填写。

请求参数

参数	必填	默认值	说明
draft_id	是	—	草稿 ID，创建草稿后获得
force_update	否	True	是否强制刷新素材元数据

调用示例

curl -X POST https://your-domain.example/api/query_script \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $VECTCUT_API_KEY" \
  -d '{
    "draft_id": "dfd_cat_demo_001",
    "force_update": false
  }'

返回格式

{
  "success": true,
  "output": "{\n  \"canvas_config\": {\"width\": 1080, \"height\": 1920, \"ratio\": \"original\"},\n  \"duration\": 0,\n  \"fps\": 30,\n  \"tracks\": [],\n  \"materials\": {\"videos\": [], \"audios\": [], \"texts\": []}\n}",
  "error": ""
}

output 本身是一个 JSON 字符串；调用方需要再解析一次，才能拿到草稿内部的 canvas_config、tracks、materials 等字段。

output 本身是一个 JSON 字符串；调用方需要再解析一次，才能拿到草稿内部的 canvas_config、tracks、materials 等字段。