POST/blend4 creditsMidjourney only

Blend

Merge 2–5 images together using Midjourney's blend algorithm, which combines their visual concepts, styles, colors, and compositions into a new 2×2 grid. Great for combining a style reference with a subject image, merging character designs, or building hybrid aesthetics. Unlike /imagine with --sref, blend gives equal weight to all input images as compositional sources, not just style influences. Midjourney only.

Request Parameters

Parameter	Type	Required	Description
image_urls	`string[]`	Required	Array of 2-5 publicly accessible image URLs to blend together.
dimension	`string`	Optional	Output aspect ratio.Default: `square` `squareportraitlandscape`
webhook_url	`string`	Optional	URL where we POST the completed task result.
webhook_secret	`string`	Optional	Sent as x-webhook-secret header in webhook delivery.

Example Request

cURL

curl -X POST https://api.journeyapi.com/api/v1/blend \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_urls": [
      "https://example.com/photo1.jpg",
      "https://example.com/photo2.jpg",
      "https://example.com/photo3.jpg"
    ],
    "dimension": "landscape",
    "webhook_url": "https://your-server.com/webhook"
  }'

Immediate Response

Returns immediately with a task ID. Use /fetch or webhooks to get the result.

200 OK

{
  "task_id": "ee9h7d99-h18k-30m3-j605-335544339999"
}

Response Fields

Field	Type	Description
task_id	`string`	UUID of the blend task.
task_type	`string`	Always "blend".
original_image_url	`string`	URL of the blended 2×2 grid.
image_urls	`string[]`	Array of 4 individual image URLs.

Tips

1Blend works best with images that share a similar color palette or theme.
2Images are downloaded and converted to base64 server-side. Ensure they are publicly accessible.
3Use dimension to control the output shape — useful for specific social media formats.

Quirks & Gotchas

Minimum 2, maximum 5 images. Passing 1 or 6+ will return a 400 error.

Images must be JPEG or PNG. Other formats may fail silently.

All images are fetched server-side, so latency depends on how fast the source URLs respond.

Expert Tips & Best Practices

Style reference + subject image blending

A powerful technique: blend a painting or artwork (style) with a photograph (subject). The result inherits the artistic style from the artwork and the subject/composition from the photo. For more literal blends (less Midjourney interpretation), add --style raw in a text prompt — but blend doesn't accept text prompts directly, so use /imagine with --sref + the image as image_url instead when you need text guidance.

Aspect ratio matching tip

Blend works best when all input images share the same aspect ratio. Midjourney will process mismatched ratios, but cropping or padding artifacts can appear. Before blending, crop your input images to the same ratio and specify the matching dimension (square/portrait/landscape) in the request.

Related Endpoints

POST/imagine