Midjourney
Inpaint(局部重绘)
局部重绘入口(等价 Vary (Region)),提交后进 MODAL,需再调 modal 上传 mask + prompt
POST
Vary (Region))。提交后任务进 MODAL 状态,需再调 modal 上传 mask + prompt 才能完成。
| 项目 | 内容 |
|---|---|
| action | INPAINT |
| 计费 | midjourney@inpaint[-version][-speed] |
| 必填 | task_id,或 task_id + custom_id |
| 可选 | index、speed、metadata |
参数
| 字段 | 说明 |
|---|---|
task_id | 原任务 ID(一般为 Upscale 后的单图任务) |
custom_id | 可选,直接指定 Vary (Region) 对应操作的按钮 ID |
index | 可选,选父任务第几张(1–4,默认 1);单图通常不用动 |
speed | relax / fast / turbo |
metadata | 可选 |
自动匹配
服务端从原任务buttons 中匹配 Vary (Region)。
请求示例
后续流程
提交成功后返回status: "modal"——这是合法非终态,不是错误。请用 modal 接口继续:其中 task_id 为上一步 inpaint 返回的本地任务 ID,并提交 prompt 以及可选 mask_url。
注意
- 父任务必须是 SUCCESS 的 upscale 单图;四宫格直接 inpaint 会报错,需先
upscale。 - 进入 MODAL 后 30 分钟内必须调 modal 补参,否则后台自动 CANCEL + 退款。
- 来源任务的版本 metadata 会自动继承;如需区分速度价格,可配置
midjourney@inpaint-fast/midjourney@inpaint-turbo。