4All API 的 Midjourney 接口怎么调？

基址 https://api.4allapi.com/mj/。常用：POST /mj/submit/imagine（文生图）、POST /mj/submit/blend（图融合）、POST /mj/submit/describe（图反推 prompt）、POST /mj/submit/action（U/V/重绘）、GET /mj/task/{id}/fetch（查任务状态）。所有接口使用 Authorization: Bearer YOUR_TOKEN。

Midjourney 是同步还是异步？

异步。submit 类接口立即返回 taskId，需要轮询 GET /mj/task/{id}/fetch 查询进度和结果 URL。建议每 3-5 秒轮询一次直到 status 变为 SUCCESS 或 FAILURE。

MJ 任务能多久返回结果？

正常 imagine 任务约 30-90 秒返回，blend / describe 类约 15-60 秒，复杂的 InsightFaceSwap 类约 30-120 秒。具体取决于上游 Discord 队列状态。任务长时间 IN_PROGRESS 可联系客服。

如何换脸/InsightFace？

POST /mj/insight-face/swap，参数 sourceBase64（人脸源）+ targetBase64（目标图）。返回 taskId 走 fetch 流程。注意：仅支持合法授权场景，不可用于伪造他人身份。

批量查询任务列表怎么做？

POST /mj/task/list-by-condition，body 传 ids 数组或 startTime/endTime。返回每个任务的状态、进度、imageUrl。比逐个 fetch 高效。

绘图任务计费方式？

按上游 Midjourney 调用次数计费，所有任务类型（imagine/blend/describe/action）单价相同，失败任务不计费。可在控制台「任务日志」查到每次绘图的扣费详情。

Midjourney接口文档

Midjourney API Documentation

Midjourney Image Formats (Midjourney Proxy/Midjourney Proxy Plus)

:memo: Introduction

Midjourney is a powerful image generation and editing model that can create, edit, and modify images based on natural language descriptions. By exposing different endpoints, it supports a wide range of image generation and processing tasks.

:arrows_counterclockwise: Workflow Diagram

Workflow Overview

Initial Task
Imagine: Text-to-image
Blend: Multi-image blending
Describe: Image description
Swap Face: Face replacement
Image Processing
U1-U4: Upscaling
V1-V4: Variation generation
Pan: Image panning
Zoom: Image scaling
Special Workflows
Action + Modal: Operations that require a confirmation dialog
Action direct execution: Operations that do not require a confirmation dialog
Task Management
Get task details
Get image seed
Upload to Discord

:bulb: Request Examples

Submit Imagine Task :check_mark_button:

curl --location --request POST 'https://api.4allapi.com/mj/submit/imagine' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
    "botType": "MID_JOURNEY",
    "prompt": "Cat",
    "base64Array": [],
    "accountFilter": {
        "channelId": "",
        "instanceId": "",
        "modes": [],
        "remark": "",
        "remix": true,
        "remixAutoConsidered": true
    },
    "notifyHook": "",
    "state": ""
}'

Response example:

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

Submit Blend Task :check_mark_button:

curl --location --request POST 'https://api.4allapi.com/mj/submit/blend' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
    "botType": "MID_JOURNEY",
    "base64Array": [
        "data:image/png;base64,xxx1",
        "data:image/png;base64,xxx2"
    ],
    "dimensions": "SQUARE",
    "accountFilter": {
        "channelId": "",
        "instanceId": "",
        "modes": [],
        "remark": "",
        "remix": true,
        "remixAutoConsidered": true
    },
    "notifyHook": "",
    "state": ""
}'

Response example:

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

Submit Describe Task :check_mark_button:

curl --location --request POST 'https://api.4allapi.com/mj/submit/describe' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
    "botType": "MID_JOURNEY",
    "base64": "data:image/png;base64,xxx",
    "accountFilter": {
        "channelId": "",
        "instanceId": "",
        "modes": [],
        "remark": "",
        "remix": true,
        "remixAutoConsidered": true
    },
    "notifyHook": "",
    "state": ""
}'

Response example:

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

curl --location --request POST 'https://api.4allapi.com/mj/submit/modal' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
    "maskBase64": "",
    "prompt": "",
    "taskId": "14001934816969359"
}'

Response example:

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

Submit swap_face Task :check_mark_button:

curl --location --request POST 'https://api.4allapi.com/mj/insight-face/swap' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sourceBase64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBwgHBgkIBwgKCgkLDRYPDQwMDRsUFRAWIB0iIiAdHx8kKDQsJCYxJx8fLT0tMTU3Ojo6Iys/RDnYdriP1wsS81kwU8OVs/R3xu8s6bX7+zYnOH8coSqpmRSBjqerjcBlr2OB/lbAf/2Q==",
    "targetBase64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBwgHBgkIBwgKCgkLDRYPDQwMDRsUFRAWIB0iIiAdHx8kKDQsJCYxJx8fLT0tMTU3Ojo6Iys/RD849k="
}'

Response example:

{
    "code": 0,
    "description": "string",
    "result": "string"
}

Execute Action :check_mark_button:

curl --location --request POST 'https://api.4allapi.com/mj/submit/action' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
    "chooseSameChannel": true,
    "customId": "MJ::JOB::upsample::1::82c51c9d-bc33-4c07-a471-36c3dcb1a6f0",
    "taskId": "1728781324658687",
    "accountFilter": {
        "channelId": "",
        "instanceId": "",
        "modes": [],
        "remark": "",
        "remix": true,
        "remixAutoConsidered": true
    },
    "notifyHook": "",
    "state": ""
}'

Response example:

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

Upload Files to Discord :check_mark_button:

curl --location --request POST 'https://api.4allapi.com/mj/submit/upload-discord-images' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
    "base64Array": [],
    "filter": {
        "channelId": "",
        "instanceId": "",
        "remark": ""
    }
}'

Response example:

{
    "code": 0,
    "description": "string",
    "result": [
        "string"
    ]
}

Query Tasks by ID List :check_mark_button:

curl --location --request POST 'https://api.4allapi.com/mj/task/list-by-condition' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ids": []
}'

Response example:

[
    {
        "action": "IMAGINE",
        "buttons": [
            {
                "customId": "string",
                "emoji": "string",
                "label": "string",
                "style": 0,
                "type": 0
            }
        ],
        "description": "string",
        "failReason": "string",
        "finishTime": 0,
        "id": "string",
        "imageUrl": "string",
        "progress": "string",
        "prompt": "string",
        "promptEn": "string",
        "properties": {},
        "startTime": 0,
        "state": "string",
        "status": "NOT_START",
        "submitTime": 0
    }
]

Get a Task by ID :check_mark_button:

curl --location --request GET 'https://api.4allapi.com/mj/task/{id}/fetch' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Content-Type: application/json'

Response example:

{
    "action": "IMAGINE",
    "buttons": [
        {
            "customId": "string",
            "emoji": "string",
            "label": "string",
            "style": 0,
            "type": 0
        }
    ],
    "description": "string",
    "failReason": "string",
    "finishTime": 0,
    "id": "string",
    "imageUrl": "string",
    "progress": "string",
    "prompt": "string",
    "promptEn": "string",
    "properties": {},
    "startTime": 0,
    "state": "string",
    "status": "NOT_START",
    "submitTime": 0
}

Get the Image Seed for a Task :check_mark_button:

curl --location --request GET 'https://api.4allapi.com/mj/task/{id}/image-seed' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Content-Type: application/json'

Response example:

{
    "code": 0,
    "description": "string",
    "result": "string"
}

:postbox: Requests

Endpoints

Submit Imagine Task

POST /mj/submit/imagine

Create an image from a text prompt.

Submit Blend Task

POST /mj/submit/blend

Blend multiple input images to generate a new image.

Submit Describe Task

POST /mj/submit/describe

Generate a text description from an input image.

POST /mj/submit/modal

Submit modal information for fine-tuning image generation details.

Submit swap_face Task

POST /mj/insight-face/swap

Perform face swapping between a source image and a target image.

Execute Action

POST /mj/submit/action

Perform follow-up actions on a generated image, such as upscaling or adjustments.

Upload Files to Discord

POST /mj/submit/upload-discord-images

Upload images to the Discord platform.

Query Tasks by ID List

POST /mj/task/list-by-condition

Query task details by a specified list of task IDs.

Get a Task by ID

GET /mj/task/{id}/fetch

Get task details by task ID.

Get the Image Seed for a Task

GET /mj/task/{id}/image-seed

Get the seed value of the image generated for the specified task.

Authentication

Include the following header to authenticate with your API key:

Authorization: Bearer $API_KEY

Where $API_KEY is your API key.

Request Body Parameters

Submit Imagine Task

`botType`

Type: enum string
Required: No
Default: MID_JOURNEY
Options:
- MID_JOURNEY: Midjourney model
- NIJI_JOURNEY: Niji Journey model
Description: Selects the bot type to use

`prompt`

Type: string
Required: Yes
Description: The text prompt used for image generation
Notes:
- Use clear and specific descriptions
- You can include artistic style, composition, and other details
- English and Chinese inputs are supported

`base64Array`

Type: string array
Required: No
Description: Base64-encoded image array for image references
Format: Each element should be a complete base64 image string, including the MIME type prefix

`accountFilter`

Type: object
Required: No
Properties:
- channelId: Channel ID
- instanceId: Account instance ID
- modes: Array of account modes; options: RELAX, FAST, TURBO
- remark: Content included in the remark
- remix: Whether the account supports remix
- remixAutoConsidered: Remix auto-submit setting

`notifyHook`

Type: string
Required: No
Description: Callback URL after the task is completed; if empty, the global notifyHook is used

`state`

Type: string
Required: No
Description: Custom state parameter for request tracking

Submit Blend Task

`base64Array`

Type: string array
Required: Yes
Description: Base64-encoded array of images to blend
Format: Must contain base64 strings for 2-5 images

`dimensions`

Type: enum string
Required: No
Options:
- PORTRAIT: 2:3 aspect ratio
- SQUARE: 1:1 aspect ratio
- LANDSCAPE: 3:2 aspect ratio
Description: Aspect ratio setting for the output image

Submit Describe Task

`base64`

Type: string
Required: Yes
Description: Base64-encoded image to be described
Format: Complete base64 string, including the MIME type prefix

`maskBase64`

Type: string
Required: No
Description: Base64-encoded mask image for partial inpainting

`prompt`

Type: string
Required: No
Description: Text prompt for the inpainted area

`taskId`

Type: string
Required: Yes
Description: ID of the original task

Submit Swap Face Task

`sourceBase64`

Type: string
Required: Yes
Description: Base64-encoded source image for the face
Requirement: The image must contain a clear face

`targetBase64`

Type: string
Required: Yes
Description: Base64-encoded target image
Requirement: The image must contain the face to be replaced

Execute Action

`chooseSameChannel`

Type: boolean
Required: No
Default: false
Description: Whether to select an account in the same channel

`customId`

Type: string
Required: Yes
Description: Action identifier
Format: A string in a specific format, such as “MJ::JOB::upsample::1::xxx”

`taskId`

Type: string
Required: Yes
Description: The task ID on which to perform the action

Upload Files to Discord

`base64Array`

Type: string array
Required: Yes
Description: Array of base64-encoded images to upload

`filter`

Type: object
Required: No
Properties:
- channelId: Target channel ID
- instanceId: Account instance ID
- remark: Remark information

Query Tasks by ID List

`ids`

Type: string array
Required: Yes
Description: List of task IDs to query

Common Response Format

All endpoints return a similar response structure:

`code`

Type: integer
Description: Status code

Status Code	Description
1	Submitted successfully
22	Task queued
21	Invalid parameters
23	System error
24	Account unavailable
25	Insufficient balance

`description`

Type: string
Description: Response message

`properties`

Type: object
Description: Extended properties

`result`

Type: string or array
Description: Return value, which may be a task ID or other data

:inbox_tray: Responses

Success Response

`action`

Type: enum string
Description: Task type

String Value	Description
`IMAGINE`	Create image
`UPSCALE`	Upscale image
`VARIATION`	Generate variations
`ZOOM`	Zoom image
`PAN`	Pan image
`DESCRIBE`	Image description
`BLEND`	Blend images
`SHORTEN`	Shorten prompt
`SWAP_FACE`	Face replacement

`buttons`

Type: array of objects
Description: Action buttons that can be executed

Array Field	Description
`customId`	Action identifier
`emoji`	Button icon
`label`	Button text
`style`	Style (2=Primary, 3=Green)
`type`	Internal system type

`description`

Type: string
Description: Task description

`failReason`

Type: string
Description: Reason the task failed

`finishTime`

Type: integer
Description: Task completion timestamp

`id`

Type: string
Description: Unique task identifier

`imageUrl`

Type: string
Description: URL of the generated image

`progress`

Type: string
Description: Task progress information

`prompt`

Type: string
Description: Original prompt

`promptEn`

Type: string
Description: English prompt

`status`

Type: enum string
Description: Task status

String Value	Description
`NOT_START`	Not started
`SUBMITTED`	Submitted
`MODAL`	Modal in progress
`IN_PROGRESS`	In progress
`FAILURE`	Failed
`SUCCESS`	Successful
`CANCEL`	Canceled

`submitTime`

Type: integer
Description: Task submission timestamp

`startTime`

Type: integer
Description: Task start timestamp

Error Response

When a request encounters a problem, the API returns an error response:

HTTP Status Codes

400 Bad Request: Invalid request parameters
401 Unauthorized: API key is invalid or missing
403 Forbidden: Insufficient permissions
404 Not Found: Resource not found
429 Too Many Requests: Rate limit exceeded
500 Internal Server Error: Internal server error

Error Response Format

{
    "code": <error_code>,
    "description": "Error description",
    "result": null
}

Midjourney接口文档

Midjourney API Documentation

Midjourney Image Formats (Midjourney Proxy/Midjourney Proxy Plus)

:memo: Introduction

:arrows_counterclockwise: Workflow Diagram

Workflow Overview

:bulb: Request Examples

Submit Imagine Task :check_mark_button:

Submit Blend Task :check_mark_button:

Submit Describe Task :check_mark_button:

Submit Modal :check_mark_button:

Submit swap_face Task :check_mark_button:

Execute Action :check_mark_button:

Upload Files to Discord :check_mark_button:

Query Tasks by ID List :check_mark_button:

Get a Task by ID :check_mark_button:

Get the Image Seed for a Task :check_mark_button:

:postbox: Requests

Endpoints

Submit Imagine Task

Submit Blend Task

Submit Describe Task

Submit Modal

Submit swap_face Task

Execute Action

Upload Files to Discord

Query Tasks by ID List

Get a Task by ID

Get the Image Seed for a Task

Authentication

Request Body Parameters

Submit Imagine Task

botType

prompt

base64Array

accountFilter

notifyHook

state

Submit Blend Task

base64Array

dimensions

Submit Describe Task

base64

Submit Modal Task

maskBase64

prompt

taskId

Submit Swap Face Task

sourceBase64

targetBase64

Execute Action

chooseSameChannel

customId

taskId

Upload Files to Discord

base64Array

filter

Query Tasks by ID List

ids

Common Response Format

code

description

properties

result

:inbox_tray: Responses

Success Response

action

buttons

description

failReason

finishTime

id

imageUrl

progress

prompt

promptEn

status

submitTime

startTime

Error Response

`botType`

`prompt`

`base64Array`

`accountFilter`

`notifyHook`

`state`

`base64Array`

`dimensions`

`base64`

`maskBase64`

`prompt`

`taskId`

`sourceBase64`

`targetBase64`

`chooseSameChannel`

`customId`

`taskId`

`base64Array`

`filter`

`ids`

`code`

`description`

`properties`

`result`

`action`

`buttons`

`description`

`failReason`

`finishTime`

`id`

`imageUrl`

`progress`

`prompt`

`promptEn`

`status`

`submitTime`

`startTime`