---
name: jimeng-task-query
description: 查询即梦AI生成任务状态，轮询获取图片/视频生成结果，支持所有即梦生成接口的结果查询。
version: 1.0.0
author: nkkj-BrainHack
---

# jimeng-task-query

## 功能用途

查询即梦AI生成任务的执行状态和结果，是所有即梦生成类skill的下游必备skill。

**核心业务场景：**
- 轮询生成任务状态（提交任务后需等待生成完成）
- 获取生成结果（图片/视频URL，已转存永久有效）
- 支持所有即梦生成接口的结果查询

## 调用链（Workflow）

```
上游: jimeng-img-v4 / jimeng-text2img-v3 / 其他生成skill → 获得 workId
本步: jimeng-task-query(workId, routerName) → 轮询直到 isFinish=true
下游: jimeng-work-result(workId) → 获取 images/videos URL
```

## 入参规则

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| workId | string | ✅ (二选一) | ImagineWork数据id |
| taskId | string | ✅ (二选一) | 任务ID，与workId二选一 |
| routerName | string | ✅ | 对应接口名称（首次获取资源必填） |
| logo_info | object | ❌ | 水印信息 |
| logo_info.add_logo | boolean | ❌ | 是否添加水印，默认false |
| logo_info.position | integer | ❌ | 水印位置: 0右下/1左下/2左上/3右上 |
| logo_info.language | integer | ❌ | 0中文/1英文 |
| logo_info.opacity | float | ❌ | 不透明度[0,1]，默认1 |
| logo_info.logo_text_content | string | ❌ | 自定义水印文本 |
| token | string | ❌ | 认证token（已内置默认值，无需提供） |

**routerName 可选值：**
`getClothesV2`、`getImgByImg`、`getImgV4`、`getText2ImgV3`、`getText2ImgV31`、`getImg2ImgV3`、`getImgV4_pod`、`getImgV4_goods`、`getInpaint`、`getSuperResolution`、`getVideoV3_720p`、`getVideoV3_1080p`、`getVideoV3_Pro`、`getActor`、`getActorV2`

## 接口调用方式

- **请求方法**: POST
- **接口地址**: `https://server.fmode.cn/api/volcengine/jimeng/getDataByTask02`

```json
{
  "workId": "82CC78HNl6",
  "routerName": "getImgV4",
  "token": "Bearer r:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
```

## 关键响应字段

| 字段 | 业务用途 |
|------|---------|
| code | 200 表示成功 |
| data.tip | 状态提示文字（如"生成成功"） |
| data.isFinish | true表示任务完成，可查询ImagineWork表获取结果 |

## 轮询策略

建议每3-5秒轮询一次，直到 `data.isFinish === true`。图片生成通常10-30秒，视频生成可能需要1-5分钟。

## 获取最终结果

任务完成后，调用 **jimeng-work-result** skill（传入 workId）获取最终图片/视频 URL：
- `images`: 图片URL数组（永久有效）
- `videos`: 视频URL数组（永久有效）

## 依赖要求

- 接口地址: `https://server.fmode.cn/api/volcengine/jimeng/getDataByTask02`
- 需携带 token 参数（body 内传递）