Midjourney Imagine API 接入与实战详解

API 支持垫图功能，即在输入一张图片 URL 的基础上添加文字描述进行改写。

格式要求： 图片 URL 需为纯图片链接（建议使用图床），放在 Prompt 开头，后接空格和文字描述。

https://example.com/image.jpg an illustration of a car parked on the beach --iw2

其中 --iw2 是调整图片权重的参数。将上述内容整体传递给 prompt 字段即可。

5. 图像融合

支持传入多张图片 URL 实现融合效果，最多支持 5 张图片。

Prompt 构造： 多个图片 URL 用空格分隔，最后跟上文字描述。

https://img1.png https://img2.png The bear is holding the chainsaw --iw2

6. 局部变换（Inpainting）

支持对生成图片的特定区域进行重绘。需要传入掩码（Mask）的 Base64 编码。

获取掩码

掩码通常通过灰度图生成，白色区域代表重绘范围。以下是一个简化的 Python 示例，用于绘制并保存掩码：

import cv2
import base64

# 读取原图和掩码图
image_path = 'temp.jpg'
grey_image = cv2.imread(image_path)
_, buffer = cv2.imencode('.jpg', grey_image)
base64_encoded = base64.b64encode(buffer).decode('utf-8')

print(base64_encoded)

调用接口

设置 action 为 variation_region，并传入 image_id 和 mask。

{
  "prompt": "A cute cat",
  "action": "variation_region",
  "image_id": "1265875488702726144",
  "mask": "/9j/4AAQSkZJRgABAQAAAQABAAD..."
}

7. 异步回调

由于生图耗时较长，API 支持 Webhook 回调。设置 callback_url 后，生成完成或失败时都会发送 HTTP 请求到该地址。

• 成功回调：包含 success: true 及图片信息。
• 失败回调：包含 success: false 及 error.code、error.message。

8. 流式输出

为了提升体验，API 支持流式返回进度。修改请求头 accept 为 application/x-ndjson 即可开启。

Python 示例

import requests

url = 'https://api.acedata.cloud/midjourney/imagine'
headers = {
    'content-type': 'application/json',
    'accept': 'application/x-ndjson',
    'authorization': 'Bearer {token}'
}
body = {"prompt": "a beautiful cat --v 6"}

r = requests.post(url, headers=headers, json=body, stream=True)
for line in r.iter_lines():
    print(line.decode())

Node.js 示例

const axios = require("axios");
const url = "https://api.acedata.cloud/midjourney/imagine";
const headers = {
    "content-type": "application/json",
    "accept": "application/x-ndjson",
    "authorization": "Bearer {token}"
};
const body = {
    prompt: "a beautiful cat --v 6",
    action: "generate"
};

axios.post(url, body, { headers: headers, responseType: "stream" })
    .then((response) => {
        console.log(response.status);
        response.data.on("data", (chunk) => {
            console.log(chunk.toString());
        });
    })
    .catch((error) => {
        console.error(error);
    });

注意：流式输出中 progress 字段表示生成进度（0-100）。未完成时 actions 为空，且中间生成的 image_url 会在完成后销毁。