Midjourney Overview
Crazyrouter provides a complete Midjourney API proxy, supporting all operations including Imagine, Blend, Describe, Upscale, Variation, and more. All requests are processed asynchronously via tasks.
Base Path
https://crazyrouter.com/mj
Authentication
Pass your API Key in the request header:
Authorization: Bearer YOUR_API_KEY
Task Object
Each Midjourney request submission returns a task object. The task object contains the following fields:
| Field | Type | Description |
|---|
id | string | Unique task identifier |
action | string | Task type: IMAGINE, UPSCALE, VARIATION, BLEND, DESCRIBE, etc. |
status | string | Task status |
prompt | string | Submitted prompt |
promptEn | string | Translated English prompt |
description | string | Task description |
submitTime | number | Submission time (millisecond timestamp) |
startTime | number | Processing start time |
finishTime | number | Completion time |
progress | string | Progress percentage, e.g. "100%" |
imageUrl | string | Generated image URL |
failReason | string | Failure reason (only present on failure) |
properties | object | Additional properties |
buttons | array | List of available action buttons |
Task Status
| Status | Description |
|---|
NOT_START | Task submitted, waiting to be processed |
SUBMITTED | Task submitted to Midjourney |
IN_PROGRESS | Task is being processed |
SUCCESS | Task completed |
FAILURE | Task failed |
After a task completes, the buttons field contains available follow-up actions:
{
"buttons": [
{"customId": "MJ::JOB::upsample::1::hash", "emoji": "U1", "label": "U1", "style": 2},
{"customId": "MJ::JOB::upsample::2::hash", "emoji": "U2", "label": "U2", "style": 2},
{"customId": "MJ::JOB::upsample::3::hash", "emoji": "U3", "label": "U3", "style": 2},
{"customId": "MJ::JOB::upsample::4::hash", "emoji": "U4", "label": "U4", "style": 2},
{"customId": "MJ::JOB::variation::1::hash", "emoji": "V1", "label": "V1", "style": 2},
{"customId": "MJ::JOB::variation::2::hash", "emoji": "V2", "label": "V2", "style": 2},
{"customId": "MJ::JOB::variation::3::hash", "emoji": "V3", "label": "V3", "style": 2},
{"customId": "MJ::JOB::variation::4::hash", "emoji": "V4", "label": "V4", "style": 2}
]
}
customId to call the Action endpoint to perform the corresponding operation (upscale, variation, etc.).
API Endpoints Overview
| Method | Endpoint | Description |
|---|
| POST | /mj/submit/imagine | Submit an Imagine task |
| POST | /mj/submit/action | Execute an action (upscale, variation, etc.) |
| POST | /mj/submit/blend | Blend images |
| POST | /mj/submit/describe | Describe an image |
| POST | /mj/submit/modal | Submit modal confirmation |
| POST | /mj/submit/shorten | Shorten a prompt |
| GET | /mj/task/{id}/fetch | Query a single task |
| POST | /mj/task/list-by-condition | Batch query tasks |
| GET | /mj/task/{id}/image-seed | Get image seed |
Midjourney tasks are processed asynchronously. After submission, you need to poll the task status. It is recommended to query every 3-5 seconds until the status becomes SUCCESS or FAILURE.
