Midjourney 8.2 API

Параметры

Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.

promptОбязательно

Что нарисовать. Только обычный текст: параметры Midjourney (--ar, --v и другие), ссылки и варианты в фигурных скобках не принимаются, для настроек и картинок есть поля. Версии 8.2 и 8.1 сами сокращают описание длиннее примерно 1000 знаков, версия 7 берёт текст целиком.

Тип: СтрокаМинимум символов: 1Максимум символов: 6000

aspect_ratioНеобязательно

Пропорции картинки: ширина и высота целыми числами через двоеточие, только цифры и без пробелов, например 1:1, 16:9, 9:16, 4:5, 2:3, 21:9.

Тип: СтрокаМаксимум символов: 11По умолчанию: "1:1"

speedНеобязательно

Скорость. Relaxed дешевле, но ждёт в очереди, Fast быстрее и дороже. От неё зависит цена.

Тип: СтрокаДопустимые значения: relaxedfastПо умолчанию: "relaxed"

stylizationНеобязательно

Насколько художественно: 0 строго по описанию, 1000 больше всего красоты, но дальше от описания. Не задано: 100.

Тип: Целое числоМинимум: 0Максимум: 1000

chaosНеобязательно

Насколько разными будут четыре картинки: 0 похожие, 100 самые разные.

Тип: Целое числоМинимум: 0Максимум: 100

weirdnessНеобязательно

Необычность: 0 обычная картинка, 3000 сюрреализм и абстракция.

Тип: Целое числоМинимум: 0Максимум: 3000

raw_modeНеобязательно

Без художественной обработки Midjourney: результат ближе к обычному фото.

Тип: Да/нетПо умолчанию: false

tileНеобязательно

Бесшовный узор, который можно повторять во все стороны: обои, ткани, фоны.

Тип: Да/нетПо умолчанию: false

seedНеобязательно

Начальное число. Одинаковые число и описание дают похожий результат. Не задано: случайное.

Тип: Целое числоМинимум: 0Максимум: 4294967295

exclusionsНеобязательно

Чего не должно быть на картинке, словами через запятую, например: text, people, blur.

Тип: СтрокаМаксимум символов: 500

image_promptsНеобязательно

Картинки-подсказки: Midjourney возьмёт с них сюжет, композицию и цвета. До 4 ссылок.

Тип: Список (Строка, uri)Максимум элементов: 4

iwНеобязательно

Сила картинок-подсказок: 0 почти не влияют, 3 сильнее всего. Не задано: 1. Действует только вместе с картинками-подсказками.

Тип: ЧислоМинимум: 0Максимум: 3

style_ref_imagesНеобязательно

Образцы стиля: переносятся манера, цвета и настроение, но не сами предметы. До 3 ссылок.

Тип: Список (Строка, uri)Максимум элементов: 3

sref_codeНеобязательно

Код стиля Midjourney, только цифры, например 123456789. Можно вместе с образцами стиля.

Тип: Строка

swНеобязательно

Сила стиля: 0 почти не влияет, 1000 сильнее всего. Не задано: 100. Действует только вместе с образцами стиля или кодом стиля.

Тип: Целое числоМинимум: 0Максимум: 1000

enable_translationНеобязательно

Перевести описание на английский перед генерацией. Если перевод не удастся или в нём окажутся параметры, ссылки или варианты в скобках, уйдёт исходное описание.

Тип: Да/нетПо умолчанию: false

edit_imagesНеобязательно

Фото, по которым Midjourney нарисует новую картинку: перенесёт человека, персонажа или предмет в новую сцену, поменяет одежду или фон, покажет с другой стороны, соберёт несколько фото в одну сцену. Что сделать, пишите в prompt. До 4 ссылок. Пропорции результата задаёт aspect_ratio, а не фото. Не сочетается с tile.

Тип: Список (Строка, uri)Максимум элементов: 4

Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.

Эти настройки API задаёт сам, передавать их не нужно: plain_text = true rework_button = false

Входные данные

• Картинки передаются ссылками на JPEG, PNG или WebP до 10 МБ каждая, картинка для правки по маске только PNG. Ссылка должна открываться без входа и без переадресации.
• Описание и исключения только обычным текстом: без параметров Midjourney, ссылок и вариантов в фигурных скобках. Настройки и картинки задаются полями.

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

Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.

{
  "model": "midjourney",
  "settings": {
    "version": "8.2",
    "prompt": "A cozy reading nook by a rainy window, warm lamp light, film photo",
    "aspect_ratio": "3:2",
    "speed": "fast",
    "stylization": 250
  }
}

{
  "model": "midjourney",
  "settings": {
    "version": "8.2",
    "prompt": "Рыжий кот спит на подоконнике, за окном вечерний город",
    "aspect_ratio": "4:5",
    "enable_translation": true,
    "exclusions": "text, watermark"
  }
}

{
  "model": "midjourney",
  "settings": {
    "version": "8.2",
    "prompt": "A lighthouse on a cliff at dusk, waves crashing below",
    "aspect_ratio": "16:9",
    "style_ref_images": [
      "https://example.com/style-sample.jpg"
    ],
    "sw": 300
  }
}

{
  "model": "midjourney",
  "settings": {
    "version": "8.2",
    "prompt": "Make this woman wear a red silk gown on a seaside terrace at sunset, full body",
    "aspect_ratio": "2:3",
    "raw_mode": true,
    "edit_images": [
      "https://example.com/person.jpg"
    ]
  }
}

{
  "model": "midjourney",
  "settings": {
    "version": "8.2",
    "prompt": "Make the jacket yellow and turn the background into a snowy forest",
    "aspect_ratio": "4:5",
    "edit_images": [
      "https://example.com/photo.jpg"
    ]
  }
}

Цена считается при приёме задачи, валюта RUB.

Результат

• Четыре картинки JPEG за один запуск, каждая отдельным файлом.
• С Fast результат обычно через минуту, Relaxed ждёт в очереди дольше.
• Увеличение и вариации готовых картинок есть только в боте.

Так выглядит готовая задача в ответе GET /v1/tasks/{id} (часть полей опущена). Подпись caption бывает у задачи или у отдельного файла и может быть пустой, имя файла задаёт модель.

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Подпись к результату: модель и настройки",
    "texts": [],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "image",
        "filename": "image.jpg",
        "size": 1843200,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      },
      {
        "index": 1,
        "kind": "image",
        "filename": "image.jpg",
        "size": 1843200,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/1"
      },
      {
        "index": 2,
        "kind": "image",
        "filename": "image.jpg",
        "size": 1843200,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/2"
      },
      {
        "index": 3,
        "kind": "image",
        "filename": "image.jpg",
        "size": 1843200,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/3"
      }
    ]
  }
}