Button Commands

API Endpoint: https://api.thenextleg.io/api

After receiving a response at your webhook URL, if buttons are available, you can subsequently press a button, following Midjourneys practice. This may include buttons such as upscale (U1, U2, U3, U4), variations (V1, V2, V3, V4, 🔄) and others.

Request

Params

The current button commands we support are:

button

Send in any button seen in your previous response. You'll need to include the emoji and label exactly as received in your Webhook URL response from a previous request.

buttonMessageId

The buttonMessageId received in your Webhook URL response from a previous request.

ref (optional)

You can optionally pass ref in your command - which can be used useful when using webhooks

webhookOverride (optional)

You can optionally pass webhookOverride that will route a response to a webhook of your choosing.

Please note that using a webhook is completely optional. You are welcome to use the GET Message endpoint to retrieve responses.

var axios = require('axios');
var data = JSON.stringify({
  "button": "🔄",
  "buttonMessageId": "your-buttonMessageId",
  "ref": "",
  "webhookOverride": ""
});

var config = {
  method: 'post',
  url: 'https://api.thenextleg.io/api',
  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

Your response will return an initial messageId. The main purpose is to let you know your message has been received.

The response to the actual request (imagine or other) will be returned in your Webhook URL.

📘This is not an actual response to your original request. Your webhook URL will receive a message with a response to the original prompt.

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

Completed Response

Your webhook URL will receive a response with the following:

buttons - Which can be used in your next request invoke. If your slash command has produced an output that produces buttons/interactions, they will appear here
buttonRequestId - Which can be used in a Button Command in conjunction with a button
imageUrl - The URL for your image
originatingMessageId - The request ID from your original request
content - A string containing a response from the (Redacted Name) bot

🚧 Note: You should be aware that content will also return messages from (Redacted Name) including:

ALREADY_REQUESTED_UPSCALE

You've already requested an upscale for this image

BOT_TOOK_TOO_LONG_TO_PROCESS_YOUR_COMMAND

(Redacted Name) Bot took too long to process your command

APPEAL_ACCEPTED

Your appeal has been accepted

APPEAL_REJECTED

Your appeal has been rejected

BANNED_PROMPT

You can't use this prompt

BLOCKED

This message has been blocked

BUTTON_NOT_FOUND

Button not found

FAILED_TO_PROCESS_YOUR_COMMAND

(Redacted Name) failed to process your command

FAILED_TO_REQUEST

Failed to request

IMAGE_BLOCKED

This image has been blocked

INTERNAL_ERROR

(Redacted Name) had an internal error

INVALID_LINK

Invalid link

INVALID_PARAMETER

Invalid parameter

JOB_ACTION_RESTRICTED

Job action restricted

JOB_QUEUED

Job queued

MODERATION_OUTAGE

There is a content moderator outage

NO_FAST_HOURS

You've ran out of fast hours

PLEASE_SUBSCRIBE_TO_MJ_IN_YOUR_DASHBOARD

You're not subscribed to (Redacted Name)

QUEUE_FULL

Queue full

{
    "createdAt": {
        "_nanoseconds": 215000000,
        "_seconds": 1678840347
    },
    "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"
}

Wide view, behind the scenes, Ayutthaya large robot workshop, extra large, Fuji film, hyper-realism from 1970s Thai sci-fi movies, steam-powered aerial robot workshop army, maintenance soldiers.

The Next Leg