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"
}'