Перейти к содержанию

midjourney

midjourney — семейство моделей для генерации и обработки изображений через CDNvideo AI Hub media API.

Base URL

https://api.cdnvideo.ru/app/aihub-router/v1/media

Для работы используется обычный ключ AI Hub в заголовке Authorization. Модель для маршрутизации передаётся в X-Model:

Authorization: Bearer ${AIHUB_API_KEY}
X-Model: midjourney

Асинхронная обработка

midjourney не возвращает готовое изображение сразу. Методы создания, перерисовки и улучшения возвращают id задачи. Чтобы получить финальные URL изображений, опрашивайте GET /tob/job/{jobId} до статуса 2.

Создание изображения

POST /tob/diffusion

Метод создаёт задачу генерации изображения по текстовому промпту.

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

Поле Тип Обязательное Описание
text string Да Промпт и параметры midjourney одной строкой. Длина: 1–8192 символов.

Пример curl

curl https://api.cdnvideo.ru/app/aihub-router/v1/media/tob/diffusion \
  -H "Authorization: Bearer ${AIHUB_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "X-Model: midjourney" \
  -d '{
    "text": "A cool racing car speeding on a mountain road --v 7 --ar 16:9 --stylize 250 --fast"
  }'

Ответ

{
  "audits": [],
  "comment": "In progress",
  "id": "67a99aa1f674346b1d1c010f",
  "seed": 0,
  "status": 1,
  "text": "A cool racing car speeding on a mountain road --v 7 --ar 16:9 --stylize 250 --fast",
  "urls": []
}

Проверка статуса задачи

GET /tob/job/{jobId}

Метод возвращает статус задачи и ссылки на изображения, когда обработка завершена.

Path-параметры

Параметр Тип Обязательное Описание
jobId string Да ID задачи из поля id, полученного при создании задачи.

Пример curl

curl https://api.cdnvideo.ru/app/aihub-router/v1/media/tob/job/67a99aa1f674346b1d1c010f \
  -H "Authorization: Bearer ${AIHUB_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "X-Model: midjourney"

Статусы задачи

Статус Описание
0 Задача создана.
1 Задача выполняется.
2 Задача успешно завершена.
3 Задача завершилась ошибкой.

Ответ завершённой задачи

{
  "audits": ["approved"],
  "comment": "Success",
  "id": "3374b3b0-d069-4831-a76b-ebab4df14457",
  "seed": 123456,
  "status": 2,
  "text": "A beautiful high school girl is sitting in the classroom --v 7 --ar 2:1 --draft",
  "urls": ["http://example.com/image1.jpg"]
}

Перерисовка области

POST /tob/inpaint

Метод создаёт задачу перерисовки выбранной области изображения.

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

Поле Тип Обязательное Описание
imageNo integer Да Номер изображения из исходной генерации: 0, 1, 2 или 3.
jobId string Да ID исходной задачи.
mask object Да Маска областей для перерисовки.
mask.areas array<object> Да Список областей. Поддерживается несколько областей.
mask.areas[].height integer Да Высота изображения в пикселях: 500–4096.
mask.areas[].width integer Да Ширина изображения в пикселях: 500–4096.
mask.areas[].points array<integer> Да Координаты многоугольника области в формате [x1,y1,x2,y2,...].
remixPrompt string Нет Промпт для перерисовки области. Длина: 1–8192 символов.

Пример curl

curl https://api.cdnvideo.ru/app/aihub-router/v1/media/tob/inpaint \
  -H "Authorization: Bearer ${AIHUB_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "X-Model: midjourney" \
  -d '{
    "imageNo": 0,
    "jobId": "67a96a41fc0b6392b58e4285",
    "remixPrompt": "A new cinematic lighting style",
    "mask": {
      "areas": [
        {
          "height": 1024,
          "width": 1024,
          "points": [169, 673, 561, 687, 607, 847, 186, 847]
        }
      ]
    }
  }'

Улучшение качества

POST /tob/upscale

Метод создаёт задачу HD-обработки выбранного изображения.

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

Поле Тип Обязательное Описание
imageNo integer Да Номер изображения из исходной генерации: 0, 1, 2 или 3.
jobId string Да ID исходной задачи.
type integer Да Тип HD-обработки: 0 — subtle HD для v6, niji6, v6.1, v7; 1 — creative HD для v6, niji6, v6.1, v7.

Пример curl

curl https://api.cdnvideo.ru/app/aihub-router/v1/media/tob/upscale \
  -H "Authorization: Bearer ${AIHUB_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "X-Model: midjourney" \
  -d '{
    "imageNo": 0,
    "jobId": "67a99bbff674346b1d1c015c",
    "type": 1
  }'

Формат ответа

Методы POST /tob/diffusion, POST /tob/inpaint и POST /tob/upscale возвращают одинаковую структуру задачи.

Поле Тип Описание
audits array<string> Результаты проверки изображений. Пустой массив означает, что задача принята. В завершённой задаче может соответствовать индексам в urls.
comment string Детальное описание текущего состояния задачи.
id string ID задачи. Используйте его как jobId при проверке статуса или последующей обработке.
seed integer Seed генерации.
status integer Статус задачи: 0, 1, 2 или 3.
text string Исходный текстовый промпт.
urls array<string> URL изображений. До завершения задачи обычно возвращается пустой массив.

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

Параметры midjourney передаются внутри поля text после основного описания изображения.

A beautiful landscape at sunrise --v 7 --ar 16:9 --seed 123456 --stylize 500 --fast
Параметр Алиасы Описание Значения и ограничения
Aspect Ratio --aspect, --ar Соотношение сторон. Только целочисленные соотношения, например 139:100 вместо 1.39:1. По умолчанию 1:1. Экстремальные значения вроде 1:10 или 10:1 могут работать нестабильно.
Chaos --chaos, --c Управляет случайностью и разнообразием результатов. 0–100. При 0 изображения ближе друг к другу по стилю.
Character Reference --cref Позволяет воспроизводить персонажа между изображениями. Несовместим с v7.
Role Weight --cw Вес персонажа при использовании --cref. Для v6* и niji 6: 0–100.
Negative Prompt --no Исключает объекты, стили или признаки из изображения. Например: --no fruits, trees, --no cartoon, --no shadows.
Personalization --profile, --p Использует персональные профили и mood board для стиля. Поддержка зависит от версии модели.
Quality --quality, --q Управляет детализацией и временем обработки. Для v7: по умолчанию 1; 2 — исторический режим; 4 — экспериментальный режим.
Repeat --repeat, --r Генерация нескольких вариаций одним запросом. Сейчас не поддерживается.
Seed --seed Начальное случайное состояние генерации. Обычно 0–4294967295. Одинаковый seed помогает получать похожую композицию при одинаковом промпте.
Stop --stop Останавливает генерацию на заданном уровне готовности. 1–100, по умолчанию 100. Поддержка зависит от версии.
Original Mode --raw Более прямое следование промпту без сильной стилизации. Поддержка зависит от версии.
Stylization --stylize, --s Баланс реализма и художественности. 0–1000, по умолчанию 100. 0–250 — ближе к промпту, 250–750 — баланс, 750–1000 — более художественно.
Style Reference --sref Переносит визуальную атмосферу референса: цвет, материал, текстуру, свет. Не копирует объекты или персонажей напрямую.
Style Weight --sw Сила влияния style reference. 0–1000, по умолчанию 100.
Style Version --sv Версия алгоритма style reference. 1, 2, 3, 4; для v7 также 5, 6; для v8.1 — 6.
Tile --tile Генерация бесшовных паттернов и текстур. Поддержка зависит от версии.
Model Version --version, --v Выбор версии модели. Например: --v 7, --v 8.1.
Sketch --draft Генерация черновика с меньшей стоимостью обработки. Только для v7.
Weird --weird, --w Делает результат более необычным и сюрреалистичным. 10–300 — слегка необычно, 300–1000 — выраженно нетрадиционно, 1000–3000 — максимально сюрреалистично.
Image Weight --iw Сила влияния image prompt. Для v6*, niji 6, v7, v8.1: 0–3; для v5*, niji 5: 0–2.
Fast Mode --fast Быстрый режим генерации. Поддерживается большинством версий.
Slow Mode --relax Медленный режим генерации. Сейчас не поддерживается.
Turbo Mode --turbo Ультрабыстрый режим генерации. Не поддерживается в v8 и v8.1; используйте --fast или не указывайте режим скорости.
Niji --niji Модель для аниме и восточной эстетики. Например: --niji 6 или --niji 7.
Enumeration {} Пакетная генерация вариантов промпта. Сейчас не поддерживается.
Experimental --exp Экспериментальное управление эстетикой изображения. 0–100, по умолчанию 0. Чем выше значение, тем ниже точность следования промпту и выше разнообразие.
Stealth/Public Mode --stealth, --public Приватный или публичный режим. Сейчас не поддерживается.
Object Reference --oref Универсальная ссылка на объект на изображении, развитие --cref. Поддерживается для v7.
Object Reference Weight --ow Вес универсального object reference. Для v7: 1–1000. Используется вместе с --oref.

Ограничения

Сейчас не поддерживаются --repeat, персонализация в некоторых режимах, prompt enumeration через {}, а также --public и --stealth. Поддержка отдельных параметров зависит от выбранной версии midjourney.

Совместимость параметров

Параметр v6* niji 6 niji 7 v7 v8.1
--raw ✅ ✅ ✅ ✅ ✅
--tile ✅ ✅ ❌ ✅ ❌
--chaos 0–100 0–100 0–100 0–100 0–100
--seed 0–4294967295 0–4294967295 0–4294967295 0–4294967295 0–4294967295
--stop 10–100 10–100 ❌ ❌ ❌
--weird 0–3000 0–3000 0–3000 0–3000 ❌
--stylize 0–1000 0–1000 0–1000 0–1000 0–1000
--quality 0.5, 1, 2 0.5, 1, 2 ❌ 1, 2, 4 1, 4
HD-обработка ❌ ❌ ❌ ❌ ✅
--fast ✅ ✅ ✅ ✅ ✅
--turbo ✅ ✅ ✅ ✅ ❌
--relax ❌ ❌ ❌ ❌ ❌
Image Prompt ✅ ✅ ✅ ✅ ✅
--iw 0–3 0–3 0–2 0–3 0–3
--no >= 6.1 ❌ ❌ ✅ ❌
--sref ✅ ✅ ✅ ✅ ✅
--cref ✅ ✅ ❌ ❌ ❌
--cw 0–100 0–100 ❌ ❌ ❌
--sv 1–4 1–4 1–4 1–6 6
--sw 0–1000 0–1000 0–1000 0–1000 0–1000
--repeat ❌ ❌ ❌ ❌ ❌
--draft ❌ ❌ ❌ ✅ ❌
--oref ❌ ❌ ❌ ✅ ❌
--ow ❌ ❌ ❌ 1–1000 ❌
--exp ❌ ❌ ❌ 0–100 0–100
--profile ✅ ❌ ✅ ✅ ✅

Пример с параметрами версии

curl https://api.cdnvideo.ru/app/aihub-router/v1/media/tob/diffusion \
  -H "Authorization: Bearer ${AIHUB_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "X-Model: midjourney" \
  -d '{
    "text": "A beautiful and youthful high school girl is sitting in the classroom, with a bright smile on her face. --v 7 --aspect 2:1 --draft --turbo"
  }'