Midjourney API 变体与放大

Midjourney 的变体、放大和扩图是基于原任务的新操作。不要复制图片界面的按钮名称或上游 customId；以本站任务响应的 actions 为准。

从结果选择操作

1. 查询已完成的图片任务，遍历 outputs 展示所有图片。
2. 找到对应图片可用的 actions，保留其中的 operation 和 output_index。
3. 将它们与本站 parent_task_id、原图片 model 一起估价，再提交到 /v1/image/generations。
4. 保存新的任务 ID，查询新结果。原任务不会被替换。

midjourney-image-variation.json

{
  "model": "midjourney-v7",
  "operation": "variation",
  "parent_task_id": "task_example",
  "output_index": 0
}

output_index 从 0 开始；它不是筛选、排序后的界面下标。output_1 对应原始下标 0。父任务必须属于当前用户且已经完成，不能填写上游任务 ID 或其他用户的任务。

变体、放大与提取的区别

操作	意义
variation / vary_subtle / vary_strong	创建变体或不同程度的重绘
upscale_subtle / upscale_creative	提交保守或创意放大任务
zoom_1_5 / zoom_2 / pan_*	向外或向指定方向扩展画面
select	获取已有单图，不是重新生成或高清放大
reroll	使用原设置重新生成

不是每个模型、阶段或图片都提供上述操作。有单张结果 URL 时不必再次调用 select。需要放大时，先确认实际返回了对应放大动作。

midjourney-image-upscale.json

{
  "model": "midjourney-v7",
  "operation": "upscale_subtle",
  "parent_task_id": "task_selected_image",
  "output_index": 0,
  "speed": "fast"
}

普通后续操作继承原提示词、种子及参考设置，不应重新发送 images、seed、stylize 等生成参数。custom_zoom 和 region 的例外字段与限制见完整操作契约；列出契约不代表完整编辑器已经开放。

图片转提示词

operation: "describe" 接收一张图片，成功后读取 descriptions[]。它输出多个候选文字描述，不是生成四张图片，也不保证候选数永远为四。

从中选择一个描述生成图片，需要另外发起 generate 并独立计费。客户端应支持 completed 且没有 outputs 的图转提示词任务。

费用与重试

变体、放大和扩图分别估价、提交，不应视作原任务的免费重试。对每个操作发送相同参数到 /v1/image/generations/estimate，不要用普通生图基础价代替操作报价。

提交超时后先核对已有任务；拿到任务 ID 后只查询该任务，不通过再次 POST 修复超时或下载失败。具体错误处理见常见问题。