🔥Midjourney Edit API

Midjourney图像编辑，支持外部图像编辑。

最多可以 同时执行 10 个生成队列，如需更多作业队列请联系我们

编辑图像

注意：由于Midjourney官方编辑图片自带裁剪功能，所以实际支持的可编辑图片有固定比例，目前支持的比例范围为 1:1, 1:2, 2:1, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9，如上传图片不在给定比例范围内，系统会自动调整至合适比例生成新图。

POST https://api.ttapi.io/midjourney/image-edits/submit

根据图像与描述词生成四张图像，该接口为异步任务。

Headers

Name

Value

TT-API-KEY

用于请求授权 TT-API 的API密钥

Content-Type

application-json

Body

参数

类型

是否必须

描述

image

string

是

图像文件支持 url 和 base64 文件，仅支持 png, jpg, jpeg, bmp, webp 示例：https://cdn.ttapi.io/other/2025-07-28/2ace47ac-5cf0-41bb-b1eb-3e47f2a46f35.png 注意：图片中需要修改的部分为透明区域，如示例所示。

prompt

string

是

用于修改图片的提示，Midjourney支持多语言，实测英文效果最佳。

mode

string

否

编辑图片的速率模式：relax，fast，turbo 默认为fast

type

string

否

模型类型可用 edit retexture 默认为 edit

hookUrl

boolean

否

回调地址，任务完成或失败将通过请地址进行通知。如果未设置，则需要请求获取任务状态接口进行查询。

如果 hookUrl 不为空，系统会向您设置的 hookUrl 发送一个 json响应。

请求示例

import requests

endpoint = "https://api.ttapi.io/midjourney/image-edits/submit"

headers = {
    "TT-API-KEY": your_key
}

data = {
    "prompt": "blue-eyed cat",
    "image": "https://cdn.ttapi.io/other/2025-07-28/2ace47ac-5cf0-41bb-b1eb-3e47f2a46f35.png",
    "hookUrl": "https://webhook-test.com/1cb411db3bc4bfa7729c7df3ca2c1a5e"
}

response = requests.post(endpoint, headers=headers, json=data)

print(response.status_code)
print(response.json())

const axios = require('axios');

let config = {
  method: 'post',
  url: 'https://api.ttapi.io/midjourney/image-edits/submit',
  headers: { 
    'TT-API-KEY': 'your_key'
  },
  data : {
     "prompt": "blue-eyed cat",
     "image": "https://cdn.ttapi.io/other/2025-07-28/2ace47ac-5cf0-41bb-b1eb-3e47f2a46f35.png",
     "hookUrl": "https://webhook-test.com/1cb411db3bc4bfa7729c7df3ca2c1a5e"
  }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.status));
})
.catch(function (error) {
  console.log(error);
});

响应示例

{
    "status": "SUCCESS",
    "message": "success",
    "data": {
        "jobId": "943583cb-08f4-4077-ad1e-f1bfc6c1191a"
    }
}

{
  "status": "FAILED",
  "message": "",
  "data": null
}

获取任务状态

GET https://api.ttapi.io/midjourney/image-edits/fetch

查询编辑图片的任务结果，该接口不消耗quota，免费使用

Headers

Name

Value

TT-API-KEY

用于请求授权 TT-API 的API密钥

Content-Type

application-json

Query参数

参数

类型

是否必须

描述

jobId

string

是

生成接口同步返回的jobId

请求示例

import requests

endpoint = "https://api.ttapi.io/midjourney/image-edits/fetch"

headers = {
    "TT-API-KEY": your_key
}

data = {
   "jobId": "afa774a3-1aee-5aba-4510-14818d6875e4"
}

response = requests.post(endpoint, headers=headers, json=data)

print(response.status_code)
print(response.json())

const axios = require('axios');

let config = {
  method: 'post',
  url: 'https://api.ttapi.io/midjourney/image-edits/fetch',
  headers: { 
    'TT-API-KEY': 'your_key'
  },
  data : {
    "jobId" => "afa774a3-1aee-5aba-4510-14818d6875e4"
  }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.status));
})
.catch(function (error) {
  console.log(error);
});

响应示例

返回结果与异步回调数据结构一致

异步回调 JSON 结构

{
  "status": "SUCCESS",
  "message": "success",
  "jobId": "7cea558a-6da0-41cd-863f-e90d5866b076",
  "data": {
    "jobId": "7cea558a-6da0-41cd-863f-e90d5866b076",
    "progress": "100",
    "mode": "fast",
    "prompt": "blue-eyed cat",
    "quota": "3",
    "images": [
      "https://cdn.midjourney.com/48b2eff6-80b2-4f53-a651-993481a928ad/0_0.png",
      "https://cdn.midjourney.com/48b2eff6-80b2-4f53-a651-993481a928ad/0_1.png",
      "https://cdn.midjourney.com/48b2eff6-80b2-4f53-a651-993481a928ad/0_2.png",
      "https://cdn.midjourney.com/48b2eff6-80b2-4f53-a651-993481a928ad/0_3.png"
    ],
    "hookUrl": "https://webhook-test.com/bf74f63b0d51ba1b3090e295aae057fe",
    "submitTime": "2025-07-30T05:39:16Z",
    "finishTime": "2025-07-30T05:40:01Z"
  }
}

{
    "status": "PENDING_QUEUE",
    "message": "",
    "jobId": "7cea558a-6da0-41cd-863f-e90d5866b076",
    "data": {
        "jobId": "7cea558a-6da0-41cd-863f-e90d5866b076",
        "progress": null,
        "mode": "fast",
        "prompt": "blue-eyed cat",
        "quota": "3",
        "images": null,
        "hookUrl": "https://webhook-test.com/bf74f63b0d51ba1b3090e295aae057fe",
        "submitTime": "2025-07-30T05:39:16Z",
        "finishTime": null
    }
}

{
    "status": "ON_QUEUE",
    "message": "",
    "jobId": "7cea558a-6da0-41cd-863f-e90d5866b076",
    "data": {
        "jobId": "7cea558a-6da0-41cd-863f-e90d5866b076",
        "progress": null,
        "mode": "fast",
        "prompt": "blue-eyed cat",
        "quota": "3",
        "images": null,
        "hookUrl": "https://webhook-test.com/bf74f63b0d51ba1b3090e295aae057fe",
        "submitTime": "2025-07-30T05:39:16Z",
        "finishTime": null
    }
}

{
    "status": "FAILED",
    "message": "job timeout",
    "jobId": "7cea558a-6da0-41cd-863f-e90d5866b076",
    "data": {
        "jobId": "7cea558a-6da0-41cd-863f-e90d5866b076",
        "progress": null,
        "mode": "fast",
        "prompt": "blue-eyed cat",
        "quota": "0",
        "images": null,
        "hookUrl": "https://webhook-test.com/bf74f63b0d51ba1b3090e295aae057fe",
        "submitTime": "2025-07-30T05:39:16Z",
        "finishTime": null
    }
}

返回JSON结构详解

name

value

status

PENDING_QUEUE //排队中

ON_QUEUE //执行中

SUCCESS //成功 FAILED //失败

images

生成的图片文件，midjourney的官方cdn地址，注意：存在有效期，使用请自行转存

quota

实际消耗额度

PreviousMidjourney Video API NextFlux API

Last updated 4 days ago

Was this helpful?