Midjourney Imagine API 申请与使用指南

字段说明：

• task_id：任务唯一标识。
• image_id：图片唯一标识，后续变换操作需传入此参数。
• image_url：缩略图 URL，可直接查看效果。
• raw_image_url：原图 URL，更高清但加载稍慢。
• actions：可执行的操作列表。upscale 代表放大，variation 代表变换。例如 upscale1 放大左上角第一张，variation3 基于左下角第三张变换。

打开 image_url 可查看生成的 2x2 预览图：

至此，第一次 API 调用完成。

图像放大与变换

针对生成的照片进行进一步操作，比如觉得右上角第二张不错想微调，可将 action 设为 variation2，同时传入 image_id：

结果如下：

{
  "image_url": "https://midjourney.cdn.acedata.cloud/attachments/...",
  "image_id": "1234201336543969401",
  "actions": ["upscale1", ...],
  "task_id": "f4961620-1104-409f-9dc1-ba3ed15c2f4d",
  "success": true
}

新生成的图片如下：

此时可挑选其中一张精细化放大，比如选第四张，传入 action: upscale4 和当前 image_id：

注意：upscale 操作相比 variation 耗时通常更短。

返回结果中 actions 会更新为新的可用操作：

• upscale_2x / upscale_4x：放大 2 倍或 4 倍高清图。
• zoom_out_2x / zoom_out_1_5x：缩小画面（周围区域填充）。
• pan_left / pan_right / pan_up / pan_down：画面偏移操作。

按上述流程传入指令即可连续生图。

图像改写（垫图）

API 支持图像改写（Image Prompt），输入图片 URL 及描述文字即可返回改写后的图片。

注意：输入的图片 URL 必须是纯图片链接，不能是网页展示图。建议使用图床获取 URL。

例如有一张公路落日的图片，想在基础上改写成海滩旁停一辆汽车：

构造 prompt 时，在开头加上 HTTPS 图片链接，空格后跟文字描述，可使用高级参数如 --iw 2 调整权重：

https://cdn.acedata.cloud/v014oc.png an illustration of a car parked on the beach --iw2

整体传递给 prompt 字段：

输出结果：

{
  "image_url": "https://midjourney.cdn.acedata.cloud/attachments/...",
  "image_id": "1234539663515975690",
  "actions": [...],
  "task_id": "24a79e8b-a79d-471a-aef7-089dc0627ee8",
  "success": true
}

生成图片如下：

场景变为海滩，且保留了原有风格构图，这就是 Prompt with Image 的效果。

图像融合

API 支持多张图片融合。例如将玩具熊和电锯融合成熊拿电锯的画面：

构造 prompt，将多张图片 URL 放在开头，空格分隔，最后加文字描述：

https://i-blog.ZEEKLOGimg.cn/img_convert/c97448ef51e6b36bd026d72092abe548.png https://i-blog.ZEEKLOGimg.cn/img_convert/1d81aa82612a1f16e8f3ad41354af74f.png The bear is holding the chainsaw --iw2

注意：此处链接已失效，实际使用时请替换为有效的公开图片 URL。

传给 prompt 参数运行：

{
  "image_url": "https://midjourney.cdn.acedata.cloud/attachments/...",
  "image_id": "1234547236830973972",
  "actions": [...],
  "task_id": "891f2645-ee15-4c7b-ac24-d98163c8e57e",
  "success": true
}

成功实现图片融合：

注意：图片融合最多支持 5 个图片 URL 作为输入。

局部变换

API 支持局部重绘（Inpainting）。需传入生成图片的 image_id、行为参数 action 以及掩码 mask（Base64 编码）。

例如有一张猫的图片，想重绘猫脸：

首先需要获取区域的掩码 mask。以下是 Python 获取掩码的工具代码示例：

import sys
import os
from PySide6.QtWidgets import *
from PySide6.QtGui import QPainter, QMouseEvent, QPen, QColor, QImage
from PySide6.QtCore import Qt, QPoint

class DrawingWidget(QWidget):
    def __init__(self, imagePath):
        super().__init__()
        self.setAttribute(Qt.WA_StaticContents)
        self.background_image = QImage(imagePath)
        imageSize = self.background_image.size() * 0.8
        self.setFixedSize(imageSize)
        self.foreground_image = QImage(self.size(), QImage.Format_ARGB32)
        self.foreground_image.fill(Qt.transparent)
        self.drawing = False
        self.lastPoint = QPoint()
        self.pen_color = QColor(255, 255, 255, 255)
        self.pen_size = 50

    def set_pen_size(self, size):
        self.pen_size = size

    def mousePressEvent(self, event: QMouseEvent):
        if event.button() == Qt.LeftButton:
            self.drawing = True
            self.lastPoint = event.pos()

    def mouseMoveEvent(self, event: QMouseEvent):
        if event.buttons() & Qt.LeftButton and self.drawing:
            painter = QPainter(self.foreground_image)
            painter.setRenderHint(QPainter.Antialiasing, True)
            pen = QPen(self.pen_color, self.pen_size, Qt.SolidLine, Qt.RoundCap, Qt.RoundJoin)
            painter.setPen(pen)
            painter.drawLine(self.lastPoint, event.pos())
            self.lastPoint = event.pos()
            self.update()

    def mouseReleaseEvent(self, event: QMouseEvent):
        if event.button() == Qt.LeftButton and self.drawing:
            self.drawing = False

    def paintEvent(self, event):
        canvasPainter = QPainter(self)
        canvasPainter.drawImage(self.rect(), self.background_image, self.background_image.rect())
        canvasPainter.drawImage(self.rect(), self.foreground_image, self.foreground_image.rect())

    def save_image(self, path):
        self.foreground_image.save(path)

class MainWindow(QDialog):
    def __init__(self, imagePath):
        super().__init__()
        self.setWindowTitle("mask tool")
        self.drawing_widget = DrawingWidget(imagePath)
        self.currentPath = os.getcwd().replace("\\", "/")
        self.tempPath = self.currentPath + "/temp.jpg"
        self.projectPath = ""
        self.setDone = False

    def init_ui(self):
        layout = QVBoxLayout()
        layout.addWidget(self.drawing_widget)
        controls_layout = QHBoxLayout()
        size_label = QLabel("pen size:")
        controls_layout.addWidget(size_label)
        self.size_slider = QSlider(Qt.Horizontal)
        self.size_slider.setMinimum(100)
        self.size_slider.setMaximum(400)
        self.size_slider.setValue(400)
        self.size_slider.valueChanged.connect(self.update_pen_size)
        controls_layout.addWidget(self.size_slider)
        self.lineEdit_addPromp = QLineEdit()
        layout.addWidget(self.lineEdit_addPromp)
        save_button = QPushButton("Start partial redrawing")
        save_button.clicked.connect(self.save_image)
        controls_layout.addWidget(save_button)
        dont_button = QPushButton("Cancel partial redraw")
        dont_button.clicked.connect(self.dont_image)
        controls_layout.addWidget(dont_button)
        layout.addLayout(controls_layout)
        self.setLayout(layout)

    def update_pen_size(self):
        size = self.size_slider.value()
        self.drawing_widget.set_pen_size(size)

    def save_image(self):
        tempImage = self.currentPath + "/temp.jpg"
        self.drawing_widget.save_image(self.tempPath)
        self.prompt = self.lineEdit_addPromp.text()
        self.setDone = True
        self.close()

    def dont_image(self):
        self.setDone = False
        self.close()

    def closeEvent(self, event):
        if self.setDone:
            pass
        else:
            self.setDone = False
        event.accept()

if __name__ == '__main__':
    imagePath = "test.png"
    app = QApplication(sys.argv)
    mainWindow = MainWindow(imagePath)
    mainWindow.init_ui()
    mainWindow.exec()

掩码图片必须与原图尺寸一致，白色区域为重绘区域：

接下来将掩码转换为 Base64 编码：

import cv2
import base64

image_path = 'temp.jpg'
gray_image = cv2.imread(image_path)
_, buffer = cv2.imencode('.jpg', gray_image)
base64_encoded = base64.b64encode(buffer).decode('utf-8')
with open('grayscale_image_base64.txt', 'w') as f:
    f.write(base64_encoded)
print("success!")

对接产品时请根据原理编写对应语言代码。

获得掩码后，设置 action 为 variation_region，传入 image_id 和 mask：

• action：variation_region（局部重绘）。
• prompt：重绘描述词（可选）。
• image_id：图片唯一标识。
• mask：掩码区域的 Base64 编码。

参数设置示例：

代码示例

页面右侧自动生成多种语言代码，部分示例如下：

CURL

curl -X POST 'https://api.acedata.cloud/midjourney/imagine' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{ "prompt": "A cute cat ", "action": "variation_region", "image_id": "1265875488702726144", "mask": "base64_encoded_mask_data" }'

Python

import requests

url = "https://api.acedata.cloud/midjourney/imagine"
headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}
payload = {
    "prompt": "A cute cat ",
    "action": "variation_region",
    "image_id": "1265875488702726144",
    "mask": "base64_encoded_mask_data"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)

响应示例

请求成功后返回图像生成结果信息：

{
  "image_url": "https://platform.cdn.acedata.cloud/midjourney/6c9450d8-1c22-4f85-a527-e7a7bfb4a61b.png?imageMogr2/thumbnail/!50p",
  "image_width": 1024,
  "image_height": 1024,
  "actions": ["upscale1", "upscale2", "upscale3", "upscale4", "reroll", "variation1", "variation2", "variation3", "variation4"],
  "raw_image_url": "https://platform.cdn.acedata.cloud/midjourney/6c9450d8-1c22-4f85-a527-e7a7bfb4a61b.png",
  "raw_image_width": 2048,
  "raw_image_height": 2048,
  "progress": 100,
  "image_id": "1265876571323891712",
  "task_id": "6c9450d8-1c22-4f85-a527-e7a7bfb4a61b",
  "success": true
}

这是对掩码区域的重绘结果：

成功实现对生成图片自定义区域的局部重绘。

异步回调

由于生成图片需要等待，API 默认设计为长等待模式。部分场景下可使用异步 Webhook 回调，当图片生成成功或失败时，HTTP 请求会发送到指定的回调 URL。

演示流程：

1. 准备一个接收 HTTP 请求的服务。演示中使用 webhook.site 获取临时 URL。
2. 将 callback_url 设置为该 URL，填入 prompt。
3. 点击测试，立即收到 task_id 响应。
4. 等待生成结束，Webhook URL 会收到包含结果的 HTTP 请求。

回调内容示例：

{
  "success": true,
  "task_id": "f6e39eaf-652a-4bf5-a15c-79d8b143b80a",
  "image_url": "https://midjourney.cdn.acedata.cloud/attachments/...",
  "image_id": "1234551030549839932",
  "actions": [...],
  "progress": 100
}

若失败，success 为 false，并包含 error.code 和 error.message 描述错误详情。

流式输出

Midjourney 生成过程包含从模糊到清晰的迭代。默认模式下，API 等待全过程结束后返回结果，耗时约一分钟。

为提升体验，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 将被销毁。可通过指定 accept=application/x-ndjson 和 callback_url 结合流式结果与异步回调。