Midjourney overview
Midjourney uses a separate route set and is not mixed with OpenAI Images or the unified video task APIs.
- Submit mainly via
/mj/submit/*(face swap:/mj/insight-face/swap) - Query mainly via
/mj/task/* - Submit actions include , , , , , , ,
- Follow-up button actions go through
/mj/submit/action; action types appear on the query payload field (e.g. , , , , )
Submit APIs
Imagine
`POST /mj/submit/imagine` text-to-image / image-to-image
View docs →Blend
`POST /mj/submit/blend` blend images
View docs →Action
`POST /mj/submit/action` button actions
View docs →Modal
`POST /mj/submit/modal` inpaint / extra prompt
View docs →Describe
`POST /mj/submit/describe` image-to-text
View docs →Shorten
`POST /mj/submit/shorten` prompt analysis
View docs →Video
`POST /mj/submit/video` video generate / extend
View docs →SwapFace
`POST /mj/insight-face/swap` face swap
View docs →Upload Discord
`POST /mj/submit/upload-discord-images`
View docs →Query APIs
Task query
`GET /mj/task/{id}/fetch`
View docs →Batch query
`POST /mj/task/list-by-condition`
View docs →Image seed
`GET /mj/task/{id}/image-seed`
View docs →Route list
| Method | Path | Description |
|---|---|---|
POST | Imagine | |
POST | Blend | |
POST | Action | |
POST | Modal | |
POST | Describe | |
POST | Shorten | |
POST | Video | |
POST | SwapFace | |
POST | Upload Discord | |
GET | Task query | |
POST | Batch query | |
GET | Image seed |
Common response codes
Typical submit response:
json
{
"code": 1,
"description": "Submit success",
"result": "1712158011464906"
}| Description | |
|---|---|
| Submit success | |
| Queued | |
| Queue full; retry later | |
| Prompt contains sensitive words | |
| other | Error |
Some gateways may rewrite upstream queue / already-exists states as success. Always poll task query with the task ID in .
Common field conventions
| Field | Description |
|---|---|
| Default ; slow, fast | |
| = MID_JOURNEY, = NIJI_JOURNEY (Imagine / Video have no this field) | |
| Blend ratio: (2:3), (1:1), (3:2) | |
| Callback URL; empty means no callback | |
| Source task ID for follow-up jobs | |
| Button action id from query | |
| Multi-image Base64 array | |
| Describe single-image Base64 | |
| Inpaint mask | |
| Opaque client state |