跳转到主要内容
POST
/
v1
/
midjourney
/
generations
/
edits
curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "replace the background with a modern kitchen, keep the product unchanged --ar 1:1",
    "image_urls": [
      "https://example.com/product.png"
    ],
    "version": "8.1",
    "speed": "fast"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "replace the background with a modern kitchen, keep the product unchanged --ar 1:1",
    "image_urls": [
      "https://example.com/product.png"
    ],
    "version": "8.1",
    "speed": "fast"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
基于已有图 + prompt 改写整张图。适合背景替换、风格迁移、内容修改。
项目内容
actionEDITS
计费midjourney@edits[-speed]
必填prompt + image_urls

​
参数

字段类型必填默认说明
promptstring是—编辑指令
image_urlsstring[]是—待编辑图；单图 ≤ 12 MiB
speedstring否relaxrelax / fast / turbo
metadataobject否—自定义元数据

​
结构化参数（可选）

同 Imagine，可写在 body 里或 prompt 中（如 --ar 16:9），body 优先级高于 prompt，会拼到 prompt 末尾并覆盖同名手写 flag。
字段类型等价 MJ 参数说明
sizestring--ar宽高比，如 "16:9", "1:1", "9:16"
qualitystring--q质量："0.25", "0.5", "1", "2"
stylestring--style风格："raw" 等
versionstring--v版本号。主版本会追加为 --v <version>；与 niji: true 搭配 "7" / "6" 时会归一化为 Niji 版本
seedint--seed随机种子
negative_promptstring--no负面提示词，如 "ugly, blurry"
stylizeint--s风格化强度 (0-1000)
chaosint--c混乱度 (0-100)
weirdint--w怪异度 (0-3000)
tilebool--tile平铺模式
nijibool--nijiNiji 开关。推荐传 niji: true + version: "7" / "6"
iwfloat--iw图片权重 (0-3)，垫图时使用
cwint--cw角色权重 (0-100)
swint--sw风格权重 (0-1000)
crefstring--cref角色参考图 URL
srefstring--sref风格参考图 URL
drefstring--dref深度参考图 URL
dwfloat--dw深度权重 (0-100)
repeatint--repeat重复生成次数 (2-40)
rawbool--raw原始风格 (v5.1+ 支持)
draftbool--draft草图模式 (v7+ 支持)
hdbool--hdHD 高清 (仅 v8 / v8.1，未传 version 时后端自动补 --v 8.1)
stopint--stop提前停止 (10-100，仅 v5-6.1 / niji 5-6)
extrastring任意 --xxx逃生口，原样追加到 prompt 末尾

​
请求示例

{
  "prompt": "replace the background with a modern kitchen, keep the product unchanged --ar 1:1",
  "image_urls": ["https://example.com/product.png"],
  "version": "8.1",
  "speed": "fast"
}

​
响应

提交返回 task_id，SUCCESS 后含编辑结果 image_urls（可能 1–4 张）+ grid_image_url。

​
注意

  • 与 imagine 垫图的区别：edits 重在”改写整张图”，imagine + 垫图重在”参考风格”。
  • 缺 prompt 或 image_urls 返回 400；单图超 12 MiB 返回 400。