Skip to main content

提交shorten 任务

GET /mj/submit/shorten

请求体参数 (Body)

string
bot 类型,mj(默认)或 niji
string
回调地址, 为空时使用全局notifyHook
string
required
待分析/精简的提示词
string
自定义参数

请求示例 (cURL)

响应示例 (200 OK)


根据任务ID 查询任务状态

GET /mj/task/{id}/fetch 查询 POST /mj/submit/imagine、/mj/submit/action 等提交的任务当前状态与结果;status 为 SUCCESS 时 imageUrl 有效,buttons 给出可执行的后续 Action(customId)。

请求参数 (Query / Path)

string
required
任务 ID
string
Bearer API Key

请求示例 (cURL)

响应示例 (200 OK)


获取任务图片的seed

GET /mj/task/{id}/image-seed 获取指定任务生成图片的 seed 值(随机数种子),可用于以相同种子复现或微调生成结果。

请求参数 (Query / Path)

string
required
路径中的资源 / 任务 ID
string
Bearer API Key

请求示例 (cURL)

响应示例 (200 OK)


人脸替换(InsightFace Swap)

POST /mj/insight-face/swap 将目标图像中的人脸替换为源图像中的人脸。

请求体参数 (Body)

string
回调地址
string
required
源人脸图片 Base64(提供人脸的图片)
string
自定义透传状态
string
required
目标图片 Base64(需要替换人脸的图片)

请求示例 (cURL)

响应示例 (200 OK)


执行Action动作

POST /mj/submit/action 官方文档:https://docs.midjourney.com/hc/en-us/articles/32804058614669-Upscalers 对已有任务执行 Upscale(放大)、Variation(变体)、Reroll(重绘)、Pan(平移)等操作。

请求体参数 (Body)

boolean
是否选择同一频道下的账号,默认只使用任务关联的账号
string
required
动作标识
string
回调地址, 为空时使用全局notifyHook
string
自定义参数
string
required
任务ID

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)


提交Blend任务

POST /mj/submit/blend 官方文档:https://docs.midjourney.com/hc/en-us/articles/32635189884557-Blend-Images-on-Discord 将多张图像混合生成新图像,需提供 2–5 张图片的 Base64 数据。

请求参数 (Query / Path)

string
Bearer API Key

请求体参数 (Body)

array
图片 base64 数组,需 2~5 张
string
required
bot类型,mj(默认)或niji
string
比例: PORTRAIT(2:3); SQUARE(1:1); LANDSCAPE(3:2)
string
回调地址, 为空时使用全局notifyHook
string
将生成的图像的质量。hd创建具有更精细细节和更高一致性的图像。此参数仅支持dall-e-3.
string
自定义参数

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)


提交 Change(Pan / Zoom)任务

POST /mj/submit/change 对已有图像执行 Pan(扩展方向)或 Zoom Out(扩展画面)操作。

请求体参数 (Body)

string
required
操作类型
string
回调地址
string
自定义透传状态
string
required
原任务 ID

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)


提交Describe任务

POST /mj/submit/describe 官方文档:https://docs.midjourney.com/hc/en-us/articles/32497889043981-Describe 分析一张图片并生成四条文字描述(反向提示词),可用于后续 imagine。

请求参数 (Query / Path)

string
Bearer API Key

请求体参数 (Body)

string
用于生成描述(Describe)的 Base64 图片数据,格式为 data:image/png;base64,<data>。
string
required
bot类型,mj(默认)或niji
string
回调地址, 为空时使用全局notifyHook
string
自定义参数

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)


图像局部编辑(Edits)

POST /mj/submit/edits 在已有图像基础上,通过遮罩区域进行局部编辑,支持 prompt 指导。

请求体参数 (Body)

string
遮罩 Base64(白色区域为编辑区域)
string
回调地址
string
required
编辑区域的新提示词
string
自定义透传状态
string
required
原任务 ID

请求示例 (cURL)

响应示例 (200 OK)


提交Imagine任务

POST /mj/submit/imagine 官方文档:https://docs.midjourney.com/hc/en-us/articles/32023408776205-Prompt-Basics 根据文本提示词生成图像,支持垫图(base64Array)和多机器人类型。

请求参数 (Query / Path)

string
Bearer API Key

请求体参数 (Body)

object
账号筛选条件(可选)
array
垫图 Base64 列表,格式 data:image/png;base64,...,最多 5 张
string
机器人类型;NIJI 适合动漫风格
string
任务完成回调 URL(Webhook)
string
required
图像描述提示词,支持 Midjourney 原生参数(如 --ar 16:9 --v 6.1)
string
透传状态字段,原样携带到回调

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)


提交Modal

POST /mj/submit/modal 针对图像的特定区域进行局部重绘(Vary Region / Inpaint),需提供遮罩区域。

请求参数 (Query / Path)

string
Bearer API Key

请求体参数 (Body)

string
机器人 / Bot 类型
string
遮罩图像 Base64(白色区域为重绘区域)
string
回调地址
string
局部重绘的新提示词(可为空,保留原提示词)
string
自定义透传状态
string
required
原任务 ID

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)


提交 Shorten 任务

POST /mj/submit/shorten 分析提示词并返回精简版本,帮助优化冗长的 prompt。

请求体参数 (Body)

string
机器人 / Bot 类型
string
回调地址
string
required
需要精简的提示词
string
自定义透传状态

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)


文本指令变换(content)

POST /mj/submit/simple-change

请求体参数 (Body)

string
required
变换指令文本,形如「任务ID 操作」,如 “1719999999999000 U1”
string
回调地址, 为空时使用全局notifyHook
string
自定义参数

请求示例 (cURL)

响应示例 (200 OK)


上传图片

POST /mj/submit/upload-discord-images 官方文档:https://docs.midjourney.com/hc/en-us/articles/33329380893325-Managing-Image-Uploads

请求参数 (Query / Path)

string
required
请求体 Content-Type,一般为 application/json
string
Bearer API Key

请求体参数 (Body)

array
required
输入图片 Base64 数组

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)


图生视频(增强版功能)

POST /mj/submit/video

请求体参数 (Body)

string
原图 base64,前端与 image 传同一值。透传给上游
string
required
原图 base64(带前缀:data:image/png;base64,…),图生视频的底图。透传给上游,后端结构体未声明
string
生成模式(透传给上游)。FAST(默认)/RELAX/TURBO
string
运动强度(透传给上游)。low(默认)/high
string
回调地址, 为空时使用全局notifyHook
string
required
视频内容/运动描述
string
自定义参数
string
可选。若对【已有 MJ 任务】生成视频,传该任务 ID(走后端 relay-mj.go:690 分支,需要 taskId);图生视频(传 image)则不需要

请求示例 (cURL)

响应示例 (200 OK)


根据ID列表查询任务

POST /mj/task/list-by-condition 根据 ID 列表批量查询多个任务状态。

请求参数 (Query / Path)

string
Bearer API Key

请求体参数 (Body)

array
required
ID 列表

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)