AI SETUPAPI
Платформа
API-документация

Midjourney

Публичное API для интеграции моделей генерации изображений

Midjourney

Создание изображений на Midjourney v7, Midjourney v8.1

POSThttps://api.aisetup.ru/v1/images/generations
Header:Authorization: Bearer YOUR_KEY

Параметры

ПараметрТипОписание
modelstringИмя модели: "midjourney-7" или "midjourney-8-1".
webhook_url*stringURL для webhook (необязателен), поллинг GET /v1/requests/{id}.
inputobjectПараметры запроса.
↳ promptstringПромпт для генерации изображения.
* — опциональные поля.

Пример запроса

curl -s "https://api.aisetup.ru/v1/images/generations" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"midjourney-8-1","webhook_url":"https://your.site/hook","input":{"prompt":"a cat on the moon"}}'

Ответы API

Структура ответа

ПолеТипОписание
idstringID запроса (execution id)
statusstringrunning (задача принята).

Пример тела ответа (JSON)

{
  "id": "REQUEST_ID",
  "status": "running"
}

Получение результата

Формат ответа, webhook или polling (единый для всех моделей), подробнее в карточке «Проверка статуса запроса»

Midjourney: действия с изображением

Асинхронные follow-up действия (variation, pan) для ранее созданного изображения

POSThttps://api.aisetup.ru/v1/images/actions
Header:Authorization: Bearer YOUR_KEY

Параметры

ПараметрТипОписание
request_idstringID предыдущего выполненного запроса (из ответа 202 Accepted генерации).
actionstringДействие: variation | pan (pan на 8+ версиях не поддерживается).
image_indexintegerИндекс изображения в сетке 2×2 (0–3).
webhook_url*stringURL для webhook (необязателен), поллинг GET /v1/requests/{id}.
input*objectДополнительные параметры.
↳ type*integerДля variation: 0 = subtle (тонкая), 1 = strong (сильная). По умолчанию 0.
↳ direction*integerДля pan (только v7): 0 = Down, 1 = Right, 2 = Up, 3 = Left.
↳ scale*integerМасштаб для pan (только v7). По умолчанию 2.
* — опциональные поля.

Пример запроса

curl -s "https://api.aisetup.ru/v1/images/actions" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"request_id":"PREV_REQUEST_ID","action":"variation","image_index":0,"webhook_url":"https://your.site/hook"}'

Ответы API

Структура ответа

ПолеТипОписание
idstringID нового запроса (execution id).
statusstringrunning (задача принята).

Пример тела ответа (JSON)

{
  "id": "NEW_REQUEST_ID",
  "status": "running"
}

Получение результата

Формат ответа, webhook или polling (единый для всех моделей), подробнее в карточке «Проверка статуса запроса»

Midjourney: описание изображения

Описание загруженного изображения

POSThttps://api.aisetup.ru/v1/images/generations
Header:Authorization: Bearer YOUR_KEY

Параметры

ПараметрТипОписание
modelstring"midjourney-7" или "midjourney-8-1".
webhook_url*stringURL для webhook (необязателен), поллинг GET /v1/requests/{id}.
inputobjectПараметры запроса.
↳ image_urlstringURL изображения для описания.
* — опциональные поля.

Пример запроса

curl -s "https://api.aisetup.ru/v1/images/generations" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"midjourney-8-1","webhook_url":"https://your.site/hook","input":{"image_url":"https://your.site/photo.jpg"}}'

Ответы API

Структура ответа

ПолеТипОписание
idstringID запроса (execution id) для поллинга.
statusstringrunning (задача принята).

Пример тела ответа (JSON)

{
  "id": "REQUEST_ID",
  "status": "running"
}

Получение результата

Формат ответа, webhook или polling (единый для всех моделей), подробнее в карточке «Проверка статуса запроса»