API method

Midjourney blend via API

Updated November 4, 2026

When it comes in handy

• A product photo plus a picture whose style or background you want.
• Two characters, or a character and a place, when describing them in words doesn't work well.
• Getting your own images into Midjourney so you can then upscale, vary, zoom or animate them.

Request

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

{
  "urls": [
    { "url": "https://example.com/image1.jpg", "ext": "jpg" },
    { "url": "https://example.com/image2.png", "ext": "png" }
  ],
  "webhook_url": "https://example.com/blend/webhook-url",
  "webhook_type": "result",
  "account_hash": "a7d44910-88a6-4673-acc8-d60ffc3479a6"
}

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": "3b2c7341-ec22-0301-810d-9cf0543e20ba",
  "hash": "fd88479e-455f-6a6f-6284-b0c49117d76f",
  "urls": [
    { "url": "https://example.com/image1.jpg", "ext": "jpg" },
    { "url": "https://example.com/image2.jpg", "ext": "jpg" }
  ],
  "type": "blend",
  "status": "done",
  "result": {
    "url": "https://cdn.discordapp.com/...6a65992f3587.png",
    "proxy_url": "https://media.discordapp.net/...6a65992f3587.png",
    "filename": "...-6a65992f3587.png",
    "content_type": "image/png",
    "width": 2048,
    "height": 2048,
    "size": 2145293
  },
  "status_reason": null
}

You get a grid of four, just like from imagine. The blend hash can go straight into upscale or variation with choice 1-4.

Example with cURL

1. Two images in

curl -X POST https://api.userapi.ai/midjourney/v2/blend \
  -H "Content-Type: application/json" \
  -H "api-key: $USERAPI_KEY" \
  -d '{"urls": [{"url": "https://example.com/product.png", "ext": "png"}, {"url": "https://example.com/style.jpg", "ext": "jpg"}]}'

2. Wait for the grid

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

3. Upscale the one you like

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

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