API method

Upscaling Midjourney images via API

Updated November 4, 2026

upscale and upsample side by side

You will need upscale almost always anyway: Vary, Zoom, Pan, Inpaint and Animate only take the hash of an upscale task.

A small observation from our logs: the first picture of the grid is upscaled far more often than the others, 43% of the time against 17-20% for each of the other three. Probably because many integrations simply always take the first one. If you show the grid to people, let them pick.

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": 1,
  "webhook_url": "https://example.com/upscale/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": "a7d44910-88a6-4673-acc8-d60ffc3479a6",
  "hash": "2c8abb2d-5f4d-4c55-8830-102a4fe754ed",
  "choice": 3,
  "type": "upscale",
  "status": "done",
  "result": {
    "url": "https://cdn.discordapp.com/...039b7de3d18f.png",
    "proxy_url": "https://media.discordapp.net/...039b7de3d18f.png",
    "filename": "...039b7de3d18f.png",
    "content_type": "image/png",
    "width": 1024,
    "height": 1024,
    "size": 1512812
  },
  "status_reason": null,
  "created_at": "2006-01-02T15:04:05+00:00"
}

Upscale has no progress, the status goes straight to done or error. There is no account_hash in the request: an upscale can only run on the account that made the grid.

Example with cURL

1. Grid

curl -X POST https://api.userapi.ai/midjourney/v2/imagine \
  -H "Content-Type: application/json" \
  -H "api-key: $USERAPI_KEY" \
  -d '{"prompt": "a vintage camera on a wooden table --v 7"}'

2. U2

Once imagine is done:

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": 2}'

3. Upscale (Subtle) for a v7 image

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

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.

upsample

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

hash is a finished upscale. Which choice to send depends on the model version the picture was made with:

Other methods