Seed Retrieval

This is nearly the same as the buttons interface, but as a button you send in '✉️' as the button. This will return a response containing seed.


Request Body


Use the buttonMessageId returned in your webhook URL


Send in ✉️ as the button.

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.

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 var axios = require('axios'); var data = JSON.stringify({ "button": "✉️", "buttonMessageId": "your-buttonMessageId", "ref": "", "webhookOverride": "" }); var config = { method: 'post', url: '', headers: { 'Authorization': 'Bearer <your-token>', 'Content-Type': 'application/json' }, data : data }; axios(config) .then(function (response) { console.log(JSON.stringify(; }) .catch(function (error) { console.log(error); });


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.

0 1 2 3 4 { "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:
The seed used in the image generation.
A list of buttons you can use. If your slash command has produced an output that produces buttons/interactions, they will appear here
Which can be used in a POST /v2/button and in conjunction with button from the list
The URL for your image
Instantly Upscaled Image URLS
The message ID from your original request
A string containing a response from (Redacted Name)
The type of message you are receiving
0 1 2 3 4 5 { "seed": "1317396497", "content": "your-original-prompt", "ref": "", "responseAt": "2023-04-04T13:06:01.927Z" }
An awesome individual
An awesome individual