Инструкция по интеграции Flux Images Generation API

​

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

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

​

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

• 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, после чего результат можно получить путём опроса соответствующего интерфейса запроса задач.

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

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

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"
}'

​

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

• 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
    }
  ]
}

​

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

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

{
  "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
      }
    }
  ]
}

​

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

• 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"
}

​

Заключение