Black Forest Labs

FLUX.2 Klein 9B

flux-2-klein-9b/image-to-image

Модель изображений на основе rectified flow с 9 млрд параметров, дистиллированная до 4 шагов, объединяющая генерацию изображений по тексту и редактирование с одним или несколькими референсными изображениями в компактной архитектуре, ориентированная на сценарии генерации в реальном времени с низкой задержкой

flux-2-klein-9b/image-to-image flux-2-klein-9b/text-to-image

Попробовать flux-2-klein-9b/image-to-image

Ввод

Работы

Все работы

Вывод

image

Заполните параметры и сгенерируйте — результаты появятся здесь.

Концепт-кадр атмосферы мира: концепт-арт сцены на основе одного референсного изображения

Стиль Концепт-арт · Построение мира · Кинематографичный

Референсные входы

image_urls

Промпт

Отредактируйте референсное изображение в кинематографичный концепт-кадр построения мира: сохраните исходную композицию, линию горизонта и объёмы зданий без изменений, затем сместите атмосферу к холодному синему сумеречному освещению. Добавьте низкий дрейфующий приземный туман, скапливающийся в нижней трети кадра; пусть от центрального здания исходит единственный тёплый янтарный источник света, окаймляющий его края контурным светом; а влажные отражающие каменные поверхности пусть имеют мелкие лужицы. Приведите цветовую тональность к малонасыщенным бирюзово-зелёным и сланцево-серым оттенкам с одним тёплым акцентом, смягчите небо до плоского пасмурного градиента и сохраните матовую, живописную манеру рендера, как при создании концепт-арта, а не фотореализма. Широкоэкранная композиция 16:9 с сильной глубиной от силуэтов переднего плана до дальних горных хребтов, без текста, без людей.

Скопируйте полный промпт и адаптируйте под свою задачу.

Теги

FLUX.2 Klein: переосмысление качества изображений товаров уровня электронной коммерции

Стиль Изображение продукта · электронная коммерция · Студийный свет

Референсные входы

image_urls

Промпт

Студийная фотография товара для электронной коммерции: матовая керамическая воронка для пуровер-кофе с ободком из светлого дуба, расположена по центру на бесшовном светло-сером бумажном фоне с лёгким изгибом пола. Трёхточечная схема освещения: большой софтбокс под углом 45 градусов слева сверху, белый отражатель справа, узкий контровой свет по правому краю отделяет объект от фона. Мягкая затухающая тень справа снизу; без резких зеркальных бликов. Глазурь имеет мягкие отражения, проявляющие керамическую текстуру и открытые поры дерева. Съёмка объективом с эквивалентным фокусным расстоянием 85 мм, диафрагма f/8, камера чуть выше уровня глаз, малая и средняя глубина резкости с чёткой фокусировкой на всём продукте, низкий контраст, нейтральный баланс белого около 5500K, чистая коммерческая цветокоррекция, достаточное свободное пространство над продуктом, композиция 16:9.

Скопируйте полный промпт и адаптируйте под свою задачу.

Теги

Цены

flux-2-klein-9b/image-to-image per image

Цена за единицу	$0.03143

Краткое описание

Модель редактирования изображений на основе архитектуры FLUX.2 klein 9B, вызываемая через единый интерфейс HiAPI.ai. Она принимает одно референсное изображение и текстовую инструкцию по редактированию, изменяет содержимое и стиль исходного изображения согласно описанию и поддерживает указание соотношения сторон и формата вывода. Подходит разработчикам, которым нужно быстро итерировать в режиме «изображение в изображение» и добиваться редактирования с низкой задержкой; может использоваться для прототипирования, переработки контента и других задач.

Ключевые особенности

Инструктивное редактирование по одному референсному изображению — достаточно загрузить одно референсное изображение и дать описание правок, и модель изменит изображение по инструкции без дополнительных масок или сложной предварительной обработки.
Малошаговая генерация — от 4 до 8 шагов — используется дистилляция по шагам: число шагов инференса регулируется в диапазоне от 4 до 8, что позволяет гибко выбирать между качеством и задержкой.
Задаваемые соотношение сторон и формат вывода — поддерживаются пять соотношений 1:1, 4:3, 3:4, 16:9, 9:16 и три формата вывода jpeg, png, webp, что упрощает прямую интеграцию в последующие процессы.

Описание возможностей

Инструктивное редактирование по референсу: на вход подаются изображение в формате jpeg/png/webp и текстовое описание правок; модель генерирует изменённое изображение, что удобно для быстрой проверки идей редактирования.

Регулируемое число шагов инференса: параметр num_inference_steps принимает целые значения от 4 до 8; чем больше шагов, тем богаче детали, чем меньше шагов, тем быстрее отклик — можно выбирать под задачу.

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

Воспроизводимая генерация: параметр seed фиксирует случайное зерно, что упрощает воспроизведение одного и того же результата редактирования при отладке и сравнении.

Сценарии применения

Быстрая итерация визуальных решений дизайнером — загрузите референс стиля и опишите текстом направление правок, чтобы получить несколько версий отредактированных изображений для отбора концепций и обсуждения с клиентом.
Переработка изображений контент-мейкером — на основе имеющихся исходных изображений введите инструкции редактирования и получите изображения со стилизацией или изменённым содержимым для социальных сетей и иллюстраций к статьям.
Проверка цепочки «изображение в изображение» при совместной разработке — с фиксированным seed и небольшим числом шагов инференса быстро получайте изображения, проверяйте параметры интерфейса и последующий конвейер, а результаты используйте для интеграционного тестирования.

Ограничения и рекомендации по выбору

Поддерживается только одно входное референсное изображение, причём входное изображение масштабируется до 1 MP, что ограничивает сохранение деталей высокого разрешения; формат svg не поддерживается. Максимальное число шагов инференса — 8, чего может быть недостаточно для очень высокого качества или тонкого контроля. Модель сосредоточена на редактировании изображений и не охватывает видео, аудио и другие модальности. Если требуется чистая генерация «текст в изображение» или вывод более высокого разрешения, следует рассмотреть другие линейки той же серии или модели с соответствующими возможностями.

Частые вопросы

Все частые вопросы →

Сколько референсных изображений поддерживает редактирование изображений FLUX.2 [klein] 9B?

В настоящее время поддерживается 1 референсное изображение в формате JPEG, PNG или WebP. image_urls должен быть массивом, содержащим только один публичный URL изображения.
Для каких задач редактирования подходит?

Подходит для очистки изображений товаров, замены фона, изменения текста на изображении, корректировки цветовой схемы, а также коммерческой ретуши с сохранением объекта и ракурса.
Как настроить количество шагов инференса?

num_inference_steps поддерживает целые числа от 4 до 8, по умолчанию 4. Текущая цена не меняется в зависимости от количества шагов инференса.
Какие поддерживаются соотношения сторон и форматы?

Поддерживаются соотношения сторон 1:1, 4:3, 3:4, 16:9, 9:16; форматы — JPEG, PNG и WebP.

Создать задачу генерации

POST https://api.hiapi.ai/v1/tasks

Заголовки

AuthorizationstringОбязательно

API-ключ аккаунта. Обязателен в каждом запросе. Пример: Bearer YOUR_HIAPI_API_KEY. Получить API-ключ

Content-TypestringНеобязательно

Тело запроса всегда разбирается как JSON; при отправке принимается только application/json (charset опционален) — любое иное значение возвращает 415. Пример: application/json.

Idempotency-KeystringНеобязательно

Ключ идемпотентности, до 255 байт. Повторные запросы с тем же ключом того же аккаунта создают задачу лишь один раз; реплеи возвращают исходный taskId.

Ключ идемпотентности

При сетевых таймаутах или автоповторах клиента один и тот же ключ создаёт задачу только один раз, без двойного списания (область = аккаунт API-ключа). Рекомендуется бизнес-уникальный идентификатор (напр. "order-42"); реплеи возвращают исходный taskId, ключ истекает через 24 часа после первого запроса. Полная матрица сценариев — во введении единого асинхронного API.

Тело запроса

modelstringОбязательно

Текущее фиксированное значение: flux-2-klein-9b/image-to-image

routestringНеобязательно

Текущее фиксированное значение: default

inputobjectОбязательно

Объект бизнес-параметров для flux-2-klein-9b/image-to-image и маршрута default — см. таблицу параметров ниже.

seedintegerНеобязательно

Случайное зерно для воспроизведения результата генерации; принимает целое число, при одинаковом зерне можно получить идентичный результат.

promptstringОбязательно

Подсказка: текстовое описание того, какое редактирование нужно выполнить над референсным изображением.

image_urlsarrayОбязательноminItems 1maxItems 1

Массив референсных изображений, требуется только одно изображение; поддерживаются форматы jpeg, png, webp, svg не поддерживается, входное изображение будет масштабировано до 1 MP.

Array [ string ]

aspect_ratiostringНеобязательноПо умолчанию: "1:1"

Соотношение сторон генерируемого изображения, строка; по умолчанию 1:1.

Варианты:1:14:33:416:99:16

output_formatstringНеобязательноПо умолчанию: "png"

Формат вывода генерируемого изображения, строка; по умолчанию png.

Варианты:jpegpngwebp

num_inference_stepsintegerНеобязательноПо умолчанию: 4min 4max 8

Количество шагов вывода, целое число от 4 до 8; по умолчанию 4.

callbackobjectНеобязательно

Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.

Обратные вызовы (Webhook)

Укажите callback.url при создании, и HiAPI отправит POST вашему сервису в терминальном состоянии — опрос не нужен. Тело callback повторяет структуру деталей задачи; проверка подписи, повторы и идемпотентность описаны во введении единого асинхронного API.

urlstringОбязательно

Обязательна при наличии callback. В терминальном состоянии на этот URL отправляется POST; это должна быть корректная http(s)-ссылка.

whenstringНеобязательноПо умолчанию: "final"

Сейчас поддерживается только final — уведомление и при success, и при fail.

Варианты:final

storagestringНеобязательноПо умолчанию: "temp"

Уровень хранения артефактов: temp (по умолчанию, ~7 дней) или persistent (долгосрочно, оплата по объёму). При нехватке баланса или превышении лимита — тихое понижение до temp; фактический уровень виден в ответе деталей задачи.

Варианты:temppersistent

Примеры запроса

# Отправляет асинхронную задачу; сразу возвращает taskId (не ждёт генерации)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "flux-2-klein-9b/image-to-image",
  "input": {
    "prompt": "…",
    "image_urls": "…",
    "aspect_ratio": "1:1",
    "output_format": "png",
    "num_inference_steps": 4
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "flux-2-klein-9b/image-to-image",
    input: {
      "prompt": "…",
      "image_urls": "…",
      "aspect_ratio": "1:1",
      "output_format": "png",
      "num_inference_steps": 4
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "flux-2-klein-9b/image-to-image",
        "input": {
          "prompt": "…",
          "image_urls": "…",
          "aspect_ratio": "1:1",
          "output_format": "png",
          "num_inference_steps": 4
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Получить детали задачи

GET https://api.hiapi.ai/v1/tasks/:id

Поля ответа

taskIdstringОбязательно

Идентификатор задачи, всегда с префиксом tk-hiapi-.

modelstringОбязательно

Полное разрешённое имя модели. Задачи, отправленные с параметром route, возвращают base@route (напр. gpt-image-2/text-to-image@ext); иначе совпадает с переданным именем.

routestringНеобязательно

Присутствует только при явном параметре route; повторяет переданное значение.

statusstringОбязательно

Статус задачи.

Значения статуса

queued В очереди, ещё не начата. handling Обрабатывается. archiving Обработка завершена, готовятся артефакты. success Терминальное: завершено, артефакты доступны (возвращается output). fail Терминальное: ошибка (возвращается error). После отправки следите за status: success и fail — терминальные, остальные нет. Опрашивайте каждые 1–3 с до терминального состояния. При успехе скачайте артефакты из output[].url и перенесите до expireAt; для длительного хранения укажите storage: "persistent" при создании.

creatednumberОбязательно

Время создания задачи (Unix-секунды).

completednumberОбязательно

Unix-секунды терминального состояния; до этого — 0.

outputarrayНеобязательно

Только при status == success. Список артефактов — всегда массив; одна задача может вернуть несколько type сразу (напр. video + first_frame).

Array [ object ]

Элементы массива

urlstringОбязательно

URL артефакта, доступен для скачивания напрямую.

typestringОбязательно

Текущие возможные значения: video, image, audio, first_frame, last_frame, thumbnail; список может расширяться.

expireAtnumberОбязательно

Unix-секунды доступности артефакта; скачайте или перенесите до истечения.

errorobjectНеобязательно

Только при status == fail.

codestringОбязательно

Бизнес-код ошибки.

messagestringОбязательно

Описание ошибки.

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

Успех

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

Обработка (не финальное)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Ошибка

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}