MJ文档
    • MJ 绘画 API 文档

    MJ 绘画 API 文档

    本文档详细说明了 MJ (Midjourney) 绘画相关的 API 接口。

    鉴权#

    所有接口均需要在 Header 中携带 Authorization 字段进行鉴权。
    参数名位置类型描述示例
    AuthorizationHeaderstringAPI Key{{YOUR_API_KEY}}

    任务提交接口#

    1. 提交 Imagine 任务#

    提交文生图任务。提交后获取任务ID，需使用查询接口查询任务状态。
    接口地址: /mj/submit/imagine
    请求方式: POST

    请求参数#

    参数名类型必填描述
    botTypestring否bot类型: MID_JOURNEY (默认), NIJI_JOURNEY
    promptstring是提示词
    base64Arrayarray否垫图base64数组
    notifyHookstring否回调地址
    noStorageboolean否是否返回官方链接 (默认 false)
    accountFilterobject否账号筛选配置
    accountFilter 结构:
    参数名类型描述
    modesarray速度筛选，如 ["RELAX"]

    请求示例#

    {
  "botType": "MID_JOURNEY",
  "prompt": "Cat",
  "base64Array": [],
  "notifyHook": "",
  "noStorage": false
}

    响应结果#

    返回 提交结果 对象。
    {
  "code": 1,
  "description": "提交成功",
  "result": "1320098173412546"
}

    2. 提交 Blend 任务#

    提交混图任务。
    接口地址: /mj/submit/blend
    请求方式: POST

    请求参数 (Blend提交参数)#

    参数名类型必填描述
    base64Arrayarray是图片base64数组 (2-5张)
    botTypestring否bot类型: MID_JOURNEY (默认), NIJI_JOURNEY
    dimensionsstring否比例: PORTRAIT(2:3), SQUARE(1:1), LANDSCAPE(3:2)
    notifyHookstring否回调地址
    statestring否自定义参数

    请求示例#

    {
  "botType": "MID_JOURNEY",
  "base64Array": [
    "data:image/png;base64,xxx1",
    "data:image/png;base64,xxx2"
  ],
  "dimensions": "SQUARE"
}

    3. 提交 Describe 任务#

    提交识图（图生文）任务。
    接口地址: /mj/submit/describe
    请求方式: POST

    请求参数#

    参数名类型必填描述
    botTypestring否bot类型: MID_JOURNEY (默认), NIJI_JOURNEY
    base64string否图片base64 (与link二选一)
    linkstring否图片链接 (与base64二选一)
    notifyHookstring否回调地址
    statestring否自定义参数
    languagestring否语言: en (默认), zh_cn

    请求示例#

    {
  "botType": "MID_JOURNEY",
  "link": "https://example.com/image.jpg",
  "language": "en"
}

    4. 提交 Action 任务#

    执行任务的后续操作（如 U, V, Reroll, Zoom 等）。
    接口地址: /mj/submit/action
    请求方式: POST

    请求参数#

    参数名类型必填描述
    customIdstring是动作标识 (从任务查询结果的 buttons 中获取)
    taskIdstring是任务ID
    notifyHookstring否回调地址
    statestring否自定义参数
    noStorageboolean否True: 返回原始图片链接
    enableRemixboolean否是否使用 remix 模式 (默认 false)

    请求示例#

    {
  "customId": "MJ::JOB::variation::1::UUID",
  "taskId": "1746531634074810",
  "enableRemix": true
}

    5. 提交 Modal 任务#

    提交 Modal（弹窗）操作，通常用于 remix 或 custom zoom 等需要输入参数的操作。
    接口地址: /mj/submit/modal
    请求方式: POST

    请求参数 (Modal提交参数)#

    参数名类型必填描述
    taskIdstring是任务ID
    promptstring否提示词
    maskBase64string否局部重绘的蒙版base64
    noStorageboolean否True: 返回原始图片链接

    请求示例#

    {
  "taskId": "14001934816969359",
  "prompt": "new prompt"
}

    6. 提交 Video 任务#

    提交视频生成任务。
    接口地址: /mj/submit/video
    请求方式: POST

    请求参数#

    参数名类型必填描述
    videoTypestring是视频类型: vid_1.1_i2v_480, vid_1.1_i2v_720
    imagestring是首帧图片 (url 或 base64)
    motionstring是运动幅度: low, high
    promptstring否提示词
    endImagestring否尾帧图片 (url 或 base64)
    loopboolean否是否循环
    batchSizeinteger否生成数量 (1, 2, 4, 默认 4)
    actionstring否操作类型: extend (扩展视频时填写)
    indexinteger否视频索引 (0-3, action不为空时必填)
    taskIdstring否父任务ID (action不为空时必填)
    notifyHookstring否回调地址

    请求示例#

    {
  "prompt": "run cat",
  "videoType": "vid_1.1_i2v_480",
  "image": "https://example.com/cat.jpg",
  "motion": "low",
  "batchSize": 1
}

    7. 提交 Edit 任务#

    提交图片编辑/重绘任务。
    接口地址: /mj/submit/edits
    请求方式: POST

    请求参数#

    参数名类型必填描述
    promptstring是提示词
    imagestring是图片 (url 或 base64)
    maskBase64string否蒙版base64 (透明表示编辑区域)
    notifyHookstring否回调地址
    noStorageboolean否是否不存储

    8. 提交 Retexture 任务#

    提交材质重绘任务。
    接口地址: /mj/submit/retexture
    请求方式: POST

    请求参数#

    参数名类型必填描述
    promptstring是提示词
    imagestring是图片 (url 或 base64)
    notifyHookstring否回调地址

    9. 上传文件到 Discord#

    上传图片到 Discord 以获取链接，用于垫图等。
    接口地址: /mj/submit/upload-discord-images
    请求方式: POST

    请求参数#

    参数名类型必填描述
    base64Arrayarray否base64字符串数组

    任务查询接口#

    1. 指定 ID 获取任务#

    查询单个任务详情。
    接口地址: /mj/task/{id}/fetch
    请求方式: GET
    路径参数: id (任务ID)

    响应结果 (任务对象)#

    字段名类型描述
    idstring任务ID
    statusstring状态: NOT_START, SUBMITTED, IN_PROGRESS, FAILURE, SUCCESS, CANCEL
    progressstring进度 (如 "100%")
    imageUrlstring主图链接
    imageUrlsarray单图链接列表
    actionstring任务类型 (IMAGINE, UPSCALE, VARIATION 等)
    promptstring提示词
    promptEnstring英文提示词
    descriptionstring状态描述
    failReasonstring失败原因
    submitTimeinteger提交时间
    startTimeinteger开始时间
    finishTimeinteger结束时间
    buttonsarray可执行的操作按钮列表
    Button 结构:
    字段名类型描述
    customIdstring动作标识
    labelstring按钮文本 (U1, V1 等)
    emojistring图标

    2. 根据 ID 列表查询任务#

    批量查询任务状态。
    接口地址: /mj/task/list-by-condition
    请求方式: POST

    请求参数#

    参数名类型必填描述
    idsarray否任务ID字符串数组

    响应结果#

    返回任务对象数组。

    3. 获取任务图片的 Seed#

    获取已完成任务的 Seed 值。
    接口地址: /mj/task/{id}/image-seed
    请求方式: GET
    路径参数: id (任务ID)

    响应结果#

    {
  "code": 1,
  "description": "Success",
  "result": "123456789"
}

    数据模型#

    提交结果#

    字段类型描述
    codeinteger状态码: 1(成功), 22(排队中), 其他(错误)
    descriptionstring描述
    resultstring任务ID

    任务状态 (Status)#

    NOT_START: 未开始
    SUBMITTED: 已提交
    MODAL: 等待弹窗确认
    IN_PROGRESS: 执行中
    FAILURE: 失败
    SUCCESS: 成功
    CANCEL: 已取消
    修改于 2026-02-10 07:27:12
    Built with