Black Forest Labs

FLUX 3 Image

flux-3-image

Модель для работы с изображениями в мультимодальном семействе Black Forest Labs, разделяющая архитектуру совместного обучения и фреймворк Self-Flow с видео- и аудиомоделями; подходит для обновления конвейеров генерации изображений на базе системы FLUX

flux-3-image

Попробовать flux-3-image

Ввод

Работы

Все работы

Вывод

image

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

Спектр стилей: от реализма к плоскостной графике для одного и того же объекта

Стиль style-spectrum · редакционная-иллюстрация · Плоская графика

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

image_urls
image_urls

Промпт

Редакционная стилевая иллюстрация: одинокий путник в широкополой шляпе стоит на смотровой площадке скалистого побережья, показан в ракурсе три четверти со спины, позади — море и низкие облака. Референсное изображение 1 задаёт идентичность объекта и композицию; референсное изображение 2 задаёт цветовые пятна и язык мазка. Стилевая цель: взять точку на спектре между живописным реализмом и плоскостной графической иллюстрацией — полуреалистичный рендер с ощутимой объёмностью, мягким контурным светом от низкого солнца, сдержанной, но насыщенной палитрой, края упрощены до чистых форм, без тяжёлой фактуры и без градиентов, кроме атмосферной дымки. Композиция 4:3, объект смещён влево от центра, справа оставлено открытое небо, достаточно свободного пространства. Палитра из мягких бирюзовых, тёплых песочных и кремово-белых тонов создаёт спокойную, созерцательную атмосферу; качество, достойное разворота глянцевого журнала.

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

Теги

Концепт-арт сцены мировоззрения FLUX 3: Утренний свет Туманной гавани

Стиль Концепт-арт · Построение мира · Атмосферность

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

image_urls
image_urls

Промпт

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

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

Теги

flux-3-image: фотореалистичная предметная съёмка для e-commerce

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

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

image_urls

Промпт

Студийная предметная съёмка: матовый керамический набор для пуровер-кофе, объект по центру с небольшим смещением от оси, на бесшовном фоне тёплого песчано-серого оттенка. Сверху слева мягкий большой софтбокс с лёгким градиентным затуханием, у правого края тонкий контурный свет отделяет корпус от фона, мягкая тень на полу снизу стабилизирует основание. Съёмка объективом с эквивалентным фокусным расстоянием 85 мм при диафрагме f/8 обеспечивает резкость от центра до краёв, а малая глубина резкости достаточно мягко размывает фон. На керамических кромках видна микротекстура глазури и блики, детали металлического кольца чёткие. Нейтральная цветокоррекция, достоверный баланс белого, без лишнего реквизита, справа оставлено достаточно негативного пространства для текста. Эстетика коммерческого e-commerce каталога, чисто, высокоточная детализация, горизонтальная композиция 3:2.

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

Теги

flux-3-image Коммерческая продуктовая съёмка: парфюм в контрасте тёплого и холодного света

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

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

image_urls

Промпт

Высококлассная коммерческая продуктовая фотография: флакон парфюма из матового стекла с крышкой из шлифованного шампанского золота, слегка смещённый от центра на прозрачной акриловой подставке; сверху справа направлен жёсткий основной свет, образующий чёткие резкие блики по краю флакона; слева крупный софтбокс заполняет свет и высветляет теневую сторону; фон плавно переходит от тёплого янтарного к холодному циану справа; под флаконом на глянцевой поверхности — лёгкое отражение; на стекле — тонкая конденсатная дымка; малая глубина резкости, этикетка чёткая и резкая, фон мягко размыт; вертикальная композиция 4:5, сверху достаточно свободного пространства для текста; чистая коммерческая ретушь, без текста, без логотипов, сверхдетализированное преломление стекла и микрофактура металла

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

Теги

Цены

flux-3-image per image

Характеристики	Цена за единицу
768S	$0.041
1K	$0.048
1.5K	$0.070
2K	$0.100
4K	$0.607

Позиционирование и краткое описание

flux-3-image — это модель изображений из мультимодального семейства FLUX 3 от Black Forest Labs, доступная через унифицированный интерфейс HiAPI.ai. Она принимает как чисто текстовые промпты для прямой генерации изображений, так и до 10 референсных изображений для генерации и локального редактирования; формат вывода, уровень разрешения и допуск по безопасности контента настраиваются. Модель подходит разработчикам, создающим конвейеры генерации визуального контента, и командам, которым нужно подключить новое поколение моделей к существующим рабочим процессам FLUX для изображений.

Ключевые преимущества

Совместное управление референсными изображениями и промптом — можно передать до 10 референсных изображений и указать в промпте роль каждого из них: субъект, стиль или композиция.
Опциональный веб-поиск для дополнения визуальной информации — grounding включён по умолчанию: перед генерацией выполняется поиск по веб-страницам и изображениям, чтобы дополнить промпт деталями сущностей и сцен.
Гибкий выбор разрешения и формата — вывод поддерживает пять уровней разрешения от 768 до 4K и 16 соотношений сторон; режим auto автоматически определяет формат по промпту и референсным изображениям.

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

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

Комбинирование нескольких референсов: за один запрос можно использовать до 10 референсных изображений, каждое из которых отвечает за субъект, стиль или композицию; это подходит для сведения нескольких визуальных материалов в одно изображение.

Управление форматом и разрешением: aspect_ratio предлагает 16 соотношений от горизонтального 21:9 до вертикального 9:21 с возможностью автоматического выбора, а resolution охватывает диапазон от 768 до 4K, что удобно для пакетной генерации под требования каналов размещения и чёткости.

Регулировка допуска по безопасности контента: safety_tolerance настраивается от 0 до 4, по умолчанию 2; команды могут ужесточать или ослаблять фильтрацию в соответствии со своими требованиями к комплаенсу.

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

Стилизованная генерация для креативных команд — по описанию дизайна и референсным изображениям стиля создаются визуальные макеты с заданной композицией и форматом для рекламных материалов и концептуальных предложений.
Обновление модели в существующих конвейерах FLUX — вызовы генерации изображений заменяются текстовыми промптами, а форма вывода сохраняется в прежнем виде, что упрощает обновление модели без изменения верхнеуровневых процессов.
Создание сцен с фактическими деталями — при включённом grounding достаточно кратко описать субъект в промпте, чтобы получить изображение, дополненное данными поиска, для иллюстраций к контенту и схем сцен.
Композиция из нескольких материалов и правка изображений — загрузите несколько референсных изображений и укажите роль каждого, чтобы получить единый по стилю результат композиции или правки для изображений товаров и повторного использования материалов.

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

Публичная информация в основном касается семейства FLUX 3 в целом и видеонаправления, а конкретные спецификации данной версии для изображений раскрыты ограниченно; описание совместного обучения и видеовозможностей на уровне семейства нельзя напрямую переносить на все возможности этой модели. grounding сначала выполняет поиск, а затем генерацию, что может увеличить время одного запроса. Скорость генерации, стабильность и поведение на крайне сложных промптах рекомендуется сначала проверить на собственных примерах, прежде чем внедрять модель в производство. Если требуется генерация видео или аудио, следует выбрать модель соответствующего направления из того же семейства.

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

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

Можно ли генерировать и редактировать через одну точку входа?

Да. Без референсных изображений — генерация по тексту; при наличии 1–10 референсных изображений — редактирование на основе имеющихся материалов. Достаточно заранее подготовить текст или изображения в соответствии с целью создания.
Как выбрать из пяти уровней разрешения?

Сначала используйте 768 или 1K, чтобы обсудить направление; когда нужно больше деталей, рассмотрите 1.5K или 2K, а когда нужны крупные изображения и пространство для обрезки — рассмотрите 4K. Уровень — это не фиксированные размеры сторон, проверяйте ширину и высоту возвращаемого изображения.
Как распределяются роли референсных изображений?

По порядку укажите, какое изображение задаёт主体, какое — окружение, а какое — только цветовую схему или стиль; также отметьте элементы, которые не следует переносить.
Сколько изображений генерируется за один раз?

Каждая задача возвращает одно изображение. Если нужно другое направление, измените описание и отправьте отдельную задачу.

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

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-3-image

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

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

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

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

promptstringОбязательноminLength 1maxLength 5000

Опишите желаемое содержимое изображения; при наличии референсного изображения здесь также можно указать, какие части на нём нужно изменить, а какие сохранить.

groundingbooleanНеобязательноПо умолчанию: true

Логическое значение, управляет тем, выполнять ли перед генерацией поиск в интернете по веб-страницам и изображениям для дополнения визуальной информации в промпте; по умолчанию true.

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

Массив URL референсных изображений для визуальной опоры при генерации; роль каждого изображения (объект, стиль или композиция) необходимо описать в промпте.

Array [ string ]

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

Уровень выходного разрешения, конкретная ширина и высота зависят от соотношения сторон; по умолчанию 1K.

Варианты:7681K1.5K2K4K

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

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

Варианты:21:92:116:93:27:54:35:41:1

Показать все (8)

4:53:45:72:39:161:29:21auto

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

Целое число, допуск по безопасности контента, значение 0 — наиболее строгий; по умолчанию 2.

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-3-image",
  "input": {
    "prompt": "…",
    "grounding": true,
    "resolution": "1K",
    "aspect_ratio": "auto",
    "safety_tolerance": 2
  }
}'

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-3-image",
    input: {
      "prompt": "…",
      "grounding": true,
      "resolution": "1K",
      "aspect_ratio": "auto",
      "safety_tolerance": 2
    }
  }),
});
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-3-image",
        "input": {
          "prompt": "…",
          "grounding": True,
          "resolution": "1K",
          "aspect_ratio": "auto",
          "safety_tolerance": 2
        }
    },
)
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"
    }
  }
}

Статьи

Все статьи →

FLUX 3 Image

Попробовать flux-3-image

Ввод

Работы

Вывод

Промпт

Промпт

Промпт

Промпт

Промпт

Промпт

Цены

Позиционирование и краткое описание

Ключевые преимущества

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

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

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

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

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

Заголовки

Тело запроса

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

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

Поля ответа

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

Статьи

Как вызывать hailuo-2.3/text-to-video через API HiAPI: curl, Python и рабочие примеры запросов

kandinsky-6.0-pro/image-to-video в HiAPI: руководство по curl + Python

Как вызывать kling-4.0/image-to-video на HiAPI: curl, Python и опрос

Как вызвать hailuo-2.3-fast/image-to-video через HiAPI API: практика с curl и Python

Практика генерации изображений по тексту с recraft-v4.1-flash: 5 ценных бизнес-сценариев и ключевые моменты интеграции

Recraft v4.1 Flash 文生图横向对比：开发者选型与迁移指南

Использование Kandinsky 6.0 Pro для преобразования текста в видео на HiAPI: руководство по curl и Python

Как использовать kling-4.0/text-to-video через HiAPI API: curl, Python и рабочий пример запроса

hailuo-2.3-fast/image-to-video — горизонтальное сравнение: как выбрать модель «изображение в видео» и что учесть при миграции

Похожие модели

Тот же тип

Тот же вендор