Blend

The Blend API accepts two to five Base64-encoded images and creates an asynchronous image-blending task with the selected aspect ratio. Save the task ID from the response so that you can retrieve its progress and result.

POST/mj/submit/blend

Blend two to five images into a new asynchronous image task.

Authorization

bearerAuth

AuthorizationBearer <token>

Use Bearer your-api-key in the Authorization header.

In: header

Request Body

application/json

Blend task parameters. Each image must be Base64-encoded and include its MIME type prefix.

TypeScript Definitions

Use the request body type in TypeScript.

accountFilter?

Optional account filters.

notifyHook?string

Valid callback URL invoked when the task completes. Pass an empty string to use the platform-configured default callback URL.

state?string

Caller-provided state value used to correlate requests with callbacks.

botType?BotType

Bot type to use. MID_JOURNEY selects Midjourney, and NIJI_JOURNEY selects Niji Journey.

Default"MID_JOURNEY"

Value in

"MID_JOURNEY"
"NIJI_JOURNEY"

base64Array*array<string>

Two to five images to blend. Each image must use standard Base64 encoding, include a MIME type prefix, and be no larger than 4 MB.

Items2 <= items <= 5

dimensions?string

Output aspect ratio. PORTRAIT is 2:3, SQUARE is 1:1, LANDSCAPE is 3:2.

Value in

"PORTRAIT"
"SQUARE"
"LANDSCAPE"

Response Body

`application/json`

curl -X POST "https://example.com/mj/submit/blend" \  -H "Content-Type: application/json" \  -d '{    "botType": "MID_JOURNEY",    "base64Array": [      "data:image/png;base64,IMAGE_ONE_BASE64",      "data:image/png;base64,IMAGE_TWO_BASE64"    ],    "dimensions": "SQUARE",    "accountFilter": {      "channelId": "",      "instanceId": "",      "modes": [],      "remark": "",      "remix": true,      "remixAutoConsidered": true    },    "notifyHook": "",    "state": "request-002"  }'

{
  "code": 1,
  "description": "Submitted successfully",
  "properties": {},
  "result": 1320098173412546
}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`