API method

Zoom Out for Midjourney images via API

Updated November 4, 2026

Which button is which

Typical reasons: the subject is cut off by the frame, a banner needs empty space for text, or you want a series of shots where the camera keeps pulling back. Judging by our logs, the softer 1.5x is used more: almost two zooms out of three are 75.

Request

Base URL is https://api.userapi.ai. Every request needs two headers, api-key and Content-Type: application/json.

{
  "hash": "6794f6ef-866a-4bc3-b0bc-7b28ec010d1b",
  "choice": 50,
  "webhook_url": "https://example.com/zoom/webhook-url",
  "webhook_type": "result"
}

Parameters

What comes back

The response is just the task hash, e.g. {"hash": "ed162774-9244-4038-bdf1-801b033809ec"}. The finished task is what you later get from GET /midjourney/v2/status?hash=… or in the webhook:

{
  "account_hash": "f815cef1-49f2-4819-92c3-8be17d0b8514",
  "hash": "15061f02-c54b-41ca-a66a-49da2988d62b",
  "choice": 75,
  "type": "zoom",
  "progress": 100,
  "status": "done",
  "result": {
    "url": "https://cdn.discordapp.com/attachments/...8be17d0b8514.png",
    "proxy_url": "https://media.discordapp.net/attachments/...8be17d0b8514.png",
    "filename": "...8be17d0b8514.png",
    "content_type": "image/png",
    "width": 2048,
    "height": 2048,
    "size": 3354153
  },
  "status_reason": null,
  "created_at": "2023-10-26T09:06:27Z"
}

The result is again a grid of four. To zoom out further, upscale one of them and call zoom with its hash.

Example with cURL

1. Picture and upscale

curl -X POST https://api.userapi.ai/midjourney/v2/imagine \
  -H "Content-Type: application/json" \
  -H "api-key: $USERAPI_KEY" \
  -d '{"prompt": "a tiny cabin on a cliff, morning fog"}'

curl "https://api.userapi.ai/midjourney/v2/status?hash=IMAGINE_HASH" \
  -H "api-key: $USERAPI_KEY"

curl -X POST https://api.userapi.ai/midjourney/v2/upscale \
  -H "Content-Type: application/json" \
  -H "api-key: $USERAPI_KEY" \
  -d '{"hash": "IMAGINE_HASH", "choice": 1}'

2. Zoom Out 2x

curl -X POST https://api.userapi.ai/midjourney/v2/zoom \
  -H "Content-Type: application/json" \
  -H "api-key: $USERAPI_KEY" \
  -d '{"hash": "UPSCALE_HASH", "choice": 50}'

3. Or Custom Zoom with your own prompt

curl -X POST https://api.userapi.ai/midjourney/v2/zoom \
  -H "Content-Type: application/json" \
  -H "api-key: $USERAPI_KEY" \
  -d '{"hash": "UPSCALE_HASH", "prompt": "a tiny cabin on a cliff above a stormy sea --zoom 1.8"}'

Wrappers for Python, Node.js and PHP are on separate pages. If you'd rather not write code, the same methods are available in n8n and Make. This method in the documentation.

Other methods