Forem: useapi.net

Create breath-taking videos with PixVerse AI

useapi.net — Sun, 09 Jun 2024 06:19:23 +0000

Introduction

In this article we will show hot to use an experimental API for the PixVerse Discord Bot by PixVerse.AI to generate videos. PixVerse currently supports text and image inputs for generating 4-second-long videos. The available video styles include Realistic, Anime, and 3D Animation. For the Anime style you can reference one of the anime characters. PixVerse can also create a meme face video from a provided image.

Examples

/animate

Source image

/meme_face

Source image

A girl smiling by the beach, sunset in the background

/create_single

A cinematic shot of a tiny hedgehog dressed in a complete astronaut suit, floating in the vastness of outer space. The hedgehog is repairing a small satellite with tiny tools. The Earth shines in the distance, and stars and constellations illuminate the dark cosmic background. Nearby, a futuristic spaceship with another animal peeking from a window completes the cosmic scene

/create

A front view, head to toe, beautiful female model walking the runway. Emphasis is on the Great Gatsby inspired evening gown in the style of John Galliano

A women silhouette dancing provocative with flashing strobe lights flashing with laser beams

A girl smiling in a magic redwood forest

Setup

We will use the experimental API provided by useapi.net to interact with Midjourney, InsightFaceSwap, Pika and PixVerse Discord bots.

Useapi.net

You need a monthly subscription to use the useapi.net experimental APIs mentioned in this article.
Follow these steps to get started.

PixVerse

The PixVerse Discord bot is currently free, please follow these simple steps to obtain the following:

Discord server ID number, referred to in this article as server.
Discord channel ID number, referred to in this article as channel.
Discord token, referred to in this article as discord. Verify Discord access.
Once you have all the above, please create or update your PixVerse account information so that you no longer need to provide them with every API call.

Useapi.net provides an easy way to experiment with all API endpoints without writing any code. Check the Try It section at the end of each document page, such as PixVerse's /create, /animate, or /meme_face.

For your convenience, we have published all the source code used in this article. You can choose between JavaScript and Python examples. Clone this repository locally and use it as a starting point for your experiments.

Ngrok

Follow official instructions to sign up for an ngrok account and copy your ngrok authtoken from your ngrok dashboard.

Preparing PixVerse prompts

An array of desired prompts should be saved to a locally cloned prompts.json file.

Executing prompts using PixVerse experimental API by useapi.net

Create a file locally in the same folder named example.sh with the following content:

JavaScript

USEAPI_TOKEN="useapi API token" NGROK_AUTHTOKEN="ngrok authtoken" node ./example.js

Python

USEAPI_TOKEN="useapi API token" NGROK_AUTHTOKEN="ngrok authtoken" python3 ./example.py

Execute it from the command line like this: ./example.sh and observe the magic of the experimental API.

The generated videos will be saved locally. You may proceed with the generation process within a Discord channel to further refine your creations. Alternatively, you can continue automate the process by using the /button API endpoint.

Conclusion

Visit our Discord Server or Telegram Channel for any support questions and concerns.

We regularly post guides and tutorials on the YouTube Channel.

Discord CDN Proxy

useapi.net — Mon, 13 May 2024 21:44:20 +0000

Host your images and videos on Discord CDN

Suppose you want to take advantage of the free Discord CDN to host your images or videos. With the simple script below, you can upload your assets to a desired Discord channel:

curl -X POST "https://discord.com/api/v10/channels/<Discord channel>/messages" \
-H "Authorization: <Discord token>" \
-F 'payload_json={"content":"Here is your file!","attachments":[{"id":0,"filename":"<file name>"}]}' \
-F 'files[0]=@<path to file name>'

Example:

curl -X POST "https://discord.com/api/v10/channels/123456789/messages" \
-H "Authorization: ABc.your.discord.token.xYZ" \
-F 'payload_json={"content":"Here is your file!","attachments":[{"id":0,"filename":"source.jpg"}]}' \
-F 'files[0]=@./source.jpg'

Please refer to our guide on how to obtain your Discord token and set up a private channel. Omit the Midjourney setup steps if you do not plan to use it.

Response JSON will contain attachments[0].url with Discord CDN attachment link.

Create a Proxy for Discord CDN

Starting December 2023 all Discord CDN attachment links have following format: https://cdn.discordapp.com/attachments/channel/message/filename.ext?ex=EXPIRES&is=ISSUED&hm=CODE

Query parameters values EXPIRES and ISSUED are timestamps in unix/epoch hex format, CODE is encoded checksum used to verify EXPIRES and ISSUED values.

Attempt to retrieve Discord CDN attachments URL without above query parameters or with EXPIRES past current time will result in 404 This content is no longer available. response, see example.

In practical terms this means that you can no longer link attachments from Discord on your website, share them on Reddit, Facebook.

This article provides you with effective solution to continue sharing your Discord CDN content publicly without incurring any costs.

The Discord CND proxy especially handy for users of Midjourney API, Pika API or InsightFaceSwap API.

Once your public proxy deployed you can use public image links using https://your-discord-cdn-proxy-url/?https://cdn.discordapp.com/attachments/channel/message/filename.ext format.

These links can be shared publicly, published on your website, etc.

The proxy will refresh the links provided after the ? and redirect the browser to the refreshed Discord CDN link.

You can include original Discord attachment link query parameters as well ?ex=EXPIRES&is=ISSUED&hm=CODE, the proxy will check if the link has expired, and may return the original URL immediately if it is not expired.

When responding with HTTP 302 the proxy will set response headers Expires with link expiration time.

Custom response header x-discord-cdn-proxy will be set to one of following values:

original - provided link query parameters ?ex=EXPIRES&is=ISSUED&hm=CODE indicate that link is still "fresh"
refreshed - call to https://discord.com/api/v9/attachments/refresh-urls Discord API was made to retrieve refreshed link
memory - refreshed link returned from the memory cache
bucket - refreshed link returned from the R2 bucket cache (optional for Cloudflare Worker deployment)

Diagram

Original Discord CDN link open (404: This content is no longer available.)
Discord CDN link using proxy open
Discord CDN link using proxy (without query parameters) open

Two deployment options covered in the article:

Google App Engine instructions.
- F1 instance is free to run 24/7/365 link.
- Google asks for a credit card or other payment method when you sign up for the Free Trial/Free Tier link.
Cloudflare Worker instructions.
- 100K requests per day are included in the free tier account link.
- Cloudflare does not require the entering of payment information.

You can choose either option based on your preferences.

The source code for Google App Engine is a standard Node.js Express server.

You can deploy it in any compatible environment, see the instructions below:

Deploy Google App Engine

Assuming you have Google Cloud account and installed gcloud CLI.

Clone git repository discord-cdn-proxy.

Navigate to ./google-app-engine folder and install npm packages:

npm install

You can follow along the official Google App Engine deployment steps for Node.js.

gcloud auth login

Create new project:

gcloud projects create discord-cdn-proxy

Select created project:

gcloud config set project discord-cdn-proxy

Find created project on your Google Cloud Dashboard and link billing account to the project.

Create App Engine project:

gcloud app create

Create .env.yaml file with following yaml:

env_variables:
  DISCORD_TOKEN: "discord token"
  CHANNELS: "['channel id', 'another channel id', 'channel id etc']"

How to extract discord token.

Optional array CHANNELS defines which Discord channels should be proxied.

You can remove it but it is strongly not recommended for public proxies.

Deploy App Engine project:

gcloud app deploy

You may have to run the above command a few times, as it often fails on the first run.

Notice the name of the deployed service, which will look like:
Deployed service [default] to [https://discord-cdn-proxy.it.r.appspot.com]

Update .env.yaml file and add DISCORD_CDN_PROXY_URL with value from deployed service:

env_variables:
  DISCORD_TOKEN: "discord token"
  CHANNELS: "['channel id', 'another channel id', 'channel id etc']"
  DISCORD_CDN_PROXY_URL: "https://discord-cdn-proxy.it.r.appspot.com"

Deploy App Engine project with updated configuration:

gcloud app deploy

Now you can test deployed proxy.

Example (adjust to include actual values): https://discord-cdn-proxy.it.r.appspot.com/?https://cdn.discordapp.com/attachments/channel/message/filename.ext

Debugging locally

Update DISCORD_TOKEN value in your package.json file:

{
  "name": "discord-cdn-proxy",
  "version": "1.0.0",
  "description": "Discord CDN proxy",
  "main": "server.js",
  "type": "module",
  "scripts": {
    "start": "node server.js",
    "debug": "DISCORD_TOKEN='discord token' DISCORD_CDN_PROXY_URL='http://localhost:8090/' node server.js"
  },
  "author": "useapi.net",
  "license": "ISC",
  "dependencies": {
    "express": "^4.19.2"
  }
}

Execute script with npm:

npm run debug

Deploy Cloudflare Worker

Assuming you have free Cloudflare account setup completed and installed Wrangler CLI.

Clone git repository discord-cdn-proxy.

Navigate to ./cloudflare-web-worker folder and install npm packages:

npm install

If you are familiar with Cloudflare Workers, you can adjust the deployment configuration in the wrangler.toml file.

You can fine-tune it later at any time once you have acquired some initial experience.

Deploy Worker:

wrangler deploy --keep-vars

Notice deployment url which will look like https://discord-cdn-proxy.your-user-name.workers.dev

You can use that url to test by adding Discord link at the end after ?

Example: https://your-discord-cdn-proxy-url/?https://cdn.discordapp.com/attachments/channel/message/filename.ext

Create .secrets file with following JSON:

{
    "DISCORD_TOKEN": "discord token",
    "CHANNELS": "['channel id', 'another channel id', 'channel id etc']"
}

How to extract discord token.

Optional array CHANNELS defines which Discord channels should be proxied.

You can remove it but it is strongly not recommended for public proxies.

Deploy secrets from local file .secrets:

wrangler secret:bulk .secrets

Now you can test deployed proxy.

Example (adjust to include actual values): https://your-discord-cdn-proxy-url/?https://cdn.discordapp.com/attachments/channel/message/filename.ext

Debugging locally

Create .dev.vars file with following text:

DISCORD_TOKEN="discord token"
CHANNELS=["channel id", "another channel id", "channel id etc"]

Run local development using .dev.var secrets:

wrangler dev

Refreshing Discord links using an R2 bucket for caching

This allows you to store refreshed Discord links in a Cloudflare R2 bucket to minimize the number of calls to the Discord API.

To create an R2 bucket, execute:

wrangler r2 bucket create discord-cdn-proxy-cache
wrangler r2 bucket list

Uncomment r2_buckets configuration in wrangler.toml file.

Redeploy Worker:

wrangler deploy --keep-vars

Conclusion

Visit our Discord Server or Telegram Channel for any support questions and concerns.

We regularly post guides and tutorials on the YouTube Channel.

Check our GitHub repo with code examples.

Face swap and animate images generated by Midjourney using InsightFaceSwap and Pika

useapi.net — Mon, 26 Feb 2024 02:50:16 +0000

Introduction

This article covers multiple experimental APIs provided by useapi.net.

You will learn how you can easily generate and upscale images from your prompt(s) using Midjourney, apply face swap via InsightFaceSwap, and finally animate the result using Pika.

First, we will be generating images using the /imagine command from Midjourney and upscaling them with the /button command using the experimental Midjorney API.

Next, we will use the InsightFaceSwap Discord Bot by Picsi.Ai using the experimental InsightFaceSwap API to swap faces on the upscaled images mentioned above.

Finally, animation provided by the Pika Discord Bot will be applied to the face swapped images via the experimental Pika API.

Please check out the 👉 YouTube video 👈 showcasing the final results of these generations from this article.

This article explains how to use a webhook to retrieve generated results and how to structure a basic query to submit requests to the API. This approach is much more performant and consumes fewer resources.

Setup

We will use the experimental API provided by useapi.net to interact with Midjourney, InsightFaceSwap and Pika Discord bots.

Useapi.net

You need a monthly subscription to use the useapi.net experimental APIs mentioned in this article.
Follow these steps to get started.

Midjourney

Naturally you'll need a Discord account with an active Midjourney subscription. The $10 Basic Plan will suffice.

Follow these simple steps to obtain the following:

Discord server ID number, referred to in this article as server.
Discord channel ID number, referred to in this article as channel.
Discord token, referred to in this article as discord. Verify Discord access.
Once you have all the above, please create or update your Midjourney account information so that you no longer need to provide them with every API call.

InsightFaceSwap

The InsightFaceSwap setup is similar to Midjourney's, please follow our instructions.

InsightFaceSwap allows users to swap faces from source images onto different target images. It offers free and paid subscriptions. Paid subscribers have access to a wide selection of extra features, such as HiFidelity Mode, ARTIFY, oldify/youngify, morphing multiple faces in one image, and many more.

You can add the InsightFaceSwap Discord bot to the same server and channel as the Midjourney bot to speed up and simplify the setup process. If you're planning to use the free plan, you may want to consider setting up multiple Discord/InsightFaceSwap accounts so that you can execute more operations daily, since one account alone may not suffice.

Pika

The Pika Discord bot is currently free. The setup process is very similar to the ones above. Please refer to the Pika setup steps. Since you have already retrieved your Discord token during the Midjourney setup, you only need to identify the channel for Pika Direct Messages.

Useapi.net provides an easy way to experiment with all API endpoints without writing any code. Check the Try It section at the end of each document page, such as Midjourney's jobs/imagine, InsightFaceSwap's faceswap/swap, or Pika's pika/animate.

Ngrok

Follow official instructions to sign up for an ngrok account and copy your ngrok authtoken from your ngrok dashboard.

Preparing Midjourney Prompts

Let's use ChatGPT to create a list of prompts. Here's our ChatGPT prompt:

Create a simple JSON array of strings containing Midjourney prompts to generate the world's most renowned portrait paintings.

The output will look something like this:

[
  "Portrait of a Young Man by Raphael",
  "Salvator Mundi by Leonardo da Vinci",
  …
  "Mona Lisa (La Gioconda) by Leonardo da Vinci"
]

An array of prompts generated by ChatGPT needs to be saved to a locally cloned prompts.json file.

Executing Prompts Using the Midjourney, InsightFaceSwap and Pika experimental API by useapi.net

Create a file locally in the same folder named example.sh with the following content:

JavaScript

USEAPI_TOKEN="useapi API token" NGROK_AUTHTOKEN="ngrok authtoken" node ./example.js

Python

USEAPI_TOKEN="useapi API token" NGROK_AUTHTOKEN="ngrok authtoken" python3 ./example.py

Examples

Upscaled image generated by Midjourney.
Face swapped image generated by InsightFaceSwap from upscaled image above.
Video generated from face swapped image above using text + image animation by Pika.

We used Rick Astley as a source image for face swapping, feel free to change it per your liking.

Conclusion

Visit our Discord Server or Telegram Channel for any support questions and concerns.

We regularly post guides and tutorials on the YouTube Channel.

Execute it from the command line like this: ./example.sh and observe the magic of the experimental API.

The generated images and videos will be saved locally. You may proceed with the generation process within a Discord channel to further refine your creations. Alternatively, you can continue automate the process by using the jobs/button along with Pika or perhaps InsightFaceSwap, following the same process as demonstrated above.

Examples

Upscaled image generated by Midjourney.

Face swapped image generated by InsightFaceSwap from upscaled image above.

Video generated from face swapped image above using text + image animation by Pika.

We used Rick Astley as a source image for face swapping, feel free to change it per your liking.

Conclusion

Visit our Discord Server or Telegram Channel for any support questions and concerns.

We regularly post guides and tutorials on the YouTube Channel.

Automating Asset Generation with the Midjourney API • Part I

useapi.net — Sun, 12 Nov 2023 05:12:39 +0000

Introduction

If you are a designer, a game developer, or simply experimenting with Midjourney and want to create a large number of /imagine generations based on your ideas, it may be very tedious and time-consuming to do so manually.

In this article, we will explore methods to efficiently execute such tasks with minimal effort.

We will also attempt to measure the time it takes to generate 50 Midjourney /imagine generations and compare it with the time reported by Midjourney for their Fast GPU.

Please check a YouTube video covering this article.

Setup

We will use the Midjourney API provided by useapi.net to interact with Midjourney.

To get started, you'll need a Discord account with an active Midjourney subscription. The $10 Basic Plan will suffice.

Follow these simple steps to obtain the following:

Discord server id number, referred to in this article as server.
Discord channel id number, referred to in this article as channel.
Discord token, referred to in this article as discord. Verify Discord access.
useapi.net API token, referred to in this article as token. Verify useapi.net API access.

Useapi.net provides an easy way to experiment with all API endpoints without writing any code. Check the Try It section at the end of each document page, such as jobs/imagine.

For your convenience, we have published all the code used in this article. You can choose between JavaScript and Python examples. Clone this repository locally and use it as a starting point for your experiments.

Preparing Midjourney Prompts

Let's use ChatGPT to create a list of prompts. For this article, we will be generating fairy tale characters. Here's our ChatGPT prompt:

Create a JSON array of strings with 50 Midjourney prompts. Each prompt should describe a popular fairy tale protagonist or antagonist placed in the modern world, solving contemporary problems using fairy tale methods. Be creative!

The output will look something like this:

[
    "Cinderella, now a well-known fashion designer, uses her knack for transforming rags into fabulous outfits to help those in poverty dress for success.",
    "Jack, of Jack and the Beanstalk fame, is a successful botanist who tackles the issue of world hunger by growing gigantic, genetically modified crops.",
    "Rapunzel, a professional rock climber, uses her long-braided hair for safety ropes during rescue missions in difficult terrains.",
    ...
    "The Big Bad Wolf, a top-notch security consultant, fortifies homes against break-ins, teaching the importance of strong construction materials."
]

An array of prompts generated by ChatGPT needs to be saved to a locally cloned prompts.json file.

Executing Prompts Using the Midjourney API

Create a file locally in the same folder named example.sh with the following content:

JavaScript

USEAPI_TOKEN="useapi API token" USEAPI_SERVER="Discord server" USEAPI_CHANNEL="Discord channel" USEAPI_DISCORD="Discord token" node ./example.js

Python

USEAPI_TOKEN="useapi API token" USEAPI_SERVER="Discord server" USEAPI_CHANNEL="Discord channel" USEAPI_DISCORD="Discord token" python3 ./example.py

Execute it from the command line like this: ./example.sh and observe the magic of the API. We have created a YouTube video covering this entire process.

The generated images will be saved locally. You can continue the generation process in a Discord channel to refine your desired creations, or you can use the jobs/button to automate it, following the same process as demonstrated above.

Conclusion

As shown in the YouTube video, you can observe the following:

Time to generate 50 Midjourney /imagine creations using the Midjourney API: ~19 minutes
Utilization of the Midjourney Fast GPU: ~26 minutes

Visit our Discord Server for any support questions and concerns.

We regularly post guides and tutorials on the YouTube Channel.

Interact with Midjourney using Discord API • Part II

useapi.net — Mon, 16 Oct 2023 01:49:29 +0000

Introduction

This article builds upon Part I and covers Discord rate limits and the Midjourney moderation system, two of the most intricate topics. We've provided working code for your convenience.

Before we proceed, make sure you have a Discord account with an active Midjourney subscription. The $10 Basic Plan will suffice.

Follow these simple steps to obtain:

Discord server id number, referenced in this article as server_id
Discord channel id number, referenced in this article as channel_id
Discord token, referenced in this article as discord_token

Discord rate limits

Discord's original documentation suggests using response headers to detect cases where the rate limit is exceeded and adjust accordingly. While this approach is appropriate for complex or commercial applications, we'll opt for a simpler yet equally efficient method for this article.

We'll introduce a 350-millisecond pause (sleep) before each Discord API call. Since our code operates with a single thread, this will be sufficient to remain comfortably under the limit. Moreover, our small program's overall performance will not be impacted, as Midjourney's response time consistently exceeds the proposed 350 milliseconds.

Midjourney moderation system

Midjourney performs both pre- and post-moderation of /imagine command prompts, and you'll need a reliable way to detect both.

When you execute a POST request for an imagine interaction with your prompt in a Discord channel (as covered in Part I), you'll encounter seven possible cases:

1 Happy path

After a few seconds, the posted message will appear in the channel with the original message id, indicating its status as (Waiting to start) in the content field and with the type field set to 0.

GET https://discord.com/api/v10/channels/channel_id/messages

[
 {
  "id": "<Discord original message id>",
  "type": 0,
  "content": "**Wonders of the World…** - <@Discord user id> (Waiting to start)",
  "channel_id": "<Discord channel id>",

Once Midjourney completes the generation, the original message will be deleted, and a final message with a new id containing the generation results will be posted by Midjourney.

GET https://discord.com/api/v10/channels/channel_id/messages

[
 {
  "id": "<Discord final message id>",
  "type": 0,
  "content": "**Wonders of the World…** - <@Discord user id> (fast)",
  "channel_id": "<Discord channel id>",

2 Pre-moderation

This is the most straightforward case: the posted message will never appear in the channel. You will see something like this.

Messages marked "Only you can see this" can be retrieved by Discord Gateway API¹

3 Post-moderation

The post will appear in the channel just like in the "Happy path" case.

GET https://discord.com/api/v10/channels/channel_id/messages

[
 {
  "id": "<Discord original message id>",
  "type": 0,
  "content": "**Beautiful lady swimming in the pool…** - <@Discord user id> (Waiting to start)",
  "channel_id": "<Discord channel id>",

Generation may even start, and you will see the progress, but suddenly it will stop with a message similar to the one below.

GET https://discord.com/api/v10/channels/channel_id/messages

[
 {
  "id": "<Discord original message id>",
  "type": 0,
  "content": "**Beautiful lady swimming in the pool…** - <@Discord user id> (Stopped)",
  "channel_id": "<Discord channel id>",

4 Ephemeral moderation

Certain words in your prompt trigger "soft moderation". Generation starts and completes successfully, but after completion, the message will display "Original message was deleted". The message is no longer returned by the GET https://discord.com/api/v10/channels/channel_id/messages endpoint, even though it was initially present. For a better understanding, refer to the sequence below.

GET https://discord.com/api/v10/channels/channel_id/messages

[
 {
  "id": "<Discord original message id>",
  "type": 0,
  "content": "**Irresistibly beautiful woman, pinup…** - <@Discord user id> (Waiting to start)",
  "channel_id": "<Discord channel id>",

Generated message deleted.

Messages marked "Only you can see this" can be retrieved by Discord Gateway API¹

5 Invalid request

This occurs when you specify an incorrect parameter. Like the "Pre-moderation" case, the posted message will not appear in the channel. It's advisable to include code for checking the prompt syntax before posting. We plan to cover the topic of prompt syntax verification in one of our follow-up articles.

Messages marked "Only you can see this" can be retrieved by Discord Gateway API¹

6 Job queued

Depending on your Midjourney Subscription Plan, you can have anywhere from 3 (Basic & Standard) to 15 (Pro & Mega) concurrent job executions. Once this limit is reached, job requests will be queued, and messages associated with these jobs will not immediately appear in the GET https://discord.com/api/v10/channels/channel_id/messages until Midjourney has completed one of the executing jobs. This essentially means that the job has been placed into Midjourney's internal query.

Messages marked "Only you can see this" can be retrieved by Discord Gateway API¹

You generally want to minimize encountering the "Job queued" status, as there is substantial evidence that Midjourney may throttle your generation requests in such cases and use it as an indicator of a Midjourney ToS violation (...may not use automated tools to access, interact with, or generate Assets through the Services...).

7 Queue full

Midjourney job queue can hold up to 10 jobs, after that you will get "Queue full" message. You will have to wait and try again.

Messages marked "Only you can see this" can be retrieved by Discord Gateway API¹

You generally want to minimize encountering the "Queue full" status, as there is substantial evidence that Midjourney may throttle your generation requests in such cases and use it as an indicator of a Midjourney ToS violation (...may not use automated tools to access, interact with, or generate Assets through the Services...).

Discord REST API (HTTPS) vs Discord Gateway API (WebSocket)

As you noticed in the previous paragraph, certain messages ¹ can still be retrieved using the Discord Gateway API. Unlike the Discord REST API we're using in this article, the Discord Gateway API requires the use of WebSocket API to facilitate real-time communication between your client application and the Discord server. This adds another level of complexity and, more importantly, may increase the chances of getting banned.

In the vast majority of cases, you can build your logic without the use of the Discord Gateway API. We plan to cover corner cases where the use of the Discord Gateway API is the only feasible solution in later articles.

Midjourney /imagine generation logic

Taking into account what we learned from the previous paragraphs, we can implement the following simple strategy:

Ensure there is at least one available concurrent job slot. To achieve this, you can either use a separate Midjourney account for all your automation work or carefully manage the number of manually initiated jobs, keeping them to a maximum of two. This approach will help avoid encountering both "Job queued" and "Queue full" cases.
Before posting an image prompt, execute a GET request to https://discord.com/api/v10/channels/channel_id/messages to retrieve the id of the very first record. By default, this endpoint returns the 50 most recent messages from the channel, sorted in descending order, with the most recent message listed first.
After posting the image prompt using a POST request to https://discord.com/api/v10/interactions, continuously check the channel every 3 to 5 seconds by making a GET request to https://discord.com/api/v10/channels/channel_id/messages. Compare the id of the very first record with the value obtained in the previous step. If, after 30 seconds, you do not see a new record in the channel, you can assume you are either dealing with a "Pre-moderation" or "Invalid request" case, and your prompt may require revision.
Once you have determined that a new message has indeed appeared in your channel, save the id of this message. Continue calling GET requests to https://discord.com/api/v10/channels/channel_id/messages every 20 to 30 seconds to check for the following remaining cases:

Happy path: when the generation is completed, the message with the original id is no longer present in the channel. Instead, a new message is present with a non-empty components array. You can obtain the generated image from the attachments[0].url field.
Post-moderation: when the message with the original id is still present, and its content field ends with (Stopped).
Ephemeral moderation: when the id of the very first record matches the value obtained before posting the image prompt.

Working JavaScript code

// bash
// USEAPI_DISCORD="..." USEAPI_SERVER="..." USEAPI_CHANNEL="..." node index.js

// Node 18+

const imagine_prompt = "Hologram cat in neon lights";

const discordAPI = `https://discord.com/api/v10`;
const MidjourneyAppId = `936929561302675456`;

// Load Discord settings from environment 
const discord = process.env.USEAPI_DISCORD ?? 'Discord token';
const server = process.env.USEAPI_SERVER ?? 'Discord server id number';
const channel = process.env.USEAPI_CHANNEL ?? 'Discord channel id number';

console.info({ discord, server, channel, imagine_prompt });

const sleep = (ms = 0) => new Promise(resolve => setTimeout(resolve, ms));

const DiscordHeaders = (token) => ({
    "Content-Type": "application/json",
    "Authorization": `${token}`,
});

// https://discord.com/developers/docs/resources/channel#get-channel-messages
const GetDiscordChannelMessages = async (discord, channel) => {
    const response = await fetch(
        `${discordAPI}/channels/${channel}/messages`,
        { headers: DiscordHeaders(discord) });

    return response;
}

// Midjourney Imagine https://discord.com/api/v10/channels/channel_id/application-commands/search?type=1&include_applications=true&query=imagine
const PostDiscordImagine = async (discord, server, channel, prompt) => {
    const data = {
        "type": 2,
        "application_id": MidjourneyAppId,
        "guild_id": server,
        "channel_id": channel,
        "session_id": (new Date()).getTime(),
        "data": {
            "version": "1118961510123847772",
            "id": "938956540159881230",
            "name": "imagine",
            "type": 1,
            "options": [
                {
                    "type": 3,
                    "name": "prompt",
                    "value": prompt
                }
            ],
            "application_command": {
                "id": "938956540159881230",
                "application_id": MidjourneyAppId,
                "version": "1118961510123847772",
                "default_permission": true,
                "default_member_permissions": null,
                "type": 1,
                "nsfw": false,
                "name": "imagine",
                "description": "Create images with Midjourney",
                "dm_permission": true,
                "options": [
                    {
                        "type": 3,
                        "name": "prompt",
                        "description": "The prompt to imagine",
                        "required": true
                    }
                ]
            },
            "attachments": []
        }
    };

    const response = await fetch(`${discordAPI}/interactions`, {
        method: "POST",
        body: JSON.stringify(data),
        headers: DiscordHeaders(discord)
    });

    return response;
}

const demo = async () => {
    const getBeforeMessages = await GetDiscordChannelMessages(discord, channel);

    if (getBeforeMessages.status !== 200) {
        console.error(`Discord /messages status ${getBeforeMessages.status}`, await getBeforeMessages.json());
        process.exit(1);
    }

    const beforeMessages = await getBeforeMessages.json();

    const beforeIds = new Set();
    beforeMessages.forEach(msg => beforeIds.add(msg.id));

    await sleep(350);

    const postImagine = await PostDiscordImagine(discord, server, channel, imagine_prompt);

    if (postImagine.status != 204) {
        console.error(`Discord /interactions status ${postImagine.status}`, await postImagine.json());
        process.exit(1);
    }

    const maxPostedAttempts = 10;

    let attempt = 1;
    let postedMessage;

    // Check for message to appear in the channel for 20 seconds total 
    do {
        await sleep(2000);

        const getMessages = await GetDiscordChannelMessages(discord, channel);

        if (getMessages.status !== 200) {
            console.error(`Discord /messages status ${getMessages.status}`, await getMessages.body());
            process.exit(1);
        }

        const messages = await getMessages.json();

        // New (Waiting to start) imagine interaction
        postedMessage = messages.find(msg => !beforeIds.has(msg.id));

        if (postedMessage) {
            console.log(`Found new message ${postedMessage.id}`, postedMessage.content);
            break;
        }

        attempt++;

    } while (attempt <= maxPostedAttempts);

    if (postedMessage === undefined) {
        console.error(`Posted message not found due to moderation or an invalid prompt`);
        process.exit(1);
    }

    const termStopped = `> (Stopped)`;
    const maxGeneratedAttempts = 60;

    attempt = 1;

    let generatedMessage;

    // Check for posted message to appear in the channel with new id for 10 minutes max
    do {
        // Wait for 10 seconds before checking on message progress
        await sleep(10000);

        const getMessages = await GetDiscordChannelMessages(discord, channel);

        if (getMessages.status !== 200) {
            console.error(`Discord /messages status ${getMessages.status}`, await getMessages.body());
            process.exit(1);
        }

        const messages = await getMessages.json();

        const progress = messages.find(message =>
            message.id == postedMessage.id &&
            // Not completed 
            !message.components?.length &&
            // Not stopped 
            !message.content.endsWith(termStopped));
        if (progress) {
            console.log(`#${attempt} ${progress.id} progress`, progress.content);
        } else {
            const completed = messages.find(message =>
                !beforeIds.has(message.id) &&
                message.id !== postedMessage.id &&
                // Either completed or stopped
                (!!message.components?.length || message.content.endsWith(termStopped))
            );

            generatedMessage = (completed && !!completed.components?.length) ? completed : undefined;

            break;
        }

        attempt++;

    } while (attempt <= maxGeneratedAttempts);

    if (generatedMessage === undefined) {
        console.error(`Message not found due to post-moderation or ephemeral moderation`);
        process.exit(1);
    }

    // Successful generation
    console.info(`Completed`, generatedMessage.content);
    console.info(`Download URL`, generatedMessage.attachments[0].url);
}

demo();

Subscribe to stay informed.

Please visit https://useapi.net to learn more about Midjourney API

Interact with Midjourney using Discord API • Part I

useapi.net — Thu, 14 Sep 2023 15:29:27 +0000

This practical guide shows you how to create basic automation using Midjourney /imagine command as an example.

For this exercise, you’ll need Discord account with active Midjourney subscription, $10 Basic Plan will do just fine.

Follow these simple steps to obtain:

Discord server id number, referenced in this article as server_id
Discord channel id number, referenced in this article as channel_id
Discord token, referenced in this article as discord_token

We will be using listed below Discord API public endpoints:

Application Commands to get Midjourney imagine command details and post imagine interaction to desired Discord channel
Get Channel Messages to retrieve imagine interaction(s) results (messages) from Discord channel

Please feel free to use public Postman collection referencing Discord API mentioned in this article. Make sure to place your values into collection variables and save them before executing GET and POST collection calls:

Discord API authorization

All Discord API calls mentioned here require HTTP Authorization header with discord_token, example:



Authorization: discord_token

Retrieve imagine Discord interaction details

Execute application-commands GET request https://discord.com/api/v10/channels/channel_id/application-commands/search?type=1&include_applications=true&query=imagine

Response body:



{
    "applications": [
        {
            "id": "936929561302675456",
            "name": "Midjourney Bot",
            "icon": "f6ce562a6b4979c4b1cbc5b436d3be76",
            "description": "Generate an image based on a text prompt in under 60 seconds using the </imagine:938956540159881230> command!\n\nhttps://docs.midjourney.com/docs/terms-of-service",
            "summary": "",
            "type": null,
            "bot": {
                "id": "936929561302675456",
                "username": "Midjourney Bot",
                "global_name": null,
                "avatar": "f6ce562a6b4979c4b1cbc5b436d3be76",
                "discriminator": "9282",
                "public_flags": 589824,
                "bot": true,
                "avatar_decoration_data": null
            }
        }
    ],
    "application_commands": [
        {
            "id": "938956540159881230",
            "application_id": "936929561302675456",
            "version": "1118961510123847772",
            "default_member_permissions": null,
            "type": 1,
            "nsfw": false,
            "name": "imagine",
            "description": "Create images with Midjourney",
            "dm_permission": true,
            "contexts": [
                0,
                1,
                2
            ],
            "integration_types": [
                0
            ],
            "options": [
                {
                    "type": 3,
                    "name": "prompt",
                    "description": "The prompt to imagine",
                    "required": true
                }
            ]
        }
    ],
    "cursor": {
        "previous": "WzExNTE1NDQ4NzM4MjA4OTMzMDYsIDAsIDkzODk1NjU0MDE1OTg4MTIzMF0=",
        "next": null,
        "repaired": false
    }
}

We will need application_commands[0] object which has imagine command details, let’s extract it for future references:



        {
            "id": "938956540159881230",
            "application_id": "936929561302675456",
            "version": "1118961510123847772",
            "default_member_permissions": null,
            "type": 1,
            "nsfw": false,
            "name": "imagine",
            "description": "Create images with Midjourney",
            "dm_permission": true,
            "contexts": [
                0,
                1,
                2
            ],
            "integration_types": [
                0
            ],
            "options": [
                {
                    "type": 3,
                    "name": "prompt",
                    "description": "The prompt to imagine",
                    "required": true
                }
            ]
        }

Compose and execute imagine interaction to desired Discord channel

Execute interactions POST request https://discord.com/api/v10/interactions

Request payload:



{
    "type": 2,
    "application_id": "936929561302675456",
    "guild_id": "server_id",
    "channel_id": "channel_id",
    "session_id": "random integer number",
    "data": {
        "version": "1118961510123847772",
        "id": "938956540159881230",
        "name": "imagine",
        "type": 1,
        "options": [
            {
                "type": 3,
                "name": "prompt",
                "value": "YOUR MIDJOURNEY PROMPT GOES HERE"
            }
        ],
        "application_command": {
            "id": "938956540159881230",
            "application_id": "936929561302675456",
            "version": "1118961510123847772",
            "default_member_permissions": null,
            "type": 1,
            "nsfw": false,
            "name": "imagine",
            "description": "Create images with Midjourney",
            "dm_permission": true,
            "contexts": [
                0,
                1,
                2
            ],
            "integration_types": [
                0
            ],
            "options": [
                {
                    "type": 3,
                    "name": "prompt",
                    "description": "The prompt to imagine",
                    "required": true
                }
            ]
        },
        "attachments": []
    }
}

Fields application_id and application_command should be set to values extracted in step above.
Place your Midjourney prompt into data.options[0].value field.
session_id can be just any random integer number, if you using linked above Postman collection this value will be autogenerated by Postman.

HTTP Response Status should be 204 No Content, any other response status indicate problem with your payload.

Finally retrieve imagine command results

Execute messages GET request
https://discord.com/api/v10/channels/channel_id/messages

Response body (redacted for brevity):



[
    {
        "id": "<Discord message id>",
        "type": 0,
        "content": "**YOUR MIDJOURNEY PROMPT GOES HERE --s 750 --v 5.2** - <@.Discord user id> (fast)",
        "channel_id": "<Discord channel id>",
        "attachments": [
          {
              "url": "<generated image url>",
              "proxy_url": "<generated proxy image url>",
              "width": 2048,
              "height": 2048,
              "content_type": "<generated image type>",
              "id": "<Discord image id>",
              "filename": "<generated image name>",
              "size": 7204115
          }
        ],
        "components": [
            {
                "type": 1,
                "components": [
                    {
                        "type": 2,
                        "custom_id": "MJ::JOB::upsample::1::45e9bf62-5f3d-4bd6-a567-958af28f15d3",
                        "style": 2,
                        "label": "U1"
                    },
                    {
                        "type": 2,
                        "custom_id": "MJ::JOB::upsample::2::45e9bf62-5f3d-4bd6-a567-958af28f15d3",
                        "style": 2,
                        "label": "U2"
                    },
                    {
                        "type": 2,
                        "custom_id": "MJ::JOB::upsample::3::45e9bf62-5f3d-4bd6-a567-958af28f15d3",
                        "style": 2,
                        "label": "U3"
                    },
                    {
                        "type": 2,
                        "custom_id": "MJ::JOB::upsample::4::45e9bf62-5f3d-4bd6-a567-958af28f15d3",
                        "style": 2,
                        "label": "U4"
                    },
                    {
                        "type": 2,
                        "custom_id": "MJ::JOB::reroll::0::45e9bf62-5f3d-4bd6-a567-958af28f15d3::SOLO",
                        "style": 2,
                        "emoji": {
                            "name": "🔄"
                        }
                    }
                ]
            },
            {
                "type": 1,
                "components": [
                    {
                        "type": 2,
                        "custom_id": "MJ::JOB::variation::1::45e9bf62-5f3d-4bd6-a567-958af28f15d3",
                        "style": 2,
                        "label": "V1"
                    },
                    {
                        "type": 2,
                        "custom_id": "MJ::JOB::variation::2::45e9bf62-5f3d-4bd6-a567-958af28f15d3",
                        "style": 2,
                        "label": "V2"
                    },
                    {
                        "type": 2,
                        "custom_id": "MJ::JOB::variation::3::45e9bf62-5f3d-4bd6-a567-958af28f15d3",
                        "style": 2,
                        "label": "V3"
                    },
                    {
                        "type": 2,
                        "custom_id": "MJ::JOB::variation::4::45e9bf62-5f3d-4bd6-a567-958af28f15d3",
                        "style": 2,
                        "label": "V4"
                    }
                ]
            }
        ],
    },
]

The Discord endpoint for messages returns the top 50 messages from channel_id, with the most recent returned first. Depending on Midjourney settings and servers load, it can take anywhere from approximately 20 seconds (fast mode) to 10 minutes (relax mode) to generate an image.

You can execute the above call in the loop with 10…20 secs delay between calls until components array is not empty. Then extract the generated image from attachments[0].url field.

In our next article, we will cover ways to detect Midjourney prompt moderation, the execution of Midjourney upscale or create variations and enhance or modify button commands.

Subscribe to stay informed.

Please visit https://useapi.net/ to learn more about Midjourney API