Skip to content

query_draft_status ​

POST /query_draft_status

接口说明 ​

查询保存或导出任务当前的状态、进度和结果。适合在调用 save_draft 或 export_draft 后轮询,避免界面一直等待。任务完成后即可读取输出地址或继续下一步处理。

请求参数 ​

参数必填默认值说明
task_id是—异步任务 ID

调用示例 ​

bash
curl -X POST https://your-domain.example/api/query_draft_status \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $VECTCUT_API_KEY" \
  -d '{
    "task_id": "dfd_cat_demo_001"
  }'

返回格式 ​

json
{
  "success": true,
  "output": {
    "status": "completed",
    "message": "Draft creation completed",
    "progress": 100,
    "completed_files": 3,
    "total_files": 3,
    "draft_url": "https://your-domain.example/api/draft/downloader?draft_id=dfd_cat_demo_001"
  },
  "error": ""
}

个人自建服务