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

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

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

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

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

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

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

Flux Tasks API можна використовувати для запиту результатів Flux Images Generation API. Щодо того, як використовувати Flux Images Generation API, дивіться документацію Flux Images Generation API . Ми візьмемо як приклад один ID завдання, повернений сервісом Flux Images Generation API, щоб продемонструвати, як використовувати цей API. Припустімо, у нас є 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 — це request body під час запуску завдання, водночас поле response — це response body, повернене після завершення завдання. Опис полів наведено нижче.

id: ID згенерованого завдання зображення, використовується для унікальної ідентифікації цього завдання генерації зображення.
request: інформація запиту в завданні запиту зображення.
response: інформація відповіді в завданні запиту зображення.
created_at: час створення завдання, Unix timestamp (секунди, число з плаваючою комою).
started_at: час початку виконання завдання, Unix timestamp (секунди, число з плаваючою комою).
finished_at: час завершення завдання, Unix timestamp (секунди, число з плаваючою комою). Якщо завдання не завершено, це поле не повертається.
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": "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
            }
          }
        ]
      }
    },
    {
      "_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": "a white siamese cat"
      },
      "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": "a white siamese cat",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "seed": 1437672535,
            "timings": {
              "inference": 3.175
            }
          }
        ]
      }
    }
  ],
  "count": 2
}

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

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

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": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Висновок

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

Getting Started

AI Чат

AI Зображення

AI Відео

AI Аудіо

Веб і дані

CAPTCHA

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

Coding

Інші посібники

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

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

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

Зображення-приклад завдання

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

Приклад коду

CURL

Python

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

Операція пакетного запиту

Приклад коду

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

CURL

Python

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

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

Висновок

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

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

​Зображення-приклад завдання

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

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

​CURL

​Python

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

​Операція пакетного запиту

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

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

​CURL

​Python

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

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

​Висновок

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

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

Зображення-приклад завдання

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

Приклад коду

CURL

Python

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

Операція пакетного запиту

Приклад коду

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

CURL

Python

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

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

Висновок