SKILL.md 2.8 KB


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 可选值: getClothesV2getImgByImggetImgV4getText2ImgV3getText2ImgV31getImg2ImgV3getImgV4_podgetImgV4_goodsgetInpaintgetSuperResolutiongetVideoV3_720pgetVideoV3_1080pgetVideoV3_ProgetActorgetActorV2

接口调用方式

  • 请求方法: POST
  • 接口地址: 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
  • 需携带 token 参数(body 内传递)