name: jimeng-task-query description: 查询即梦AI生成任务状态,轮询获取图片/视频生成结果,支持所有即梦生成接口的结果查询。 version: 1.0.0
查询即梦AI生成任务的执行状态和结果,是所有即梦生成类skill的下游必备skill。
核心业务场景:
上游: 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
接口地址: https://server.fmode.cn/api/volcengine/jimeng/getDataByTask02
{
"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