Describe

You can use (Redacted Name) to describe an image that you upload and define.

POST

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

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/describe?authToken=<token>&url=<encodedUrl>

Request Body

url

The URL where the image is currently stored. This can be a URL to an image on the web, or a URL to an image on your server.

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 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({
  "url": "your-url",
  "ref": "",
  "webhookOverride": ""
});

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

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:

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

{
    "createdAt": "2023-04-04T13:07:01.927Z"
    "originatingMessageId": "your-message-id",
    "content": ["1️⃣ girl with pink hair wearing blue with red stars on her eyes, in the style of daz3d, ethereal cloudscapes, sailor moon manga style, the stars art group (xing xing), feminine body, loose forms, gentle color palette --ar 50:93",

    "2️⃣ senria starry eyed anime girl, in the style of michael page, subtle pastel hues, daz3d, james jean, white and pink, romanticized figures, colorful cartoon --ar 50:93",
    
    "3️⃣ a girl with blue hair and stars on her arms, in the style of light pink and light crimson, realistic hyper-detailed rendering, yanjun cheng, cartoon mis-en-scene, feminine body, dollcore, pseudo-realistic --ar 50:93",
    
    "4️⃣ a picture of a woman with pink and blue hair, in the style of hyperrealistic fantasy, sailor moon manga style, romanticized figures, the stars art group (xing xing), feminine body, texture exploration, tinycore --ar 50:93"
    ],
    "ref": "",
    "type": "describe",
    "responseAt": "2023-04-04T13:06:01.927Z"
}

femme, a beautiful torso girl with big cute chest with short skirt, starry colorful hair, thigh gaps, contrast, smirk, belly, thighs high, show abs, contrast, long render, pink, blue and white, simple background, gauche art, wes anderson, artstation masterpiece,painting by Dao Trong Le

The Next Leg