Skip to main content
Основна функція Midjourney Describe API полягає в отриманні опису зображення шляхом його завантаження. Для використання цього API потрібно лише передати адресу файлу зображення, API поверне детальний опис зображення. Не потрібно складних налаштувань параметрів, щоб отримати якісний опис зображення. Підтримуються різні формати зображень: незалежно від того, чи це JPEG, PNG чи GIF, всі основні формати зображень можуть бути легко розпізнані та оброблені. Цей документ детально описує інтеграцію Midjourney Describe API, щоб допомогти вам легко інтегрувати та повністю використовувати потужні можливості цього API. За допомогою Midjourney Describe API ви можете легко автоматизувати опис зображень, підвищуючи ефективність бізнесу.

Процес подачі заявки

Щоб використовувати Midjourney Describe API, спочатку потрібно перейти на сторінку подачі заявки Midjourney Describe API, після переходу на сторінку натисніть кнопку «Acquire», як показано на малюнку: Сторінка подачі заявки Якщо ви ще не увійшли в систему або не зареєстровані, вас автоматично перенаправлять на сторінку входу, запрошуючи вас зареєструватися та увійти. Після входу або реєстрації ви автоматично повернетеся на поточну сторінку. При першій подачі заявки вам буде надано безкоштовний ліміт, щоб ви могли безкоштовно використовувати цей API.

Приклад запиту

Розглянемо приклад зображення, щоб продемонструвати, як використовувати цей API. Припустимо, у нас є зображення пейзажу, далі покажемо, як завантажити це зображення та отримати опис.

Приклад запиту зображення

Приклад зображення

Налаштування заголовків запиту та тіла запиту

Request Headers включає:
  • accept: вказує на прийняття відповіді у форматі JSON, тут вказується application/json.
  • authorization: ключ для виклику API, після подачі заявки можна вибрати безпосередньо зі списку.
Request Body включає:
  • image_url: адреса завантаженого файлу зображення.
Налаштування, як показано на малюнку:

Приклад коду

Можна помітити, що на правій стороні сторінки автоматично згенеровано код на різних мовах, як показано на малюнку:

Деякі приклади коду наведені нижче:

CURL

Python

Приклад відповіді

Після успішного запиту API поверне 4 описи зображення. Наприклад:
Як видно, у результаті є поле descriptions, яке містить чотири результати, кожен з яких є кандидатом на опис.

Обробка помилок

При виклику API, якщо виникає помилка, API поверне відповідний код помилки та інформацію. Наприклад:
  • 400 token_mismatched: Неправильний запит, можливо, через відсутні або недійсні параметри.
  • 400 api_not_implemented: Неправильний запит, можливо, через відсутні або недійсні параметри.
  • 401 invalid_token: Неавторизовано, недійсний або відсутній токен авторизації.
  • 429 too_many_requests: Занадто багато запитів, ви перевищили ліміт запитів.
  • 500 api_error: Внутрішня помилка сервера, щось пішло не так на сервері.

Приклад відповіді на помилку

Висновок

Завдяки цьому документу ви дізналися, як використовувати Midjourney Describe API для опису зображень. Сподіваємося, що цей документ допоможе вам краще інтегрувати та використовувати цей API. Якщо у вас є будь-які питання, будь ласка, звертайтеся до нашої команди технічної підтримки.