Генерация изображений Midjourney v8.2 / Niji 7

Используйте асинхронный API изображений по адресу https://apimaster.ai/v1 с одной из моделей midjourney-v8.2 или midjourney-niji-7. Идентификатор модели выбирает версию; не добавляйте поля переопределения версии.

Создание задачи

POST https://apimaster.ai/v1/midjourney/generations

curl -s "https://apimaster.ai/v1/midjourney/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "midjourney-v8.2",
    "prompt": "a quiet Japanese garden at dawn, cinematic composition",
    "size": "16:9",
    "speed": "relax"
  }'

Для Niji 7 установите model в значение midjourney-niji-7:

{"model":"midjourney-niji-7","prompt":"anime character under cherry blossoms","size":"9:16","speed":"fast"}

Поле	Тип	Обязательно	Описание
model	string	Да	midjourney-v8.2 или midjourney-niji-7
prompt	string	Да	Описание изображения, включая поддерживаемые параметры Midjourney
size	string	Нет	Соотношение сторон, например 1:1 или 16:9; по умолчанию 1:1
speed	string	Нет	relax, fast или turbo; по умолчанию relax
image_urls	string[]	Нет	1–20 URL референсных изображений; также поддерживаются Data URL изображений
iw	number	Нет	Вес референсного изображения 0–3; требует image_urls
quality	string	Нет	0.25, 0.5, 1 или 2; не поддерживается в Niji 7
stylize / chaos / weird	integer	Нет	Диапазоны: 0–1000, 0–100 и 0–3000 соответственно
seed	integer	Нет	Случайное зерно (seed) 0–4294967295
negative_prompt	string	Нет	Контент, который нужно исключить
sref / sw	string / integer	Нет	URL публичного референса стиля и вес 0–1000; sw требует sref
dref / dw	string или string[] / number	Нет	URL референсов (до 20) и вес 0–100; dw требует dref
raw / tile / hd	boolean	Нет	Сырой стиль (raw), тайлинг и HD; tile и hd только для v8.2
extra	string	Нет	Строка поддерживаемых параметров, например --ar 16:9 --s 750; структурированные поля имеют приоритет
metadata	object	Нет	Пользовательские бизнес-метаданные
repeat	integer	Нет	2–40, чтобы создать несколько задач

Niji 7 не поддерживает quality, tile=true или hd=true. Обе модели отклоняют draft=true, cref, cw, stop, а также поля запроса version и niji. style=raw нормализуется в raw=true. Не используйте --v или --niji в prompt или extra для переопределения версии модели.

Ответ содержит ID пакета и ID задач:

{
  "id": "imagine_batch_xxxxxxxx",
  "request_id": "req_xxxxxxxx",
  "model": "midjourney-v8.2",
  "status": "queued",
  "data": [{"id": "imagine_xxxxxxxx", "task_id": "imagine_xxxxxxxx", "status": "submitted"}]
}

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

curl -s "https://apimaster.ai/v1/tasks/imagine_batch_xxxxxxxx" \
  -H "Authorization: Bearer YOUR_API_KEY"

Завершённый ответ содержит URL изображений в data; tasks содержит каждую дочернюю задачу:

{
  "id": "imagine_batch_xxxxxxxx",
  "status": "completed",
  "progress": 100,
  "data": [{"url": "https://example.com/generated.png"}],
  "tasks": [{"task_id": "imagine_xxxxxxxx", "status": "completed", "progress": 100, "data": [{"url": "https://example.com/generated.png"}]}]
}

Опрашивайте статус, пока он queued или processing. При сбое прочитайте tasks[].error и не отправляйте тот же запрос повторно. Скачивайте возвращённые URL сразу, поскольку они могут истечь.

Если при отправке возвращается 502 с заголовком X-Task-ID, или запрос возвращает pending_timeout, сохраните ID и продолжайте проверять его статус вместо автоматической повторной отправки. Пакет может содержать как успешные, так и неудачные задачи; проверяйте tasks[] по отдельности. Рекомендуется опрашивать раз в 15 секунд.

Ошибки и стоимость

model и непустой prompt обязательны. Неподдерживаемые версии, неверные соотношения, недоступные референсы и неподдерживаемые параметры возвращают 400. 401 означает недействительный ключ, 402 — недостаточный баланс, 429 — ограничение частоты запросов. См. карточку Midjourney v8.2 и карточку Niji 7, чтобы узнать актуальные цены и маршруты.