Imagine

Midjourney Proxy uses its own asynchronous task protocol and is not part of OpenAI Images. After submitting an Imagine task, save the returned task ID and use the task endpoint to retrieve progress, generated images, and subsequent action buttons.

POST/mj/submit/imagine

Create a Midjourney image task from a text prompt. The API returns a task ID that you can use to retrieve progress, image URLs, and available action buttons.

Image generation is asynchronous: submit an Imagine task, save its ID, poll until the task reaches a terminal state, then use the returned buttons for actions such as upscaling or creating variations.

Authorization

bearerAuth

AuthorizationBearer <token>

Use Bearer your-api-key in the Authorization header.

In: header

Request Body

application/json

Imagine task parameters. Prompt is the only required field.

TypeScript Definitions

Use the request body type in TypeScript.

accountFilter?

Optional account filters.

notifyHook?string

Valid callback URL invoked when the task completes. Pass an empty string to use the platform-configured default callback URL.

state?string

Caller-provided state value used to correlate requests with callbacks.

botType?BotType

Bot type to use. MID_JOURNEY selects Midjourney, and NIJI_JOURNEY selects Niji Journey.

Default"MID_JOURNEY"

Value in

"MID_JOURNEY"
"NIJI_JOURNEY"

prompt*string

Image-generation prompt. Clearly describe the subject, scene, composition, and visual style. The input may be in Chinese or English.

Length1 <= length

base64Array?array<string>

Optional reference-image array. Each image must be a JPEG/JPG, PNG, static GIF, or WEBP file no larger than 4 MB and must include the correct Base64 MIME prefix.

Response Body

`application/json`

curl -X POST "https://example.com/mj/submit/imagine" \  -H "Content-Type: application/json" \  -d '{    "botType": "MID_JOURNEY",    "prompt": "A cat sitting by the window, soft natural light, cinematic composition",    "base64Array": [],    "accountFilter": {      "channelId": "",      "instanceId": "",      "modes": [],      "remark": "",      "remix": true,      "remixAutoConsidered": true    },    "notifyHook": "",    "state": "request-001"  }'

{
  "code": 1,
  "description": "Submitted successfully",
  "properties": {},
  "result": 1320098173412546
}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`