Skip to main content
POST
/
v1
/
midjourney
/
generations
/
blend
curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/blend \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "image_urls": [
      "https://example.com/a.png",
      "https://example.com/b.png"
    ],
    "dimensions": "SQUARE",
    "speed": "fast"
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/blend \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "image_urls": [
      "https://example.com/a.png",
      "https://example.com/b.png"
    ],
    "dimensions": "SQUARE",
    "speed": "fast"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
Blend 2–4 images into a new image (the classic MJ blend feature). It works purely from images and does not accept a prompt.
ItemValue
actionBLEND
Billingmidjourney@blend[-speed]
Requiredimage_urls (2–4 images)

​
Parameters

FieldTypeRequiredDefaultNotes
image_urlsstring[]Yes—Source images, 2–4; auto-converted to base64; each ≤ 12 MiB
dimensionsstringNoSQUAREThree aspect presets: SQUARE (1:1) / PORTRAIT (2:3) / LANDSCAPE (3:2); overridden when size is set
sizestringNo—Free aspect ratio, any w:h (e.g. "16:9", "9:16", "21:9"); takes priority over dimensions, applied as the aspect ratio
speedstringNorelaxrelax / fast / turbo
metadataobjectNo—Custom metadata

​
Request examples

Preset aspect (dimensions): 
{
  "image_urls": [
    "https://example.com/a.png",
    "https://example.com/b.png"
  ],
  "dimensions": "SQUARE",
  "speed": "fast"
}
Free aspect (size): 
{
  "image_urls": [
    "https://example.com/a.png",
    "https://example.com/b.png"
  ],
  "size": "16:9",
  "speed": "fast"
}
The final prompt ends with --ar 16:9.

​
Notes

  • Aspect priority: size (free) > dimensions (presets) > default SQUARE.
  • Fewer than 2 or more than 4 image_urls returns 400.
  • blend has no independent version parameter. To price by speed, configure midjourney@blend-fast / midjourney@blend-turbo.