Sign in

v1

latestOpenAPI 3.1.02026-07-267724480.0 KB

Create a Midjourney imagine task

Submit the primary Midjourney generation request. Poll the returned task id with the fetch endpoint until the task reaches a terminal state.

post/mj/submit/imagine

Request body

botType'MID_JOURNEY' | 'NIJI_JOURNEY'

Bot type to use. MID_JOURNEY for Midjourney (default), NIJI_JOURNEY for Niji.

promptstring required

Text prompt for the generation. Supports standard Midjourney parameters such as --v, --ar, --stylize, etc.

base64Arraystring[]

Base64-encoded reference images. Each item should be a data URI such as data:image/png;base64,xxx.

statestring

Custom state string. Returned as-is in the task result and webhook callback for your own tracking.

Example request

{
  "prompt": "a paper boat floating on calm water at sunrise --v 6.1"
}

Response

Task accepted.

codeinteger required

Submission status code. 1 = submitted successfully (result carries the task id). 21 = the action opened a confirmation modal; continue with /mj/submit/modal using the returned task id. 4 = parameter error; description explains the cause.

descriptionstring required
resultstring required

Task id returned after submission.

Example response

{
  "code": 1,
  "description": "Submission successful",
  "result": "1773314942177684",
  "properties": {
    "discordChannelId": "5e6ca8e1f40e4de6",
    "discordInstanceId": "5e6ca8e1f40e4de6"
  }
}