FLUX.2 Pro Edit

Обзор

FLUX.2 Pro Edit — модель для редактирования изображений по текстовой инструкции в линейке FLUX.2 от Black Forest Labs, представлена в ноябре 2025 года. Официальная документация описывает для редактирования изображений FLUX.2 работу с промптом и несколькими референсами, а для Pro — продакшен-уровень и быстрый оборот в высоконагруженных сценариях. Эта разновидность нужна для задач Image-to-Image: заменить фон, изменить свет и стиль, объединить элементы из референсов, сохранить идентичность объекта или персонажа. Среди соседних моделей Pro занимает середину между максимальной точностью Max, специализированным контролем Flex и быстрым прототипированием Klein: это рабочая версия для стабильного качества без выбора самого тяжёлого режима. Главное: модель особенно полезна там, где важны реалистичные правки, следование сложной инструкции и сохранение визуальной согласованности результата.

Сильные стороны

Сценари использования (use cases)

Ограничения и недостатки

Примеры промптов

Советы

• При нескольких референсах описывайте роль каждого изображения: «объект из изображения 1», «фон из изображения 2», «стиль из изображения 3». Black Forest Labs рекомендует явно указывать, что брать из каждого входа; без этого модель неверно комбинирует референсы в задачах композитинга.
• Указывайте в промпте и конкретное изменение, и что должно остаться без изменений. В гайдах по редактированию с одним референсом действует правило: чем точнее инструкция, тем лучше сохраняется неизменяемая часть кадра. Это базовый принцип FLUX.2 Edit.
• Фиксируйте seed, когда сравниваете варианты промпта при тех же входных изображениях и размере. Seed обеспечивает воспроизводимость результата; удобен при итерации формулировок без лишней случайной вариативности между запусками.
• Не используйте расплывчатые команды вроде «сделай лучше», «улучши свет» или «исправь изображение». В официальных руководствах Black Forest Labs такие формулировки прямо указаны как нежелательные: модель не понимает целевое состояние и может непредсказуемо изменять кадр.
• Не пишите негативный промпт — FLUX.2 его не поддерживает. Общая особенность семейства FLUX.2: вместо «без размытия» описывайте желаемый результат — «резкий фокус по всему кадру».

FAQ

Цены

Параметры

Поля тела JSON-запроса, которые используются в Playground и доступны для настройки через API. Порядок совпадает с формой на странице.

Запрос

Асинхронный запуск: POST https://api.flixa.io/v1/image/flux-2/pro-edit с заголовком Authorization: Bearer $FLIXA_API_KEY и телом JSON. Ниже — пример с полями из Playground.

curl -X POST "https://api.flixa.io/v1/image/flux-2/pro-edit" \
  -H "Authorization: Bearer $FLIXA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "seed": -1,
  "size": "768*1024",
  "images": [
    "https://uploads.flixa.io/media/285a253e8ecd6cbda4f36a3d89f0f8b1cfc915c5bf2dc798a6a7c29a6ff4f046.jpg"
  ],
  "prompt": "Превратите это фото товара в премиальную студийную рекламу: мягкий кинематографический свет, чистый бежевый фон, лёгкие тени, реалистичные отражения и эстетика люксового бренда."
}'

import json
import os
import requests

url = "https://api.flixa.io/v1/image/flux-2/pro-edit"
payload = json.loads({"images": ["https://uploads.flixa.io/media/285a253e8ecd6cbda4f36a3d89f0f8b1cfc915c5bf2dc798a6a7c29a6ff4f046.jpg"], "prompt": "\u041f\u0440\u0435\u0432\u0440\u0430\u0442\u0438\u0442\u0435 \u044d\u0442\u043e \u0444\u043e\u0442\u043e \u0442\u043e\u0432\u0430\u0440\u0430 \u0432 \u043f\u0440\u0435\u043c\u0438\u0430\u043b\u044c\u043d\u0443\u044e \u0441\u0442\u0443\u0434\u0438\u0439\u043d\u0443\u044e \u0440\u0435\u043a\u043b\u0430\u043c\u0443: \u043c\u044f\u0433\u043a\u0438\u0439 \u043a\u0438\u043d\u0435\u043c\u0430\u0442\u043e\u0433\u0440\u0430\u0444\u0438\u0447\u0435\u0441\u043a\u0438\u0439 \u0441\u0432\u0435\u0442, \u0447\u0438\u0441\u0442\u044b\u0439 \u0431\u0435\u0436\u0435\u0432\u044b\u0439 \u0444\u043e\u043d, \u043b\u0451\u0433\u043a\u0438\u0435 \u0442\u0435\u043d\u0438, \u0440\u0435\u0430\u043b\u0438\u0441\u0442\u0438\u0447\u043d\u044b\u0435 \u043e\u0442\u0440\u0430\u0436\u0435\u043d\u0438\u044f \u0438 \u044d\u0441\u0442\u0435\u0442\u0438\u043a\u0430 \u043b\u044e\u043a\u0441\u043e\u0432\u043e\u0433\u043e \u0431\u0440\u0435\u043d\u0434\u0430.", "seed": -1, "size": "768*1024"})

response = requests.post(
    url,
    headers={"Authorization": f"Bearer {os.environ['FLIXA_API_KEY']}"},
    json=payload,
    timeout=120,
)
print(response.json())

const response = await fetch(
  "https://api.flixa.io/v1/image/flux-2/pro-edit",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.FLIXA_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"images": ["https://uploads.flixa.io/media/285a253e8ecd6cbda4f36a3d89f0f8b1cfc915c5bf2dc798a6a7c29a6ff4f046.jpg"], "prompt": "\u041f\u0440\u0435\u0432\u0440\u0430\u0442\u0438\u0442\u0435 \u044d\u0442\u043e \u0444\u043e\u0442\u043e \u0442\u043e\u0432\u0430\u0440\u0430 \u0432 \u043f\u0440\u0435\u043c\u0438\u0430\u043b\u044c\u043d\u0443\u044e \u0441\u0442\u0443\u0434\u0438\u0439\u043d\u0443\u044e \u0440\u0435\u043a\u043b\u0430\u043c\u0443: \u043c\u044f\u0433\u043a\u0438\u0439 \u043a\u0438\u043d\u0435\u043c\u0430\u0442\u043e\u0433\u0440\u0430\u0444\u0438\u0447\u0435\u0441\u043a\u0438\u0439 \u0441\u0432\u0435\u0442, \u0447\u0438\u0441\u0442\u044b\u0439 \u0431\u0435\u0436\u0435\u0432\u044b\u0439 \u0444\u043e\u043d, \u043b\u0451\u0433\u043a\u0438\u0435 \u0442\u0435\u043d\u0438, \u0440\u0435\u0430\u043b\u0438\u0441\u0442\u0438\u0447\u043d\u044b\u0435 \u043e\u0442\u0440\u0430\u0436\u0435\u043d\u0438\u044f \u0438 \u044d\u0441\u0442\u0435\u0442\u0438\u043a\u0430 \u043b\u044e\u043a\u0441\u043e\u0432\u043e\u0433\u043e \u0431\u0440\u0435\u043d\u0434\u0430.", "seed": -1, "size": "768*1024"}),
  }
);

console.log(await response.json());

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

Сразу после POST приходит объект с идентификатором задачи и статусом (queued или processing). Готовый результат — в поле outputs после завершения.

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "created_at": "2026-05-22T12:00:00Z"
}

После успешного завершения:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "outputs": [
    { "url": "https://storage.example/result.png", "type": "image" }
  ]
}

Поллинг

Пока задача в работе, опрашивайте GET https://api.flixa.io/v1/predictions/{id}/result с тем же API-ключом. Рекомендуемый интервал — 1–2 секунды; остановитесь при completed, failed или cancelled.

• queued / processing — продолжайте опрос.
• completed — заберите URL из outputs.
• failed — смотрите error в теле ответа.

curl "https://api.flixa.io/v1/predictions/{id}/result" \
  -H "Authorization: Bearer $FLIXA_API_KEY"