Imagine

POST

https://api.thenextleg.io/v2/imagine

This is the starting point for creating your image generations

Request Body

msg

Your prompt. This can include an image URL as well. You can also include flags such as the --v 5 parameter

img2img Requests

In order to perform img2img requests, you can follow the following syntax in your imagine prompt:

"cmd":"<your-image-url> <your-prompt>"

Example:
"cmd":"https://cdn.midjourney.com/ab739450-7a9a-4c91-857e-60892adf60e7/0_1.webp Transformational anime"

ref (optional)

You can optionally pass ref in your command, that will be returned in the webhook response. You might want to do this to pass some simple metadata through to your webhook.

webhookOverride (optional)

You can optionally pass webhookOverride that will route your request to a different webhook.

Please note that if this is not configured correctly, you will not receive any response. If an image creation cannot be mapped back to it's original request, the webhook body will be routed to the default webhook.

var axios = require('axios');
var data = JSON.stringify({
  "msg": "<your-prompt-here>",
  "ref": "",
  "webhookOverride": ""
});

var config = {
  method: 'post',
  url: 'https://api.thenextleg.io/v2/imagine',
  headers: { 
    'Authorization': 'Bearer <your-token>', 
    'Content-Type': 'application/json'
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

HTTP Response

200Success

Your response will return a messageId. Store this somewhere so you can match it with what's received in your webhook.

{
  "success": true,
  "messageId": "your-message-id",
  "createdAt": "2023-04-04T13:07:01.927Z"
}

400Invalid Prompt

If you are using the banned word prefilter, you will receive a response 400 for any

{
"success": false,
"msg": "Invalid phrase: 'bad-word'"
}

New! Get your progress and retrieve a Message using GET

After receiving your messageId you can use the GET /v2/message/<messageId> in order to retrieve your progress and image.

See the GET /v2/message/<messageId> docs for more information.

Webhook URL Response

Your webhook URL will receive a response with the following:

buttons - A list of buttons you can use. If your slash command has produced an output that produces buttons/interactions, they will appear here
buttonRequestId - Which can be used in a POST /v2/button and in conjunction with button from the list
imageUrl - The URL for your image
originatingMessageId - The request ID from your original request
content - A string containing a response from Midjourney

🚧 Note: You should be aware that content will also return messages from Midjourney including:

Banned Prompt - You can't use this prompt
You've run out of fast hours... - Your tier doesn't have any fast GPU time
Job queued- You've made too many concurrent requests
Your current membership plan doesn't include Private mode!
Internal Server Error- Some Midjourney error
Invalid Parameter- An invalid flag command
You've ran out of fast hours

{
    "createdAt": "2023-04-04T13:07:01.927Z",
    "buttons": [
        "U1",
        "U2",
        "U3",
        "U4",
        "🔄",
        "V1",
        "V2",
        "V3",
        "V4"
    ],
    "imageUrl": "your-image-url",
    "buttonMessageId": "OtfxNzfMIKBPVE1aP4u4",
    "originatingMessageId": "your-message-id",
    "content": "your-original-prompt",
    "ref": "",
    "responseAt": "2023-04-04T13:06:01.927Z"
}

Multi - dimensional paper kirigami craft, paper illustration, Chinese illustration on white background, Night, starry sky, Milky Way, above super wide agle, Thomas Kinkade, dreamy, 4K, romantic, trending on Artstation colorful vanilla oil, 3d relief

The Next Leg