Перейти к основному содержанию
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. Подходит для замены фона, переноса стиля и изменения содержимого.
ItemЗначение
actionEDITS
Тарификацияmidjourney@edits[-speed]
Обязательноprompt + image_urls

Параметры

ПолеТипОбязат.По умолчаниюОписание
promptstringДаИнструкция редактирования
image_urlsstring[]ДаРедактируемое изображение; каждое ≤ 12 MiB
speedstringНетrelaxrelax / fast / turbo
metadataobjectНетПользовательские метаданные

Структурированные поля (опционально)

Как у Imagine — задавайте в body или в prompt (напр. --ar 16:9). Значения body приоритетны, добавляются к промпту и переопределяют одноимённые флаги, написанные вручную.
ПолеТипЭквивалент 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--seedSeed
negative_promptstring--noнапр. "ugly, blurry"
stylizeint--s0–1000
chaosint--c0–100
weirdint--w0–3000
tilebool--tileРежим плитки
nijibool--nijiПереключатель Niji. Рекомендовано: niji: true + version: "7" / "6"
iwfloat--iw0–3, вес изображения
cwint--cw0–100
swint--sw0–1000
crefstring--crefURL референсного изображения персонажа
srefstring--srefURL референсного изображения стиля
drefstring--drefURL референсного изображения глубины
dwfloat--dwВес глубины (0–100)
repeatint--repeat2–40
rawbool--rawRaw-стиль (v5.1+)
draftbool--draftРежим черновика (v7+)
hdbool--hdHD-режим (только v8 / v8.1; бэкенд авто-подставляет --v 8.1, если version не указан)
stopint--stopРанний останов (10–100; только v5–6.1 / niji 5–6)
extrastringлюбой --xxxEscape hatch; добавляется к промпту дословно

Пример запроса

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

Response

Отправка возвращает task_id; при SUCCESS результат содержит отредактированные image_urls (может быть 1–4) плюс grid_image_url.

Заметки

  • Отличие от наведения по образцу в imagine: edits «перерисовывает изображение целиком», а imagine + референсные изображения «заимствует стиль».
  • Отсутствие prompt или image_urls возвращает 400; одно изображение больше 12 MiB возвращает 400.