🔥Midjourney Edit API

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

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

编辑图像

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响应。

请求示例

Python

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())

Node

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);
});

响应示例

200

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

400

{
  "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

请求示例

Python

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())

Node

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 结构

SUCCESS

{
  "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"
  }
}

PENDING_QUEUE

{
    "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
    }
}

ON_QUEUE

{
    "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
    }
}

FAILED

{
    "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	实际消耗额度