Midjourney Variation

midjourney-variation Midjourney Variation создает альтернативные версии существующего изображения. Она полезна для выбора между похожими композициями, выражениями, цветами или стилевыми деталями.

Примечания к интерфейсу MidJourney

Интерфейсы MidJourney делятся на прямую генерацию и вторичное редактирование. Для прямой генерации достаточно передать промпт и другие обязательные поля, чтобы создать изображение. Для вторичного редактирования нужен ID предыдущей задачи и номер изображения из этой задачи. variation относится к категории вторичного редактирования.

Эндпоинты

POST /v1/queue/midjourney-variation # Создать задачу

GET /v1/queue/midjourney-variation/requests/{request_id}/status # Проверить статус

GET /v1/queue/midjourney-variation/requests/{request_id}/response # Получить результат

PUT /v1/queue/midjourney-variation/requests/{request_id}/cancel # Отменить задачу

Параметры запроса

curl --location "https://api.odirouter.ai/model/v1/queue/midjourney-variation" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "jobId": "midjourney_provider_job_id",
    "imageNo": 0,
    "type": 1
  }'

jobId string required

ID задачи.

imageNo int required

Номер изображения. Должен быть 0, 1, 2 или 3.

Варианты: 0, 1, 2, 3

type int required

Тип вариации: 0 — мягкая вариация, 1 — сильная вариация.

Варианты: 0, 1

remixPrompt string

Новый prompt. Параметры Youchuan/Midjourney можно добавить к prompt.

Диапазон длины: 1 - 8192 символов

Параметры промпта

В поле remixPrompt официальные параметры промпта нужно добавлять в конец той же строки, а не передавать как отдельные JSON-поля. В одном промпте можно использовать несколько параметров.

Основные управляющие параметры

Параметр	Значение	Значения и примечания
`--ar` / `--aspect`	Соотношение сторон	Задает соотношение сторон выходного изображения, например `--ar 16:9`. Соотношения больше 2:1 являются экспериментальными и могут давать непредсказуемые результаты.
`::` / `::<weight>`	Мульти-промпт и веса	Разделяет фрагменты промпта двойным двоеточием и при необходимости задает вес, например `space::2 ship`. Сумма весов должна быть положительной.
`{option1,option2}`	Варианты промпта	Использует фигурные скобки для генерации нескольких вариантов промпта, например `a {red,green,yellow} bird`. Каждый сгенерированный вариант тарифицируется отдельно.
`--v` / `--version`	Версия модели	Используйте `--v 8.1`. В примерах и запросах этой документации используется `--v 8.1`.
`--iw`	Вес изображения	Управляет тем, насколько сильно изображения влияют на результат относительно текстового промпта. Значение по умолчанию: `1`.
`--draft`	Черновой режим	Включает более быструю генерацию черновика. Доступность зависит от текущих возможностей модели.
`--no`	Негативный промпт	Указывает контент, который не должен появиться, например `--no plants`.
`--quality` / `--q`	Качество и время рендера	Управляет усилием рендера и расходом GPU. Частые значения: `0.25`, `0.5`, `1`; некоторые версии поддерживают `2`.
`--repeat` / `--r`	Повторная генерация	Создает несколько задач из одного промпта. Официальный диапазон: `1-40`.
`--seed`	Seed	Задает целое число от `0` до `4294967295`. Один и тот же промпт и seed обычно дают похожие результаты.
`--stop`	Ранняя остановка	Останавливает задачу на проценте от `10` до `100`. Более низкие значения обычно дают более размытый результат с меньшим количеством деталей.
`--relax` / `--fast` / `--turbo`	Скорость генерации	Переопределяет текущую настройку и запускает текущую задачу в медленном, быстром или turbo-режиме.
`--stylize` / `--s`	Стилизация	Управляет силой стандартного эстетического алгоритма. Обычно значение по умолчанию `100`; частый диапазон `0-1000`.
`--chaos` / `--c`	Разнообразие	Управляет вариативностью и непредсказуемостью в диапазоне `0-100`. Чем выше значение, тем сильнее отличаются результаты.
`--weird` / `--w`	Необычность	Исследует более нестандартную эстетику. Частый диапазон: `0-3000`.
`--style`	Стилевой режим	Основная модель часто использует `--style raw`, чтобы снизить автоматическую стилизацию. Для Niji 5 доступны `cute`, `expressive`, `original`, `scenic`.
`--exp`	Креативный стиль	Диапазон `0-100`. Более высокие значения обычно делают изображение более детальным, живым и креативным.
`--tile`	Плитка	Генерирует бесшовные повторяемые узоры.

Параметры ссылок на изображение и стиль

Параметр	Значение	Значения и примечания
`--sref <image URL\|style code\|random>`	Ссылка на стиль	Использует визуальный стиль изображения или style code. Можно комбинировать несколько источников, например `--sref URL1::2 URL2::1`.
`--sw`	Вес ссылки на стиль	Управляет силой влияния ссылки на стиль в диапазоне `0-1000`. Обычно значение по умолчанию `100`. `--sw` несовместим с Moodboards.
`--sv`	Версия ссылки на стиль	Выбирает версию алгоритма ссылки на стиль. Доступность зависит от текущих возможностей модели.
`--cref <image URL>`	Ссылка на персонажа	Сохраняет признаки персонажа из референсного изображения. Доступность зависит от текущих возможностей модели.
`--cw`	Вес ссылки на персонажа	Управляет тем, сколько деталей персонажа сохраняется, в диапазоне `0-100`. `--cw 0` сильнее фокусируется на лице; `--cw 100` старается сохранить лицо, волосы, одежду и другие детали.
`--oref <image URL>`	Omni reference	Сохраняет согласованность человека, персонажа, объекта или транспортного средства из референсного изображения. Одновременно можно использовать только одно omni-reference изображение.
`--ow`	Вес omni reference	Управляет силой omni reference в диапазоне `1-1000`. Более высокие значения усиливают согласованность, но слишком высокие могут сделать результат нестабильным.

Примеры

A cinematic sunset landscape, ultra detailed --ar 16:9 --v 8.1 --s 250 --seed 1234
A clean product photo of a glass teapot --oref https://example.com/object.png --ow 300 --sref https://example.com/style.png --sw 120 --no text, watermark

В примерах этой документации используется --v 8.1. Если параметр не срабатывает, ориентируйтесь на текущие возможности модели и ответ платформы.

Параметры ответа

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://api.odirouter.ai/model/v1/queue/midjourney-variation/requests/mmsu_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/midjourney-variation/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/midjourney-variation/requests/mmsu_01hxyz.../cancel",
  "queue_position": 0
}

Поле	Тип	Описание
`request_id`	string	Идентификатор задачи, используемый во всех последующих операциях.
`response_url`	string	URL для получения итогового результата.
`status_url`	string	URL для проверки статуса задачи.
`cancel_url`	string	URL для отмены задачи.
`queue_position`	int	Текущая позиция в очереди.