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

请求示例

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

响应示例

200

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

400

获取任务状态

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

响应示例

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

异步回调 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

ON_QUEUE

FAILED

返回JSON结构详解

name	value
status	PENDING_QUEUE //排队中 ON_QUEUE //执行中 SUCCESS //成功 FAILED //失败
images	生成的图片文件，midjourney的官方cdn地址，注意：存在有效期，使用请自行转存
quota	实际消耗额度