Перейти до основного вмісту
Основна функція 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

curl -X POST 'https://api.acedata.cloud/midjourney/describe' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image_url": "https://cdn.acedata.cloud/kg7xp3.png"
}'

​
Python

import requests

url = "https://api.acedata.cloud/midjourney/describe"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "image_url": "https://cdn.acedata.cloud/kg7xp3.png"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

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

Після успішного запиту API поверне 4 описи зображення. Наприклад: 
{
  "descriptions": [
    "Дорожній знак у формі хреста стоїть посеред відкритого парку, оточений деревами та травами. На фоні сонячно, з теплими кольорами. Сонце світить крізь листя на частину знака. З одного боку цього стовпа також є інший знак з написом \"Kunming Park\", який виглядає дуже красиво. Це фото показує, якою чудовою може бути природа. Воно викликає у людей відчуття розслаблення або спокою в стилі природи. --ar 75:44",
    "Фото дорожнього знака \"K鬥\" у парку, з деревами та травою з обох боків. Попереду легкий жовтий металевий стовп з двома знаками, прикріпленими до нього. На фоні сонце світить крізь зелене листя на одну сторону вулиці, створюючи теплу атмосферу. Також є водяна пара, що плаває навколо. Це було знято в стилі камери Sony A7R IV з об'єктивом Leica M. Ця сцена передає спокій і гармонію між природою та людським творінням. --ar 75:44",
    "Дорожній знак у формі хреста стоїть посеред відкритого парку, оточений деревами та травами. Сонце світить крізь листя на частину знака, створюючи теплий світловий ефект. Попереду є дорога, що веде до іншого зеленого простору. Також є деяка інформація про \"Inside Shilin Park\" з одного боку цього стовпа. Ця сцена викликає у людей відчуття спокою та гармонії з природою. Природне освітлення, 3D рендеринг у стилі Unreal Engine, реалістичний стиль фотографії. --ar 75:44",
    "Знак у формі хреста стоїть у парку, оточений пишними деревами та яскравою зеленою травою під сонячним світлом. Знаки говорять \"VIDEO ANNattacks\" на невідомій мові, створюючи атмосферу таємниці та інтриги. Сцена знята у високій роздільній здатності за допомогою камер Canon EOS R5, представляючи вражаючий візуальний ефект, що демонструє складні деталі в стилі сучасної фотографії. --ar 75:44"
  ]
}
Як видно, у результаті є поле descriptions, яке містить чотири результати, кожен з яких є кандидатом на опис.

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

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

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

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
Висновок

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