Skip to main content
POST
/
v1
/
midjourney
/
generations
/
zoom
curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/zoom \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "task_01KQW0D3WJ2QYJP9E3H7GZ4D2R",
    "zoom_ratio": 1.5,
    "speed": "fast"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/zoom \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "task_01KQW0D3WJ2QYJP9E3H7GZ4D2R",
    "zoom_ratio": 1.5,
    "speed": "fast"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
Zoom out (outpaint) on a single image after Upscale: the original is kept and more background is filled outward. zoom_ratio < 2 uses Outpaint (1.5×); ≥ 2 or omitted uses CustomZoom (2×); both produce an image directly.
ItemValue
actionZOOM
Billingmidjourney@zoom[-speed]
Requiredtask_id, or task_id + custom_id
Optionalzoom_ratio, index, speed, metadata

​
Parameters

FieldDescription
task_idTask ID returned by this platform (must be an Upscale single-image task)
custom_idOptional; button ID for the corresponding Zoom action
indexOptional; which image of the parent task (1–4, default 1); usually unnecessary for a single image
zoom_ratioOptional; controls which Zoom Out tier is auto-matched (see table below)
speedrelax / fast / turbo
metadataOptional custom metadata

​
Auto matching

zoom_ratioButton
Less than 2Zoom Out 1.5x
Omitted or >= 2Zoom Out 2x

​
Request example

{
  "task_id": "task_01KQW0D3WJ2QYJP9E3H7GZ4D2R",
  "zoom_ratio": 1.5,
  "speed": "fast"
}

​
Notes

  • The parent task must be an upscaled single image and SUCCESS; passing a grid returns This action requires an upscaled task..., so call upscale first.
  • Both Outpaint and CustomZoom produce an image directly, need no mask, and do not enter MODAL (only Inpaint uses MODAL).
  • Version metadata from the source task is inherited automatically. To price by speed, configure midjourney@zoom-fast / midjourney@zoom-turbo.

​
Response

On success you receive a new local task_id. Poll GET /v1/tasks/{task_id} for the result.