Skip to main content

Зрозумійте основну концепцію

MidJourney API імітує взаємодію з кнопками Discord. На відміну від типових REST API, він працює як автомат станів де кожна операція повертає нові кнопки для наступного кроку.

4 основні API


Повна схема робочого процесу


Ключова концепція: Buttons і customId

Кожне успішне завдання повертає масив buttons. Кожна кнопка має customId, який використовується для запуску наступної дії. Приклад відповіді від /mj/task/\{id\}/fetch:
customId не є фіксованим значенням. Він змінюється для кожного завдання. Завжди отримуйте його з масиву buttons.

Довідник кнопок за етапами

Після IMAGINE (Після IMAGINE ()

Ці кнопки повертаються після завершення початкової генерації зображення:

Після UPSCALE (Після UPSCALE ()

Після upscaling ви отримуєте доступ до інструментів редагування:
Примітка: Назви кнопок і формати customId можуть відрізнятися залежно від версії MJ, указаної у вашому Prompt (наприклад, --v 6.1 або --v 5.2). Завжди читайте кнопки з відповіді API.
Кнопка Inpaint (Vary Region) з’являється лише після Upscale.

Повний приклад: генерація та upscale

Крок 1: Надішліть запит imagine

Відповідь:

Крок 2: Опитуйте статус завдання

Відповідь (після завершення):

Крок 3: Натисніть U1 для upscale

Відповідь:

Крок 4: Опитуйте нове завдання та отримайте результат


Коли потрібен Modal?

Коли ви викликаєте /mj/submit/action і статус завдання змінюється на MODAL замість SUCCESS, необхідно викликати /mj/submit/modal щоб надати додаткові дані.

Підтверджені операції Modal

Приклад: процес Inpaint Запустіть дію Inpaint:
Один раз перевірте нове завдання. Статус MODAL означає, що завданню потрібні маска та Prompt:
Надішліть маску та Prompt через Modal API:

Вибір режиму швидкості

Додайте префікс швидкості до шляху:

Інші точки входу

Ці API є незалежними точками входу які не дотримуються потоку imagine → action:

Поради з усунення несправностей

На основі дизайну API та робочого процесу ось поширені проблеми, з якими ви можете зіткнутися:
Останнє оновлення 31 липня 2026 р.