Опис інтеграції 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"
}

​

Висновок