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://platform2.cdn.acedata.cloud/flux/5456c749-3bbb-4f10-9eb8-cfbcac297500.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"
}

​

Висновок