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 ドキュメント

Midjourney 画像フォーマット（Midjourney Proxy/Midjourney Proxy Plus）

:memo: 概要

Midjourney は、自然言語による指示をもとに画像の生成・編集・加工ができる強力な画像生成モデルです。さまざまな API を使うことで、多様な画像生成・処理タスクを実現できます。

:arrows_counterclockwise: フロー図

フローの説明

初期タスク
Imagine: テキストから画像を生成
Blend: 複数画像のブレンド
Describe: 画像の説明文生成
Swap Face: 顔の入れ替え
画像処理
U1-U4: 拡大操作
V1-V4: バリエーション生成
Pan: 画像の移動
Zoom: 画像の拡大縮小
特殊フロー
Action + Modal: ポップアップ確認が必要な操作
Action 直接実行: ポップアップ不要の操作
タスク管理
タスク詳細の取得
画像 Seed の取得
Discord へのアップロード

:bulb: リクエスト例

Imagine タスクの送信 :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": ""
}'

レスポンス例:

{
    "code": 1,
    "description": "提交成功",
    "properties": {},
    "result": 1320098173412546
}

Blend タスクの送信 :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": ""
}'

レスポンス例:

{
    "code": 1,
    "description": "提交成功",
    "properties": {},
    "result": 1320098173412546
}

Describe タスクの送信 :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": ""
}'

レスポンス例:

{
    "code": 1,
    "description": "提交成功",
    "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"
}'

レスポンス例:

{
    "code": 1,
    "description": "提交成功",
    "properties": {},
    "result": 1320098173412546
}

swap_face タスクの送信 :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="
}'

レスポンス例:

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

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": ""
}'

レスポンス例:

{
    "code": 1,
    "description": "提交成功",
    "properties": {},
    "result": 1320098173412546
}

ファイルを 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": ""
    }
}'

レスポンス例:

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

ID リストに基づいてタスクを照会 :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": []
}'

レスポンス例:

[
    {
        "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
    }
]

指定 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'

レスポンス例:

{
    "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
}

タスク画像の seed を取得 :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'

レスポンス例:

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

:postbox: リクエスト

エンドポイント

Imagine タスクの送信

POST /mj/submit/imagine

テキストプロンプトに基づいて画像を生成します。

Blend タスクの送信

POST /mj/submit/blend

複数の入力画像をブレンドして新しい画像を生成します。

Describe タスクの送信

POST /mj/submit/describe

入力画像からテキスト説明を生成します。

POST /mj/submit/modal

画像生成の詳細を調整するためのモーダル情報を送信します。

swap_face タスクの送信

POST /mj/insight-face/swap

元画像と対象画像を使って顔を入れ替えます。

Action の実行

POST /mj/submit/action

生成済み画像に対して、拡大や調整などの後続操作を行います。

ファイルを discord にアップロード

POST /mj/submit/upload-discord-images

画像を discord にアップロードします。

ID リストに基づいてタスクを照会

POST /mj/task/list-by-condition

指定したタスク ID の一覧に基づいて、タスク詳細を取得します。

指定 ID でタスクを取得

GET /mj/task/{id}/fetch

タスク ID に基づいてタスク詳細を取得します。

タスク画像の seed を取得

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

指定タスクで生成された画像の seed 値を取得します。

認証方法

リクエストヘッダーに以下を含めて API キー認証を行います。

Authorization: Bearer $API_KEY

ここでの $API_KEY は、あなたの API キーです。

リクエストボディのパラメータ

Imagine タスクの送信

`botType`

種類: 列挙型文字列
必須: いいえ
デフォルト値: MID_JOURNEY
選択肢:
- MID_JOURNEY: Midjourney モデル
- NIJI_JOURNEY: Niji Journey モデル
説明: 使用する bot の種類を選択します

`prompt`

種類: 文字列
必須: はい
説明: 画像生成用のテキストプロンプト
補足:
- 明確で具体的な説明を使用してください
- アートスタイルや構図などの詳細も含められます
- 英語と中国語の入力に対応しています

`base64Array`

種類: 文字列配列
必須: いいえ
説明: 参考画像の base64 エンコード配列
形式: 各要素は MIME タイプのプレフィックスを含む完全な base64 画像文字列である必要があります

`accountFilter`

種類: オブジェクト
必須: いいえ
属性:
- channelId: チャンネル ID
- instanceId: アカウントインスタンス ID
- modes: アカウントモード配列。選択肢は RELAX、FAST、TURBO
- remark: 備考に含まれる内容
- remix: アカウントが remix をサポートしているか
- remixAutoConsidered: remix の自動送信設定

`notifyHook`

種類: 文字列
必須: いいえ
説明: タスク完了後のコールバック URL。空の場合はグローバル notifyHook を使用します

`state`

種類: 文字列
必須: いいえ
説明: カスタム状態パラメータ。リクエスト追跡に使用できます

Blend タスクの送信

`base64Array`

種類: 文字列配列
必須: はい
説明: ブレンドする画像の base64 エンコード配列
形式: 2〜5 枚の画像の base64 文字列を含める必要があります

`dimensions`

種類: 列挙型文字列
必須: いいえ
選択肢:
- PORTRAIT: 2:3 比率
- SQUARE: 1:1 比率
- LANDSCAPE: 3:2 比率
説明: 出力画像の縦横比設定

Describe タスクの送信

`base64`

種類: 文字列
必須: はい
説明: 説明対象の画像の base64 エンコード
形式: MIME タイプのプレフィックスを含む完全な base64 文字列

`maskBase64`

種類: 文字列
必須: いいえ
説明: 部分再描画用マスク画像の base64 エンコード

`prompt`

種類: 文字列
必須: いいえ
説明: 再描画領域のテキストプロンプト

`taskId`

種類: 文字列
必須: はい
説明: 元のタスクの ID

Swap Face タスクの送信

`sourceBase64`

種類: 文字列
必須: はい
説明: 顔の元画像の base64 エンコード
要件: 画像にははっきりとした顔が含まれている必要があります

`targetBase64`

種類: 文字列
必須: はい
説明: 対象画像の base64 エンコード
要件: 置き換える顔が含まれている必要があります

Action の実行

`chooseSameChannel`

種類: 真偽値
必須: いいえ
デフォルト値: false
説明: 同一チャンネルのアカウントを選択するかどうか

`customId`

種類: 文字列
必須: はい
説明: アクション識別子
形式: "MJ::JOB::upsample::1::xxx" のような特定形式の文字列

`taskId`

種類: 文字列
必須: はい
説明: アクションを実行するタスク ID

Discord へのファイルアップロード

`base64Array`

種類: 文字列配列
必須: はい
説明: アップロードする画像の base64 エンコード配列

`filter`

種類: オブジェクト
必須: いいえ
属性:
- channelId: 対象チャンネル ID
- instanceId: アカウントインスタンス ID
- remark: 備考情報

ID リストに基づいてタスクを照会

`ids`

種類: 文字列配列
必須: はい
説明: 照会したいタスク ID の一覧

共通レスポンス形式

すべての API は、似た形式のレスポンスを返します。

`code`

種類: 整数
説明: ステータスコード

ステータスコード	説明
1	送信成功
22	タスクをキュー待機中
21	パラメータエラー
23	システムエラー
24	アカウント利用不可
25	残高不足

`description`

種類: 文字列
説明: レスポンスの説明情報

`properties`

種類: オブジェクト
説明: 拡張属性

`result`

種類: 文字列または配列
説明: 返却結果。タスク ID またはその他のデータが入る場合があります

:inbox_tray: レスポンス

成功レスポンス

`action`

種類: 列挙型文字列
説明: タスク種別

文字列値	説明
`IMAGINE`	画像を生成
`UPSCALE`	画像を拡大
`VARIATION`	バリエーション生成
`ZOOM`	画像をズーム
`PAN`	画像を移動
`DESCRIBE`	画像を説明
`BLEND`	画像をブレンド
`SHORTEN`	プロンプトを短縮
`SWAP_FACE`	顔を置換

`buttons`

種類: オブジェクト配列
説明: 実行可能な操作ボタン

配列に含まれる属性	説明
`customId`	アクション識別子
`emoji`	ボタンアイコン
`label`	ボタンテキスト
`style`	スタイル(2=Primary, 3=Green)
`type`	システム内部で使用される型

`description`

種類: 文字列
説明: タスクの説明情報

`failReason`

種類: 文字列
説明: タスク失敗の理由

`finishTime`

種類: 整数
説明: タスク完了時刻のタイムスタンプ

`id`

種類: 文字列
説明: タスクの一意識別子

`imageUrl`

種類: 文字列
説明: 生成画像の URL

`progress`

種類: 文字列
説明: タスクの進捗情報

`prompt`

種類: 文字列
説明: 元のプロンプト

`promptEn`

種類: 文字列
説明: 英語のプロンプト

`status`

種類: 列挙型文字列
説明: タスク状態

文字列値	説明
`NOT_START`	未開始
`SUBMITTED`	送信済み
`MODAL`	モーダル操作中
`IN_PROGRESS`	進行中
`FAILURE`	失敗
`SUCCESS`	成功
`CANCEL`	キャンセル済み

`submitTime`

種類: 整数
説明: タスク送信時刻のタイムスタンプ

`startTime`

種類: 整数
説明: タスク実行開始時刻のタイムスタンプ

エラーレスポンス

リクエストに問題がある場合、API はエラーレスポンスを返します。

HTTP ステータスコード

400 Bad Request: リクエストパラメータが無効
401 Unauthorized: API キーが無効、または未指定
403 Forbidden: 権限不足
404 Not Found: リソースが存在しない
429 Too Many Requests: リクエスト頻度超過
500 Internal Server Error: サーバー内部エラー

エラーレスポンス形式

{
    "code": <错误码>,
    "description": "错误描述信息",
    "result": null
}

Midjourney接口文档

Midjourney API ドキュメント

Midjourney 画像フォーマット（Midjourney Proxy/Midjourney Proxy Plus）

:memo: 概要

:arrows_counterclockwise: フロー図

フローの説明

:bulb: リクエスト例

Imagine タスクの送信 :check_mark_button:

Blend タスクの送信 :check_mark_button:

Describe タスクの送信 :check_mark_button:

Modal の送信 :check_mark_button:

swap_face タスクの送信 :check_mark_button:

Action の実行 :check_mark_button:

ファイルを discord にアップロード :check_mark_button:

ID リストに基づいてタスクを照会 :check_mark_button:

指定 ID でタスクを取得 :check_mark_button:

タスク画像の seed を取得 :check_mark_button:

:postbox: リクエスト

エンドポイント

Imagine タスクの送信

Blend タスクの送信

Describe タスクの送信

Modal の送信

swap_face タスクの送信

Action の実行

ファイルを discord にアップロード

ID リストに基づいてタスクを照会

指定 ID でタスクを取得

タスク画像の seed を取得

認証方法

リクエストボディのパラメータ

Imagine タスクの送信

botType

prompt

base64Array

accountFilter

notifyHook

state

Blend タスクの送信

base64Array

dimensions

Describe タスクの送信

base64

Modal タスクの送信

maskBase64

prompt

taskId

Swap Face タスクの送信

sourceBase64

targetBase64

Action の実行

chooseSameChannel

customId

taskId

Discord へのファイルアップロード

base64Array

filter

ID リストに基づいてタスクを照会

ids

共通レスポンス形式

code

description

properties

result

:inbox_tray: レスポンス

成功レスポンス

action

buttons

description

failReason

finishTime

id

imageUrl

progress

prompt

promptEn

status

submitTime

startTime

エラーレスポンス

`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`