Інтеграція та використання Midjourney Tasks API

Основна функція Midjourney Tasks API полягає в тому, щоб за допомогою введеного ID завдання, отриманого з Midjourney Imagine API або Midjourney Describe API, перевіряти стан виконання цього завдання. Цей документ детально описує інтеграцію Midjourney Tasks API, щоб допомогти вам легко інтегрувати та повністю використовувати потужні можливості цього API. За допомогою Midjourney Tasks API ви можете легко реалізувати перевірку стану виконання завдань Midjourney Imagine API або Midjourney Describe API.

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

Щоб використовувати Midjourney Imagine API, спочатку перейдіть до консолі Ace Data Cloud для отримання вашого API Token, залиште його на випадок потреби.

Якщо ви ще не увійшли в систему або не зареєстровані, вас автоматично перенаправлять на сторінку входу, де ви зможете зареєструватися та увійти, після чого ви будете автоматично повернені на цю сторінку. Один API Token дозволяє викликати всі послуги платформи, не потрібно окремо подавати заявку на кожну послугу. Перший запит на отримання токена надає безкоштовний ліміт, щоб ви могли безкоштовно протестувати; якщо ліміт вичерпано, ви можете поповнити загальний баланс в консолі.

📘 Повна документація: Midjourney Imagine API →

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

Midjourney Tasks API можна використовувати для перевірки результатів як Midjourney Imagine API, так і Midjourney Describe API. Щоб дізнатися, як використовувати Midjourney Imagine API, будь ласка, зверніться до документації Midjourney Imagine API. Щоб дізнатися, як використовувати Midjourney Describe, зверніться до Midjourney Describe API. Розглянемо приклад з ID завдання, повернутим сервісом Midjourney Imagine API. Припустимо, у нас є ID завдання: 7489df4c-ef03-4de0-b598-e9a590793434, далі покажемо, як передати цей ID.

Приклад завдання

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

Request Headers включає:

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

Request Body включає:

id: ID завдання, яке потрібно перевірити.
ids: масив ID завдань для пакетного запиту.
action: спосіб виконання дії над завданням, підтримує retrieve (одиночний запит) та retrieve_batch (пакетний запит).

Налаштування виглядає, як показано на малюнку нижче:

Приклад коду

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

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

CURL

curl -X POST 'https://api.acedata.cloud/midjourney/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "7489df4c-ef03-4de0-b598-e9a590793434",
  "action": "retrieve"
}'

Python

import requests

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

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

payload = {
    "id": "7489df4c-ef03-4de0-b598-e9a590793434",
    "action": "retrieve"
}

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

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

Після успішного запиту API поверне детальну інформацію про завдання зображення. Наприклад:

{
  "_id": "668aae3f550a4144a540803b",
  "id": "7489df4c-ef03-4de0-b598-e9a590793434",
  "application_id": "9dec7b2a-1cad-41ff-8536-d4ddaf2525d4",
  "created_at": 1720364607.967,
  "started_at": 1720364608.027,
  "finished_at": 1720364637.404,
  "elapsed": 29.377,
  "credential_id": "68253cc8-505d-47f4-97ad-0050a62e4975",
  "request": {
    "mode": "fast",
    "prompt": "Кіт, що сидить на столі",
    "action": "generate"
  },
  "type": "imagine",
  "hold": false,
  "image_id": "1259525319472185344",
  "job_id": "da317da6-f500-48e6-bf32-dd48b3e6f84f",
  "response": {
    "image_url": "https://platform.cdn.acedata.cloud/midjourney/7489df4c-ef03-4de0-b598-e9a590793434.png?imageMogr2/thumbnail/!50p",
    "image_width": 1024,
    "image_height": 1024,
    "actions": [
      "upscale1",
      "upscale2",
      "upscale3",
      "upscale4",
      "reroll",
      "variation1",
      "variation2",
      "variation3",
      "variation4"
    ],
    "raw_image_url": "https://platform.cdn.acedata.cloud/midjourney/7489df4c-ef03-4de0-b598-e9a590793434.png",
    "raw_image_width": 2048,
    "raw_image_height": 2048,
    "progress": 100,
    "image_id": "1259525319472185344",
    "task_id": "7489df4c-ef03-4de0-b598-e9a590793434",
    "success": true,
    "job_id": "da317da6-f500-48e6-bf32-dd48b3e6f84f",
    "hold": false
  }
}

Повернене значення містить кілька полів, поле request є тими даними, які були надіслані під час створення завдання, а поле response є відповіддю, отриманою після завершення завдання. Якщо type = imagine, його результат відповідає запиту та відповіді Midjourney Imagine API, якщо type = describe, його результат відповідає запиту та відповіді Midjourney Describe API. Ось опис полів.

id, ID завдання на створення цього зображення, використовується для унікальної ідентифікації цього завдання на створення зображення.
type, якщо type = imagine, це результат Midjourney Imagine API, якщо type = describe, це результат Midjourney Describe API.
job_id, ID завдання на запит зображення, використовується для унікальної ідентифікації цього запиту.
image_id, унікальний ідентифікатор зображення для цього запиту, який потрібно передати при наступних операціях зміни зображення.
request, інформація про запит у завданні на зображення.
response, інформація про відповідь у завданні на зображення.
created_at, час створення завдання, Unix-час (секунди, з плаваючою комою).
started_at, час початку виконання завдання, Unix-час (секунди, з плаваючою комою).
finished_at, час завершення завдання, Unix-час (секунди, з плаваючою комою). Це поле не повертається, якщо завдання не завершено.
elapsed, час виконання завдання, вимірюється в секундах (з плаваючою комою, з точністю до 3 знаків після коми). Це поле не повертається, якщо завдання не завершено.

Пакетний запит

Це запит для перевірки деталей кількох ID завдань, на відміну від попереднього, тут потрібно вибрати action як retrieve_batch. Request Body включає:

ids：масив ID завантажених завдань.
action：спосіб виконання операції над завданням.

Налаштування, як показано на малюнку нижче:

Приклад коду

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

Частина прикладів коду наведена нижче:

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

Після успішного запиту API поверне конкретну інформацію про всі завдання з пакетної обробки зображень. Наприклад:

{
  "items": [
    {
      "_id": "668aae3f550a4144a540803b",
      "id": "7489df4c-ef03-4de0-b598-e9a590793434",
      "application_id": "9dec7b2a-1cad-41ff-8536-d4ddaf2525d4",
      "created_at": 1720364607.967,
      "started_at": 1720364608.027,
      "finished_at": 1720364637.404,
      "elapsed": 29.377,
      "credential_id": "68253cc8-505d-47f4-97ad-0050a62e4975",
      "request": {
        "mode": "fast",
        "prompt": "Кіт, що сидить на столі",
        "action": "generate"
      },
      "type": "imagine",
      "hold": false,
      "image_id": "1259525319472185344",
      "job_id": "da317da6-f500-48e6-bf32-dd48b3e6f84f",
      "response": {
        "image_url": "https://platform.cdn.acedata.cloud/midjourney/7489df4c-ef03-4de0-b598-e9a590793434.png?imageMogr2/thumbnail/!50p",
        "image_width": 1024,
        "image_height": 1024,
        "actions": [
          "upscale1",
          "upscale2",
          "upscale3",
          "upscale4",
          "reroll",
          "variation1",
          "variation2",
          "variation3",
          "variation4"
        ],
        "raw_image_url": "https://platform.cdn.acedata.cloud/midjourney/7489df4c-ef03-4de0-b598-e9a590793434.png",
        "raw_image_width": 2048,
        "raw_image_height": 2048,
        "progress": 100,
        "image_id": "1259525319472185344",
        "task_id": "7489df4c-ef03-4de0-b598-e9a590793434",
        "success": true,
        "job_id": "da317da6-f500-48e6-bf32-dd48b3e6f84f",
        "hold": false
      }
    },
    {
      "_id": "668b41d6550a4144a551d996",
      "id": "807f62de-c63e-4add-8345-7f0ae6dd18e7",
      "application_id": "9dec7b2a-1cad-41ff-8536-d4ddaf2525d4",
      "created_at": 1720402390.341,
      "started_at": 1720402390.401,
      "finished_at": 1720402419.813,
      "elapsed": 29.412,
      "credential_id": "6fd3e1d5-4bd6-47e8-8872-fab89a183b53",
      "request": {
        "mode": "fast",
        "prompt": "Красива дівчина",
        "action": "generate"
      },
      "type": "imagine",
      "hold": false,
      "image_id": "1259683790612070400",
      "job_id": "ede5c805-e231-498c-8f74-3aa76d5d6d12",
      "response": {
        "image_url": "https://platform.cdn.acedata.cloud/midjourney/807f62de-c63e-4add-8345-7f0ae6dd18e7.png?imageMogr2/thumbnail/!50p",
        "image_width": 1024,
        "image_height": 1024,
        "actions": [
          "upscale1",
          "upscale2",
          "upscale3",
          "upscale4",
          "reroll",
          "variation1",
          "variation2",
          "variation3",
          "variation4"
        ],
        "raw_image_url": "https://platform.cdn.acedata.cloud/midjourney/807f62de-c63e-4add-8345-7f0ae6dd18e7.png",
        "raw_image_width": 2048,
        "raw_image_height": 2048,
        "progress": 100,
        "image_id": "1259683790612070400",
        "task_id": "807f62de-c63e-4add-8345-7f0ae6dd18e7",
        "success": true,
        "job_id": "ede5c805-e231-498c-8f74-3aa76d5d6d12",
        "hold": false
      }
    }
  ],
  "count": 2
}

Повернуті результати містять кілька полів, серед яких items містить конкретну інформацію про пакетні завдання зображень, кожне завдання має таку ж структуру полів, як і в попередньому запиті на одне завдання. Поля інформації наведені нижче.

items — всі конкретні деталі пакетних завдань зображень. Це масив, кожен елемент якого має таку ж структуру, як і результати запиту на одне завдання.
count — кількість пакетних запитів на зображення.

CURL

curl -X POST 'https://api.acedata.cloud/midjourney/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "retrieve_batch",
  "id": "",
  "ids": ["7489df4c-ef03-4de0-b598-e9a590793434","807f62de-c63e-4add-8345-7f0ae6dd18e7"]
}'

Python

import requests

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

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

payload = {
    "action": "retrieve_batch",
    "id": "",
    "ids": ["7489df4c-ef03-4de0-b598-e9a590793434","807f62de-c63e-4add-8345-7f0ae6dd18e7"]
}

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

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

При виклику 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 Tasks API для запиту конкретної інформації про одне або пакетні завдання зображень. Сподіваємося, що цей документ допоможе вам краще інтегрувати та використовувати цей API. Якщо у вас є будь-які питання, будь ласка, звертайтеся до нашої технічної підтримки.

Getting Started

AI Чат

AI Зображення

AI Відео

AI Аудіо

Веб і дані

CAPTCHA

Ідентичність

Проксі

Advanced

Coding

Інтеграція та використання Midjourney Tasks API

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

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

Приклад завдання

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

Приклад коду

CURL

Python

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

Пакетний запит

Приклад коду

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

CURL

Python

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

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

Висновок

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

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

​Приклад завдання

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

​Приклад коду

​CURL

​Python

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

​Пакетний запит

​Приклад коду

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

​CURL

​Python

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

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

​Висновок

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

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

Приклад завдання

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

Приклад коду

CURL

Python

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

Пакетний запит

Приклад коду

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

CURL

Python

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

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

Висновок