Flux Images Generation API интеграция

В этой статье будет представлено руководство по интеграции Flux Images Generation API, который позволяет генерировать изображения от Flux, вводя пользовательские параметры.

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

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

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

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

Основное использование

Сначала ознакомьтесь с основным способом использования, который заключается в вводе подсказки prompt, действия action, размера изображения size, чтобы получить обработанный результат. Сначала необходимо просто передать поле action, значение которого будет generate, затем нам нужно ввести подсказку, конкретное содержание выглядит следующим образом:

Как видно, мы настроили заголовки запроса, включая:

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

Также настроено тело запроса, включая:

action: действие для этой задачи по генерации изображения.
size: размер результата генерации изображения. Серии flux-2-flex / flux-2-pro / flux-2-max должны передавать соотношение сторон изображения (например, 1:1, 16:9), не принимаются размеры пикселей типа 1024x1024, по умолчанию будет возвращен 400.
count: количество генерируемых изображений, значение по умолчанию - 1, этот параметр действителен только для задач по генерации изображений, для редактирования он не действителен.
prompt: подсказка.
model: модель генерации, по умолчанию flux-dev; последняя флагманская модель - flux-2-pro, flux-2-max (более высокое качество, необходимо совместить с соотношением сторон size).
callback_url: URL, на который нужно вернуть результат.
async: необязательный, если установлен в true, интерфейс немедленно возвращает task_id, не нужно предоставлять callback_url, затем через соответствующий интерфейс запроса задач можно опрашивать для получения результата.

Параметр size имеет некоторые специальные ограничения, которые в основном делятся на два типа: соотношение width x height и соотношение x:y, конкретно:

Модель	Диапазон
flux-dev	Поддерживает соотношение 1024x1024, 1024x1792, 1792x1024 или соотношение изображения
flux-pro	Поддерживает соотношение 1024x1024, 1024x1792, 1792x1024 или соотношение изображения
flux-2-flex	Поддерживает только соотношение изображения
flux-2-pro	Поддерживает только соотношение изображения
flux-2-max	Поддерживает только соотношение изображения
flux-kontext-pro	Поддерживает только соотношение изображения
flux-kontext-max	Поддерживает только соотношение изображения

Справочные соотношения изображений: “21:9”, “16:9”, “4:3”, “3:2”, “1:1”, “2:3”, “3:4”, “9:16”, “9:21”. После выбора параметров справа автоматически сгенерируется соответствующий код. Перед копированием убедитесь, что заголовок авторизации использует ваш собственный API Key, в документации и скриншотах не должно быть реальных учетных данных. Нажмите кнопку «Try», чтобы провести тестирование, и мы получили следующий результат:

{
  "success": true,
  "task_id": "5456c749-3bbb-4f10-9eb8-cfbcac297500",
  "trace_id": "ae4eecb8-1dd6-45b4-bfb3-a1c48872536e",
  "data": [
    {
      "image_url": "https://platform2.cdn.acedata.cloud/flux/5456c749-3bbb-4f10-9eb8-cfbcac297500.jpg"
    }
  ]
}

Возвращаемый результат содержит несколько полей, описание которых следующее:

success: статус задачи по генерации видео в данный момент.
task_id: ID задачи по генерации видео в данный момент.
trace_id: ID отслеживания видео в данный момент.
data: список результатов задачи по генерации изображения в данный момент.
- image_url: ссылка на задачу по генерации изображения в данный момент.
- prompt: подсказка.

Как видно, мы получили удовлетворительную информацию об изображении, нам нужно только получить сгенерированное изображение Flux по ссылке изображения из data. Кроме того, если вы хотите сгенерировать соответствующий код интеграции, вы можете просто скопировать его, например, код CURL выглядит следующим образом:

curl -X POST 'https://api.acedata.cloud/flux/images' \
-H 'authorization: Bearer {token}' \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "prompt": "A photorealistic studio product shot of a frosted-glass perfume bottle on wet black slate, single softbox key light, water droplets, dark moody background, 85mm macro.",
  "model": "flux-2-pro",
  "size": "1:1"
}'

Редактирование задачи изображения

Если вы хотите отредактировать определенное изображение, сначала параметр image_url должен содержать ссылку на изображение, которое нужно редактировать, в этом случае action поддерживает только edit, и вы можете указать следующее содержание:

model: модель, используемая для этой задачи редактирования изображения, поддерживает flux-dev, flux-pro, flux-kontext-pro, flux-kontext-max, flux-2-flex, flux-2-pro, flux-2-max.
image_url: загруженное изображение, которое нужно редактировать.

Пример заполнения выглядит следующим образом:

После заполнения автоматически сгенерировался следующий код:

Соответствующий код:

import requests

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

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

payload = {
    "action": "edit",
    "prompt": "a white siamese cat",
    "model": "flux-kontext-pro",
    "image_url": "https://cdn.acedata.cloud/ytj2qy.png"
}

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

Нажмите «Запустить», и вы сразу получите результат, как показано ниже:

{
  "success": true,
  "task_id": "2a7979ff-1f77-4380-92c6-a2dc37c3b4c8",
  "trace_id": "732b65c0-48d9-49f7-b568-64e5acffe4c0",
  "data": [
    {
      "prompt": "a white siamese cat",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "timings": 1752744073
    }
  ]
}

Можно увидеть, что сгенерированный эффект является результатом редактирования оригинального изображения, результат схож с вышеупомянутым.

Асинхронный обратный вызов

Поскольку время генерации API Flux Images Generation относительно долгое, примерно 1-2 минуты, если API долго не отвечает, HTTP-запрос будет поддерживать соединение, что приведет к дополнительному потреблению системных ресурсов, поэтому этот API также предоставляет поддержку асинхронного обратного вызова. Общий процесс таков: когда клиент инициирует запрос, дополнительно указывается поле callback_url, после того как клиент инициирует API-запрос, API немедленно возвращает результат, содержащий информацию о поле task_id, представляющем текущий ID задачи. Когда задача завершена, результат сгенерированного изображения будет отправлен на указанный клиентом callback_url в формате POST JSON, который также включает поле task_id, так что результат задачи можно связать по ID. Ниже мы рассмотрим пример, чтобы понять, как именно это работает. Во-первых, Webhook-обратный вызов — это служба, которая может принимать HTTP-запросы, разработчики должны заменить его на URL своего собственного HTTP-сервера. Здесь для удобства демонстрации используется публичный пример сайта Webhook https://webhook.site/, открыв этот сайт, вы получите URL Webhook, как показано на изображении:

Скопировав этот URL, вы можете использовать его в качестве Webhook, пример здесь: https://webhook.site/3d32690d-6780-4187-a65c-870061e8c8ab. Далее мы можем установить поле callback_url на указанный выше URL Webhook, одновременно заполнив соответствующие параметры, конкретное содержание показано на изображении:

Нажав “Запустить”, можно сразу получить результат, как показано ниже:

{
  "task_id": "6a97bf49-df50-4129-9e46-119aa9fca73c"
}

Через некоторое время мы можем наблюдать результат сгенерированного изображения на https://webhook.site/3d32690d-6780-4187-a65c-870061e8c8ab, как показано на изображении:

Содержимое следующее:

{
  "success": true,
  "task_id": "6a97bf49-df50-4129-9e46-119aa9fca73c",
  "trace_id": "9b4b1ff3-90f2-470f-b082-1061ec2948cc",
  "data": [
    {
      "prompt": "a white siamese cat",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "seed": 1698551532,
      "timings": {
        "inference": 3.328
      }
    }
  ]
}

Можно увидеть, что в результате есть поле task_id, остальные поля аналогичны вышеупомянутым, с помощью этого поля можно связать задачи.

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

При вызове 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"
}

Заключение

С помощью этого документа вы узнали, как использовать API Flux Images Generation для генерации изображений по введенным подсказкам. Надеемся, что этот документ поможет вам лучше интегрировать и использовать этот API. Если у вас есть какие-либо вопросы, пожалуйста, не стесняйтесь обращаться в нашу техническую поддержку.

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

AI Чат

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

AI Видео

AI Аудио

Веб и данные

CAPTCHA

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

Прокси

Продвинутый

Coding

Flux Images Generation API интеграция

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

Основное использование

Редактирование задачи изображения

Асинхронный обратный вызов

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

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

Заключение

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

​Основное использование

​Редактирование задачи изображения

​Асинхронный обратный вызов

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

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

​Заключение

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

Основное использование

Редактирование задачи изображения

Асинхронный обратный вызов

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

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

Заключение