获取 API Key 获取 API
文档

Edits(图片编辑)

基于已有图 + prompt 改写整张图。适合背景替换、风格迁移、内容修改

请求示例

curl --request POST \
  --url https://api.openveer.com/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 改写整张图。适合背景替换、风格迁移、内容修改。

项目 内容
action EDITS
计费 midjourney@edits[-speed]
必填 prompt + image_urls

参数

字段 类型 必填 默认 说明
prompt string 是 — 编辑指令
image_urls string[] 是 — 待编辑图;单图 ≤ 12 MiB
speed string 否 relax relax / fast / turbo
metadata object 否 — 自定义元数据

结构化参数(可选)

同 Imagine,可写在 body 里或 prompt 中(如 --ar 16:9),body 优先级高于 prompt,会拼到 prompt 末尾并覆盖同名手写 flag。

字段 类型 等价 MJ 参数 说明
size string --ar 宽高比,如 "16:9", "1:1", "9:16"
quality string --q 质量:"0.25", "0.5", "1", "2"
style string --style 风格:"raw" 等
version string --v 版本号。主版本会追加为 --v <version>;与 niji: true 搭配 "7" / "6" 时会归一化为 Niji 版本
seed int --seed 随机种子
negative_prompt string --no 负面提示词,如 "ugly, blurry"
stylize int --s 风格化强度 (0-1000)
chaos int --c 混乱度 (0-100)
weird int --w 怪异度 (0-3000)
tile bool --tile 平铺模式
niji bool --niji Niji 开关。推荐传 niji: true + version: "7" / "6"
iw float --iw 图片权重 (0-3),垫图时使用
cw int --cw 角色权重 (0-100)
sw int --sw 风格权重 (0-1000)
cref string --cref 角色参考图 URL
sref string --sref 风格参考图 URL
dref string --dref 深度参考图 URL
dw float --dw 深度权重 (0-100)
repeat int --repeat 重复生成次数 (2-40)
raw bool --raw 原始风格 (v5.1+ 支持)
draft bool --draft 草图模式 (v7+ 支持)
hd bool --hd HD 高清 (仅 v8.1 / v8.2,未传 version 时后端自动补 --v 8.1)
stop int --stop 提前停止 (10-100,仅 v5-6.1 / niji 5-6)
extra string 任意 --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。