即梦官方图片异步 API

本插件使用即梦视觉异步任务模式：提交任务取得 task_id，再以相同 req_key 查询结果。接口由火山引擎视觉服务的 AK/SK 签名体系保护，不是 Bearer 兼容接口。

接口与签名

逻辑操作名为 CVSync2AsyncSubmitTask 和 CVSync2AsyncGetResult。实际主机、Query 参数、Service/Region 与签名头由渠道的火山签名实现负责；不能只对这两个字符串执行普通 HTTP POST。

模型与 req_key

宿主模型 ID 映射为 req_key，必须与已开通的即梦能力完全一致。插件不提供可能过期的 req_key 白名单，也不根据名字推断文生图、图生图或版本能力。

参数与字段映射

当前实现发送 req_key、prompt，有参考图时发送 image_urls。extra 可覆盖 req_key、prompt、image_urls、seed、width、height。平台的 aspectRatio、quality、resolution 和 imageCount 没有自动转换。

创建请求正文

{
  "req_key":"YOUR_JIMENG_REQ_KEY",
  "prompt":"悬疑短剧分镜，楼道尽头的逆光人影",
  "image_urls":["https://example.com/reference.png"],
  "width":1536,
  "height":1024,
  "seed":42
}

创建响应至少需要可识别任务 ID：

{"data":{"task_id":"task_xxx"}}

轮询请求与结果

{"req_key":"YOUR_JIMENG_REQ_KEY","task_id":"task_xxx"}

轮询响应从顶层、task 或 data 读取状态，并按图片类型提取 images、image_url、imageUrl、result_url 或 url；图片数组可包含 URL 字符串或对象。若结果只出现在即梦其他专属嵌套字段中，需要补 fixture 和专属解析，不能把“拿到 completed”当作已经保存图片。

错误与排查

签名时间偏差、Region/Service 错误、req_key 未开通、素材不可下载、宽高不支持和内容审核都会导致失败。日志可以记录请求 ID 和错误码，不得记录 Secret Key、完整签名或私有素材 data URL。

2.2 KiB Raw Blame History Unescape Escape