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

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

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

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

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

📘 Повна документація: Flux Images Generation API →

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

API Flux Tasks можна використовувати для перевірки результатів API Flux Images Generation. Щоб дізнатися, як використовувати API Flux Images Generation, будь ласка, зверніться до документації Flux Images Generation API. Розглянемо приклад з ID завдання, яке повертає сервіс API Flux Images Generation. Припустимо, у нас є ID завдання: 2db0168c-2373-4367-8d9a-9dc778802e8a, далі ми покажемо, як передати це ID.

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

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

Request Headers включає:

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

Request Body включає:

id: ID завдання, яке потрібно перевірити.
action: спосіб виконання дії над завданням.

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

Приклад коду

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

Частина прикладів коду виглядає так:

CURL

curl -X POST 'https://api.acedata.cloud/flux/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "2c454ff3-4f8f-47f0-8147-acb29a84d1c2",
  "action": "retrieve"
}'

Python

import requests

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

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

payload = {
    "id": "2c454ff3-4f8f-47f0-8147-acb29a84d1c2",
    "action": "retrieve"
}

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

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

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

{
  "_id": "677de81d550a4144a5f4cf62",
  "id": "2db0168c-2373-4367-8d9a-9dc778802e8a",
  "api_id": "deefc5d7-7f22-43e9-929e-f2b6afee60b7",
  "application_id": "001c2f84-2a4a-4c4d-ba3f-8a89f43b5be2",
  "created_at": 1736304669.779,
  "started_at": 1736304669.839,
  "finished_at": 1736304679.439,
  "elapsed": 9.6,
  "credential_id": "b00bddd3-140f-4343-a9a2-affb312b60de",
  "request": {
    "action": "generate",
    "size": "1024x1024",
    "prompt": "a white siamese cat"
  },
  "trace_id": "6624929c-bb80-40c0-81e8-d96af8405d19",
  "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
  "response": {
    "success": true,
    "task_id": "2db0168c-2373-4367-8d9a-9dc778802e8a",
    "trace_id": "6624929c-bb80-40c0-81e8-d96af8405d19",
    "data": [
      {
        "prompt": "a white siamese cat",
        "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
        "seed": 281520112,
        "timings": {
          "inference": 3.193
        }
      }
    ]
  }
}

У відповіді є кілька полів, поле request - це тіло запиту, яке було надіслано для створення завдання, а поле response - це тіло відповіді, яке повертається після завершення завдання. Ось опис полів.

id: 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": "677de81d550a4144a5f4cf62",
      "id": "2db0168c-2373-4367-8d9a-9dc778802e8a",
      "api_id": "deefc5d7-7f22-43e9-929e-f2b6afee60b7",
      "application_id": "001c2f84-2a4a-4c4d-ba3f-8a89f43b5be2",
      "created_at": 1736304669.779,
      "started_at": 1736304669.839,
      "finished_at": 1736304679.439,
      "elapsed": 9.6,
      "credential_id": "b00bddd3-140f-4343-a9a2-affb312b60de",
      "request": {
        "action": "generate",
        "size": "1024x1024",
        "prompt": "білий сіамський кіт"
      },
      "trace_id": "6624929c-bb80-40c0-81e8-d96af8405d19",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "response": {
        "success": true,
        "task_id": "2db0168c-2373-4367-8d9a-9dc778802e8a",
        "trace_id": "6624929c-bb80-40c0-81e8-d96af8405d19",
        "data": [
          {
            "prompt": "білий сіамський кіт",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "seed": 281520112,
            "timings": {
              "inference": 3.193
            }
          }
        ]
      }
    },
    {
      "_id": "677de950550a4144a5f52963",
      "id": "72bdd69d-290d-4710-a6d4-60c78968865a",
      "api_id": "deefc5d7-7f22-43e9-929e-f2b6afee60b7",
      "application_id": "001c2f84-2a4a-4c4d-ba3f-8a89f43b5be2",
      "created_at": 1736304976.278,
      "started_at": 1736304976.338,
      "finished_at": 1736304985.938,
      "elapsed": 9.6,
      "credential_id": "b00bddd3-140f-4343-a9a2-affb312b60de",
      "request": {
        "action": "generate",
        "size": "1024x1024",
        "prompt": "білий сіамський кіт"
      },
      "trace_id": "1dca4b49-d31d-42e6-83d9-7f0c56f62d31",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "response": {
        "success": true,
        "task_id": "72bdd69d-290d-4710-a6d4-60c78968865a",
        "trace_id": "1dca4b49-d31d-42e6-83d9-7f0c56f62d31",
        "data": [
          {
            "prompt": "білий сіамський кіт",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "seed": 1437672535,
            "timings": {
              "inference": 3.175
            }
          }
        ]
      }
    }
  ],
  "count": 2
}

CURL

curl -X POST 'https://api.acedata.cloud/flux/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["2db0168c-2373-4367-8d9a-9dc778802e8a","72bdd69d-290d-4710-a6d4-60c78968865a"],
  "action": "retrieve_batch"
}'

Python

import requests

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

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

payload = {
    "ids": ["2db0168c-2373-4367-8d9a-9dc778802e8a","72bdd69d-290d-4710-a6d4-60c78968865a"],
    "action": "retrieve_batch"
}

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": "отримання не вдалося"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Висновок

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

Getting Started

AI Чат

AI Зображення

AI Відео

AI Аудіо

Веб і дані

CAPTCHA

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

Проксі

Advanced

Coding

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

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

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

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

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

Приклад коду

CURL

Python

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

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

Приклад коду

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

CURL

Python

Помилка обробка

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

Висновок

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

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

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

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

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

​CURL

​Python

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

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

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

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

​CURL

​Python

​Помилка обробка

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

​Висновок

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

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

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

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

Приклад коду

CURL

Python

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

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

Приклад коду

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

CURL

Python

Помилка обробка

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

Висновок