Интеграция и использование 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, сначала получите ваш API Token в консоли Ace Data Cloud и сохраните его для дальнейшего использования.

Если вы ещё не вошли в систему или не зарегистрировались, вы будете автоматически перенаправлены на страницу входа, где вам будет предложено зарегистрироваться и войти в систему; после завершения вы автоматически вернётесь на текущую страницу. Один 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 (секунды, с плавающей точкой).
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": "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. Если у вас возникнут какие-либо вопросы, пожалуйста, в любое время свяжитесь с нашей командой технической поддержки.

Начало работы

AI Чат

AI Изображение

AI Видео

AI Аудио

Веб и данные

CAPTCHA

Идентичность

Coding

Другие руководства

Интеграция и использование Flux Tasks API

Процесс получения

Пример запроса

Пример изображения задачи

Настройка заголовков и тела запроса

Пример кода

CURL

Python

Пример ответа

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

Пример кода

Пример ответа

CURL

Python

Обработка ошибок

Пример ответа с ошибкой

Заключение

​Процесс получения

​Пример запроса

​Пример изображения задачи

​Настройка заголовков и тела запроса

​Пример кода

​CURL

​Python

​Пример ответа

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

​Пример кода

​Пример ответа

​CURL

​Python

​Обработка ошибок

​Пример ответа с ошибкой

​Заключение

Процесс получения

Пример запроса

Пример изображения задачи

Настройка заголовков и тела запроса

Пример кода

CURL

Python

Пример ответа

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

Пример кода

Пример ответа

CURL

Python

Обработка ошибок

Пример ответа с ошибкой

Заключение