← Блог

Midjourney V7 по API: флаги в промпте и когда она нужнее V8

· 8 минут чтения

В бэкенде уже лежит строка промпта, а в ней — привычные флаги и sref-код, собранные на V7. Вы меняете модель по умолчанию и вдруг получаете другой визуальный ряд, хотя текст не трогали. Если эти промпты кормят работающий продукт, V7 проще оставить отдельным маршрутом, чем переписывать всё за один заход.

Почему V7 ещё остаётся в работе

V7 Alpha вышла 4.04.2025, а 17.06.2025 её сделали версией по умолчанию. За это время вокруг модели успели вырасти библиотеки промптов, наборы style reference и код, который собирает строку запроса из шаблонов. Для такого кода переход на другую версию — не замена имени модели.

Версией по умолчанию 11.06.2026 стала V8.1, а 24.07.2026 появилась V8.2. Новая ветка не обязана повторить старый результат, даже если вы отправляете тот же текст. Я бы не переносил рабочую генерацию вслепую: сначала прогнал бы её на своей выборке и посмотрел, что происходит со стилем, композицией и привычными референсами.

V7 нужна не потому, что она новее или лучше. Она нужна там, где у вас уже есть проверенная строка промпта и цена переподбора результата выше, чем поддержка отдельной модели. Это обычная инженерная развилка: не ломать то, что даёт предсказуемый выход.

Флаги пишутся прямо в промпте

У V7 нет отдельных JSON-полей для настройки генерации. Все управляющие флаги мы передаём внутри поля prompt, то есть строка остаётся одновременно описанием сцены и набором настроек. Если ваше приложение уже умеет собирать такие строки, менять его логику почти не придётся.

URL картинки-референса ставьте в начале промпта, до текстового описания. Флаги добавляйте в конец через пробел: так парсеру проще отделить содержание запроса от инструкций. Например, в одной строке могут жить описание сцены, --ar, --s и --sref.

  • --ar задаёт соотношение сторон — кадр не станет вертикальным там, где интерфейс ждёт широкий баннер.

  • --s управляет силой фирменной стилизации модели.

  • --sref переносит стиль по URL изображения или по коду стиля.

Строка промпта Midjourney V7: описание сцены и флаги --ar, --s, --sref в конце, всё уходит одним полем prompt.
У V7 настройки живут в самой строке промпта, отдельных полей для них нет.

Промпт в таком подходе — не просто текст для модели, а часть контракта вашего приложения. Храните его целиком вместе с шаблоном, а не раскладывайте флаги по несуществующим полям запроса. Если вы только собираете такие шаблоны, посмотрите наш материал о том, как писать промпты.

Что приходит в ответ на вызов

Для V7 используем POST на /v1/images/generations с моделью midjourney-v7. Один вызов возвращает сетку до четырёх картинок, а ссылки лежат в массиве data. Параметра n здесь нет: попросить одну картинку вместо сетки нельзя.

Один запрос к Midjourney V7 возвращает сетку из четырёх картинок, цена указана за весь запрос.
Платите вы за сетку целиком, даже если в интерфейс уйдёт одна картинка.

Это влияет на интерфейс и обработчик ответа. Можно показать пользователю всю сетку и дать выбрать вариант. Можно взять одну ссылку программно, но тогда остальные варианты всё равно уже созданы и оплачены в составе запроса.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ALTROUTER_API_KEY"],
    base_url="https://api.altrouter.ai/v1",
    timeout=180,  # сетка V7 собирается около 44 секунд
)

# Все настройки V7 — флагами в конце строки промпта.
prompt = (
    "old lighthouse on a rocky shore at dusk, warm window light, film grain "
    "--ar 16:9 --s 250 --sref https://example.com/style.jpg"
)

result = client.images.generate(model="midjourney-v7", prompt=prompt)

# Один запрос = сетка: в data приходят ссылки на все четыре картинки.
for i, item in enumerate(result.data, start=1):
    print(i, item.url)

В коде достаточно передать строку промпта с флагами и пройти по data, чтобы получить ссылки на результаты. Базовый адрес — https://api.altrouter.ai/v1, а вызов совместим с привычной схемой OpenAI SDK. Детали полей и ответов собраны в документации по картинкам.

Не пытайтесь вынести --ar или --sref в произвольный JSON-ключ. V7 их там не ждёт. Соберите финальный prompt на своей стороне, сохраните его рядом с задачей и при повторе отправьте без тихих правок.

Как работать со стилем и sref

Новая система Style Reference появилась у V7 16.06.2025. Она переносит атмосферу и палитру с референса, при этом объект с исходной картинки должен меньше попадать в результат. Для поиска направления можно использовать --sref random, но в рабочем сценарии я бы фиксировал итоговый код или URL.

Силу стиля задаёт --sw. Чем выше вес, тем заметнее референс влияет на картинку, поэтому не поднимайте его автоматически для каждого запроса: модель может начать слушать стиль громче, чем саму сцену. Старые sref-коды из V6 для V7 требуют флага --sv 4.

Вендор говорит, что style reference, профили персонализации и эстетика согласованы между V7 и V8.1. Мы это сходство не сравнивали. Если ваши sref-коды участвуют в товарной витрине, игре или рекламных шаблонах, проверьте их на собственных промптах до переноса маршрута.

Цена и время в нашем замере

На 16.09.2026 запрос V7 стоит $0,1012 и возвращает четыре картинки, то есть примерно $0,0253 за картинку. Цена в каталоге приблизительная. У Midjourney нет публичного прайса за картинку по API, сравнивать не с чем; скидку мы не заявляем.

В нашем прогоне 16.09.2026 V7 собрала сетку примерно за 44 секунды, а V8 — примерно за 38 секунд. Это не тест скорости в лаборатории: мы сделали один прогон на модель, нагрузку не выравнивали и время суток не контролировали. Качество результатов вслепую тоже не сравнивали, поэтому из этих секунд можно взять только грубый ориентир для очереди в вашем продукте.

Неприятный, но полезный факт: V7 у нас дороже V8 за запрос. Если старые промпты не привязаны к стилю и флагам, новая модель выглядит разумнее и по времени, и по цене. Если привязаны — сначала посчитайте стоимость перепроверки и переделки шаблонов, а потом сравнивайте строчки прайса.

Границы V7, которые лучше знать заранее

V7 у нас работает только с генерацией по тексту. Правки по картинке у неё нет, поэтому сценарий «взять готовый кадр и изменить одну деталь» придётся строить на V8. Ещё одно ограничение — потолок разрешения 1K.

Флаг --oref нужен, когда вы хотите удержать персонажа или объект по картинке-референсу. Он удваивает списание за запрос; у вендора omni-reference тоже тратит двойное время. Включайте его только там, где узнаваемость объекта важнее обычного текстового описания.

Флаги --exp и --draft, как и результат --oref сверх удвоенного списания, мы через API не проверяли, поэтому не обещаем их поведение и эффект из описаний вендора. Лучше вынесите такие режимы за отдельный переключатель и сначала прогоните на небольшой внутренней задаче.

Когда выбирать V7, а когда V8

Выбор упирается в то, что уже лежит у вас в коде. V7 берите для промптов с флагами, закреплёнными sref-кодами и результатом, который вы уже приняли как рабочий. V8 берите для новых сценариев, отдельных параметров запроса и задач, где нужна правка по картинке.

Сравнение Midjourney V7 и V8 по API: способ настроек, правка по картинке, цена за запрос и время прогона.
Старая модель дороже новой — держать её стоит только ради уже налаженных промптов.

КритерийMidjourney V7Midjourney V8
НастройкиФлаги в тексте промптаОтдельные поля: aspect_ratio, stylize, chaos, weird, raw, seed, negative_prompt
Правка по картинкеУ нас нетЕсть
Цена за запрос на 16.09.2026$0,1012$0,0736
Время прогона 16.09.2026около 44 секундоколо 38 секунд

Не переносите старый маршрут только потому, что V8 дешевле. Сначала возьмите набор реальных промптов, включите в него проблемные sref и проверьте выход глазами команды. Для деталей сравните страницу Midjourney V7, страницу Midjourney V8 и наш разбор Midjourney V8 по API.

Мой вывод простой: V7 сохраняет совместимость с вашим старым способом писать промпты, но за это вы платите более высокой ценой запроса и отказом от правки по картинке. V8 не отменяет V7, а закрывает другой сценарий. Держите обе модели там, где это экономит работу, а не где так красивее выглядит схема.

Создайте ключ и отправьте первый запрос через altrouter.ai. Полный список моделей смотрите в каталоге моделей.

FAQ

Как передавать параметры Midjourney V7 по API?

Передавайте их в строке prompt нативными флагами. URL референса ставьте в начало строки, а --ar, --s и --sref — после текстового описания. Отдельных JSON-полей для этих настроек у V7 нет.

Как работает --sref в Midjourney V7?

--sref переносит стиль с картинки по URL или по коду. Силу влияния регулирует --sw. Для старых кодов, собранных под V6, добавляйте --sv 4.

Сколько стоит картинка Midjourney V7 по API?

На 16.09.2026 запрос стоит $0,1012 и приносит четыре картинки. Приблизительная цена одной картинки — $0,0253. Цена в каталоге приблизительная, а публичного прайса за картинку по API у Midjourney нет.

Чем Midjourney V7 отличается от V8 по API?

V7 принимает настройки флагами в промпте, а V8 — отдельными полями запроса. V8 поддерживает правку по картинке, V7 — нет. В нашем единичном прогоне V8 пришла быстрее и стоила меньше за запрос.

Можно ли редактировать картинку в Midjourney V7 по API?

Нет, V7 у нас генерирует только по тексту. Для правки по картинке используйте V8. Если вам нужно сохранить старый стиль V7, сначала получите исходную сетку через V7, а сценарий дальнейшей правки тестируйте отдельно.