Button Commands

A completed image will return an array of buttons which you can subsequently invoke on the image. These buttons are dynamic and a list of buttons you can press are included in every image completion. This may include buttons such as upscale (U1, U2, U3, U4), variations (V1, V2, V3, V4, 🔄), zoom, pan and more. .

POST

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

Users have requested using GET requests with the Auth Token. You can pass any arguments in the POST request as encoded URI query parameters.

GET

https://api.thenextleg.io/v2/button?authToken=<token>&buttonMessageId=<id>&button=<button>

Request Body

buttonMessageId

Use the buttonMessageId returned in your webhook URL

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.

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.

Custom Zoom Options

prompt (optional)

Include a prompt in your request body to alter the original prompt.

zoom (optional)

When using Custom Zoom as a button, you will need to pass in a value between 1 and 2 for custom zoom

ar (optional)

When using Custom Zoom as a button you can choose to add in an aspect ratio parameter such as 1:1

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

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

200Success

Your response will return a messageId. Use the messageId at the GET Message endpoint to poll for results, or to you can wait for the result to arrive via webhook.

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

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.

Completed Response

The message you receive by using the GET Message endpoint or received via your webhook, will have 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

imageUrls/Upscales

Instantly Upscaled Image URLS

originatingMessageId

The message ID from your original request

content

A string containing a response from (Redacted Name)

type

The type of message you are receiving

🚧 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"
    ],
    "type": "button",
    "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