Midjourney Upload Paint

midjourney-uploadpaint Midjourney Uploadpaint фокусируется на более точном редактировании холста и маски; полезна для локальных точечных изменений вместо широкой переинтерпретации.

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

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

Эндпоинты

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

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

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

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

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

curl --location "https://api.odirouter.ai/model/v1/queue/midjourney-uploadpaint" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "imgUrl": "https://example.com/reference-image.webp",
    "canvas": {
      "width": 1024,
      "height": 1024
    },
    "imgPos": {
      "x": 128,
      "y": 128,
      "width": 768,
      "height": 768
    },
    "mask": {
      "url": "https://example.com/mask.png"
    },
    "remixPrompt": "Keep the red apple and make the background brighter, clean studio style."
  }'

imgUrl string required

URL изображения. Должен быть корректным HTTP/HTTPS URL длиной не более 1024 символов.

canvas object required

Canvas object.

width integer required

Ширина в пикселях.

height integer required

Высота в пикселях.

imgPos object required

Положение и размер изображения относительно холста.

x integer required

Горизонтальное смещение от левого верхнего угла холста.

y integer required

Вертикальное смещение от левого верхнего угла холста.

width integer required

Ширина в пикселях.

height integer required

Высота в пикселях.

mask object required

Параметры маски. Должны содержать areas или url.

areas array

Массив объектов области маски. Ширина изображения в пикселях должна быть в диапазоне 500 - 4096, высота изображения в пикселях — в диапазоне 500 - 4096. Координаты многоугольника используют левый верхний угол как начало координат, задаются по часовой стрелке в формате XYXY и содержат не менее 6 значений координат (3 точки).

url string

URL черно-белого бинарного изображения маски или данные в формате Base64. Белые области будут перерисованы.

remixPrompt string required

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

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

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

В поле 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-uploadpaint/requests/mmsu_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/midjourney-uploadpaint/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/midjourney-uploadpaint/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	Текущая позиция в очереди.