openclaw-voc-skill/dist/skills/quickly-video-query/SKILL.md

---

name: quickly-video-query description: 轮询查询一键成片任务的视频生成结果，返回视频URL/封面URL/时长列表

version: 1.1.0

一键成片 — 结果查询 (Quickly Video Query)

技能目的

轮询查询 quickly-video-create 提交的视频生成任务结果。Quickly AI 异步生成视频（通常 2~5 分钟），本 Skill 通过云函数定时查询直至获取结果。

调用链（Workflow）

前置: quickly-video-create(materials) → task_id
  ↓
本步: quickly-video-query(task_id) → 轮询（每15秒×最多40次）
  ↓
成功: 返回 videoUrl / coverUrl / videoDuration 给用户
失败: 超时10分钟无结果 → 提示用户检查素材
  ↓
可选: quickly-video-library → 查看历史视频库

输入参数

参数	类型	必填	说明
taskId	string	✅	quickly-video-create 返回的 data.task_id

执行流程

1. 接收上游 quickly-video-create 返回的 task_id

2. 调用云函数查询视频结果：

   POST https://server.fmode.cn/api/functions
   Content-Type: application/json
   Body: { "id": "sWvRr8RvPT", "_ApplicationId": "ncloudmaster", "action": "query", "taskId": "<task_id>" }
   

3. 判断结果：

   • data 非空 → 视频生成完成，返回结果
   • data 为空数组 → 仍在生成，等待15秒后重复步骤2

4. 达到40次仍无结果 → 判定为生成失败，提示用户

轮询策略

参数	值
轮询间隔	15 秒
最大次数	40 次（约10分钟）
成功条件	data.length > 0
超时处理	提示用户检查素材质量和URL可达性

调用的底层 Skill

• 无（本 Skill 为原子级查询，被 quickly-video-create 在 Step 5 调用）

返回格式

{
  "code": 200,
  "success": true,
  "data": [
    {
      "objectId": "xBtdUG9gTv",
      "taskId": "2039371716671352832",
      "preId": "1775059079891",
      "coverUrl": "https://img.kuaizi.co/video/.../cover.jpg",
      "videoUrl": "https://img.kuaizi.co/video/.../video.mp4",
      "videoName": "客厅隔断推拉门新选择",
      "videoDuration": 15.2,
      "status": "success",
      "createdAt": "2026-04-01T15:59:20.241Z"
    }
  ]
}

ℹ️ 云函数只返回 status='success' 的记录。空数组 = 仍在生成或生成失败。

核心业务场景

• 商家「一键成片」等待视频生成（前端轮询 + 加载动画）
• Agent 工作流：create 后自动轮询，获取视频 URL 后返回给用户
• 批量任务监控：多个 task_id 并行轮询

依赖

• Parse 云函数 sWvRr8RvPT（部署在 server.fmode.cn）