Midjourney
Zoom(缩放扩展)
对已 upscale 的单图执行 Zoom Out 扩图,原图保留向外补背景(Outpaint / CustomZoom)
POST
zoom_ratio < 2 走 Outpaint(1.5×),≥ 2 或未传走 CustomZoom(2×),两者均直接出图。
| 项目 | 内容 |
|---|---|
| action | ZOOM |
| 计费 | midjourney@zoom[-speed] |
| 必填 | task_id,或 task_id + custom_id |
| 可选 | zoom_ratio、index、speed、metadata |
参数
| 字段 | 说明 |
|---|---|
task_id | 本平台返回的任务 ID(须为 Upscale 后的单图任务) |
custom_id | 可选,直接指定 Zoom 对应操作的按钮 ID |
index | 可选,选父任务第几张(1–4,默认 1);单图通常不用动 |
zoom_ratio | 可选,决定自动匹配的 Zoom Out 档位(见下表) |
speed | relax / fast / turbo |
metadata | 可选 |
自动匹配
zoom_ratio | 匹配按钮 |
|---|---|
小于 2 | Zoom Out 1.5x |
未传或 >= 2 | Zoom Out 2x |
请求示例
注意
- 父任务必须是已 upscale 的单图且为 SUCCESS;传四宫格会返回
This action requires an upscaled task...,需先调用upscale。 - Outpaint / CustomZoom 均直接出图,无需 mask,不进 MODAL(只有 Inpaint 走 MODAL)。
- 来源任务的版本 metadata 会自动继承;如需区分速度价格,可配置
midjourney@zoom-fast/midjourney@zoom-turbo。
返回
提交成功返回新的本地task_id,请轮询 GET /v1/tasks/{task_id} 查询结果。