jobs/imagine

Midjourney /imagine command

Request Headers
Request Body
Responses
Examples
Try It

Important
We will be officially sunsetting v1. Starting from March 1, 2024 all calls will be routed to v2 endpoints. Although this change will be transparent to our customers we strongly advise you to update your code to use the v2 endpoints as they provide many more options.

Use this endpoint to submit the Midjourney /imagine command to your Discord Midjourney channel. Results obtained as a callback via optional parameter replyUrl or by querying jobs/?jobid=jobid endpoint.

Your current Midjourney Settings and Presets will be used, log in to your Discord Midjourney account to adjust them to your liking.

It is important not to use the Midjourney account setup for API access for any purposes other than its intended use, such as executing /imagine or any other Midjourney commands manually or in conjunction with any other automation tools. The useapi.net API internally tracks the usage of the Midjourney account, including the number of currently active executions. Using it for other activities may cause API to function incorrectly.

https://api.useapi.net/v1/jobs/imagine

Request Headers

Authorization: Bearer {API token}
Content-Type: application/json

API token is required, see Setup useapi.net for details.

Request Body

{
    "prompt": "Midjourney prompt",
    "discord": "Discord token",
    "server": "Discord server id",
    "channel": "Discord channel id",
    "maxJobs": 3,
    "replyUrl": "Place your call back URL here",
    "replyRef": "Place your reference id here"
}

prompt is required, must contain Midjourney /imagine prompt.
Maximum length 1024 characters.
discord, server, channel are required, see Setup Midjourney for details.
maxJobs is optional, if not provided defaulted to 3.
This value should be the same or less than your Midjourney subscription plan Maximum Concurrent Jobs. Currently, it should be 3 or less for Basic and Standard plans and 15 or less for Pro and Mega plans.
Important Specifying a higher number than supported by your Midjourney subscription will prevent API from functioning properly.
replyUrl is optional, place here your callback URL. API will call the provided replyUrl once generation completed.
Maximum length 1024 characters.
We recommend using sites like webhook.site to test callback URL functionality.
replyRef is optional, place here your reference id which will be stored and returned along with this job response / result.
Maximum length 1024 characters.

Responses

200 OK

Use returned jobid to retrieve job status and results. content contains message generated by Midjourney reflecting current generation parameters and progress.

{
    "jobid": "<jobid>",
    "verb": "imagine",
    "status": "started",
    "created": "2023-09-09T02:04:49.667Z",
    "updated": "2023-09-09T02:04:53.490Z",
    "prompt": "Steampunk cat",
    "channel": "<Discord channel id>",
    "server": "<Discord server id>",
    "maxJobs": 3,
    "messageId": "<Discord message id>",
    "content": "**Steampunk cat --s 750 --v 5.2** - <@Discord user id> (Waiting to start)",
    "timestamp": "2023-09-09T02:04:51.926000+00:00",
    "code": 200
}

Model

{
    jobid: string,
    verb: 'imagine',
    status: 'started',
    created: Date,
    updated: Date,
    prompt: string,
    channel: string,
    server: string,
    maxJobs: number,
    messageId: string,
    content: string,
    timestamp: Date,
    code: 200
}

401 Unauthorized

{
    "error": "Unauthorized",
    "code": 401
}

412 Precondition Failed

{
    "error": "<prompt | discord | server | channel> is missing",
    "code": 412
}

413 Content Too Large

{
    "error": "<prompt | replyRef | replyUrl> is too long",
    "code": 413
}

422 Unprocessable Content

The prompt did not pass the Midjourney content moderation policy.
If you wish to appeal login to Discord, navigate to the configured API server and channel, locate the moderation message, and proceed with the appeal process. Do not mention the fact that you’re using API for Midjourney request generation as it is prohibited by Midjourney policy and may result in a permanent ban of your Midjourney Discord account.
```
{
    "error": "Unable to find posted message, likely moderated or invalid prompt",
    "jobid": "<jobid>",
    "status": "moderated",
    "code": 422
}
```

429 Too Many Requests

API query is full and can not accept new jobs/imagine requests. Size of query defined by maxJobs optional parameter. Wait in a loop for at least 10..30 seconds and retry again.

{
    "error": "Maximum of <maxJobs> jobs executing in parallel supported",
    "executingJobs": [
      "<jobid>",
      "<jobid>",
      "<jobid>"
    ],
    "code": 429
}

Examples

curl -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer …" \
     -X POST https://api.useapi.net/v1/jobs/imagine \
     -d '{"prompt": "…", "discord": "…", "server": "…", "channel": "…"}'

const apiUrl = "https://api.useapi.net/v1/jobs/imagine"; 
const token = "API token";
const prompt = "Midjourney prompt";      
const discord = "Discord token";
const server = "Discord server id";
const channel = "Discord channel id";      
const data = { 
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json' }
};
data.body = JSON.stringify({ 
  prompt, discord, server, channel 
});
const response = await fetch(apiUrl, data);
const result = await response.json();
console.log("response", {response, result});

import requests
apiUrl = "https://api.useapi.net/v1/jobs/imagine" 
token = "API token"
prompt = "Midjourney prompt"
discord = "Discord token"
server = "Discord server id"
channel = "Discord channel id"
headers = {
    "Content-Type": "application/json", 
    "Authorization" : f"Bearer {token}"
}
body = {
    "prompt": f"{prompt}", 
    "discord": f"{discord}", 
    "server": f"{server}", 
    "channel": f"{channel}"
}
response = requests.post(apiUrl, headers=headers, json=body)
print(response, response.json())