Skip to main content
POST
/
v1
/
blend
Blend Images
curl --request POST \
  --url https://api.legnext.ai/api/v1/blend \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "imgUrls": [
    "<string>"
  ],
  "aspect_ratio": "2:3",
  "callback": "<string>"
}
'
Turn multiple photos into a single unique creation using /blend

​
Endpoint

POST https://api.legnext.ai/api/v1/blend

​
Headers

HeaderTypeRequiredDescription
x-api-keystringYesYour API key

​
Request Body

ParameterTypeRequiredDescription
imgUrlsstring[]YesArray of 2-5 images to blend
aspect_ratiostringYesAspect ratio: 2:3, 1:1, or 3:2.
callbackstringNoCallback URL for task completion notifications

​
Example Request

curl -X POST "https://api.legnext.ai/api/v1/blend" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "imgUrls": [
      "https://example.com/image1.png",
      "https://example.com/image2.png"
    ],
    "aspect_ratio": "1:1",
    "callback": "https://webhook.site/your-webhook-id"
  }'

​
Response

Returns a task object containing the task information. 
{
    "job_id": "ea1aff8a-9c68-47b8-9693-9b10570a1910",
    "model": "midjourney",
    "task_type": "blend",
    "status": "completed",
    "config": {
        "service_mode": "public",
        "webhook_config": {
            "endpoint": "https://webhook.site/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
            "secret": ""
        }
    },
    "input": null,
    "output": {
        "image_url": "https://cdn.legnext.ai/temp/1760410892123.png",
        "image_urls": [
            "https://cdn.legnext.ai/mj/ea1aff8a-9c68-47b8-9693-9b10570a1910_0.png",
            "https://cdn.legnext.ai/mj/ea1aff8a-9c68-47b8-9693-9b10570a1910_1.png",
            "https://cdn.legnext.ai/mj/ea1aff8a-9c68-47b8-9693-9b10570a1910_2.png",
            "https://cdn.legnext.ai/mj/ea1aff8a-9c68-47b8-9693-9b10570a1910_3.png"
        ],
        "seed": "3891692909",
        "available_actions": {
            "edit": [
                0,
                1,
                2,
                3
            ],
            "inpaint": [
                0,
                1,
                2,
                3
            ],
            "outpaint": [
                0,
                1,
                2,
                3
            ],
            "pan": [
                0,
                1,
                2,
                3
            ],
            "remix": [
                0,
                1,
                2,
                3
            ],
            "reroll": true,
            "upscale": [
                0,
                1,
                2,
                3
            ],
            "variation": [
                0,
                1,
                2,
                3
            ]
        }
    },
    "meta": {
        "created_at": "2025-10-14T03:00:51Z",
        "started_at": "2025-10-14T03:00:52Z",
        "ended_at": "2025-10-14T03:01:46Z",
        "usage": {
            "type": "point",
            "frozen": 80,
            "consume": 80
        }
    },
    "detail": null,
    "logs": [],
    "error": {
        "code": 0,
        "raw_message": "",
        "message": "",
        "detail": null
    }
}

Authorizations

​
x-api-key
string
header
required

API key for authentication

Body

application/json
​
imgUrls
string<uri>[]
required

2-5 image URLs to blend

Required array length: 2 - 5 elements
​
aspect_ratio
enum<string>
required

Aspect ratio for the blended image

Available options:
2:3,
1:1,
3:2
​
callback
string<uri>

Callback URL for task completion notifications

Response

200

Blend task created successfully