---
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 调用）

## 返回格式
```json
{
  "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`）