Source: https://ailoot.ai/models/ru/black-forest-labs-flux-3-image/ Canonical: https://ailoot.ai/models/ru/black-forest-labs-flux-3-image/ Language: ru # Black Forest Labs: FLUX.3 Image [Markdown](https://ailoot.ai/models/ru/black-forest-labs-flux-3-image/index.md) · [JSON](https://ailoot.ai/models/ru/black-forest-labs-flux-3-image/facts.json) ## [Black Forest Labs: FLUX.3 Image](https://ailoot.ai/models/ru/black-forest-labs-flux-3-image/) FLUX 3 Image создаёт и редактирует изображения по текстовому заданию и набору до десяти референсов. Добавляет ограничивающие рамки в промпте для композиции и локальных изменений, привязку к веб-источникам и поиску изображений, а также пять классов разрешения. - [**Ailoot Ultra · Картинки** `POST /v1/images/generations` `black-forest-labs/flux-3-image`](https://ailoot.ai/models/ru/black-forest-labs-flux-3-image/#method-0) О модели Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже. FLUX 3 Image — модель Black Forest Labs для генерации и редактирования изображений с явным управлением композицией. Текст создаёт новую сцену; предоставленные изображения задают объект, редактируемую сцену или объединяемые элементы. Ограничивающие рамки позволяют указывать в задании место каждого элемента и изменяемые части существующей картинки. Результат — изображение, у которого нужно проверить запрошенную сцену, текст и макет. #### Создайте сцену или задайте правку Для нового изображения опишите объект, действие или позу, обстановку, свет и кадрирование. Заключите точный текст внутри изображения в кавычки и укажите место. Авторское товарное задание может показывать красную походную кружку на светлой каменной поверхности, с крупным заголовком над ней и мягким утренним светом, открывающим ручку. Определите отношения заголовка, товара и фона вместо несвязанных стилевых слов. Для редактирования обозначьте конкретный объект и изменение: перекрасить кружку, заменить этикетку, переместить фигуру или изменить стиль сцены. Одна правка не требует вручную нарисованной рамки. Документированный процесс расширяет инструкцию перед генерацией и может автоматически найти названный элемент и добавить рамку. Возвращённый расширенный промпт фиксирует эту интерпретацию, что полезно, если инструкция выбрала неверный объект или добавила лишнюю деталь. #### Объединение и подготовка референсов Конкретный профиль разработчика принимает от одного до десяти референсов по URL изображения или как закодированные данные. Каждый должен быть не менее 256×256 пикселей и не более 16 мегапикселей. Назовите референс по позиции или видимому содержимому, затем объясните роль: человек из Image 1, куртка из Image 2, комната из Image 3. Референс — источник визуальной информации, а не указание копировать каждую постороннюю деталь. Соотношение сторон по умолчанию — auto. В спецификации запроса приоритет имеет соотношение из промпта; иначе кадрирование задаёт первый референс, а при отсутствии референса и запрошенной формы используется квадрат. Для композиции поставьте нужный референс сцены первым или явно выберите соотношение. Сохраняйте исходные изображения и порядок вместе с результатом, чтобы следующая правка использовала ту же визуальную отправную точку. #### Размещение элементов ограничивающими рамками Промпт макета объединяет описание и JSON-массив строк элементов. В описании элемент назван маркером вроде \; строка содержит id, bbox и desc. Координаты — целые числа от 0 до 1000 в порядке \[top, left, bottom, right\], отсчитываемые от левого верхнего угла. Например, \[0, 0, 500, 500\] обозначает левую верхнюю четверть независимо от пиксельного размера изображения. Используйте соотношение сторон, под которое спроектирован макет: сетка координат растягивается вместе с кадром. Строка редактирования вместо этого использует from, src\_bbox и tgt\_bbox вместе с идентификатором и описанием. ref\_image\_0 означает первое предоставленное изображение. Одинаковые исходная и целевая рамки закрепляют элемент; разные — перемещают его или меняют размер. Новая строка без источника генерирует описанное в целевом месте, позволяя добавления, замены или перекрашивание. Строка с источником без цели удаляет элемент. Задавайте добавления и удаления и текстом, и строками, сохраняя опорные строки деталей, которые должны остаться на месте. Выделите надписям отдельную рамку и заключите точный текст в кавычки в desc. Рамки направляют размещение и масштаб, но не являются масками обрезки: элемент может выходить за прямоугольник. Разработчик сообщает, что в примерах новые объекты в рамках около 40×25 пикселей часто не появлялись. Оставьте достаточно видимого пространства и проверяйте границы правки. Пиксели вне цели обычно стабильны, но тени, отражения и соседнее освещение могут меняться. #### Привязка к источникам, классы результата и полезные записи Документированный профиль по умолчанию включает привязку к источникам, позволяя веб-поиску и поиску изображений информировать генерацию. Её можно отключить для задания, использующего только собственное описание и референсы. Для реального объекта ясно укажите место, событие или предмет, отделяя факты от художественной обработки. Изображение с использованием поиска всё равно нужно сравнивать с авторитетными материалами, если надпись, объект или изображённое событие должны быть точными. Пять классов разрешения — 768sq, 1k, 1.5k, 2k и 4k, по умолчанию 1k. Они представляют уровни равной пиксельной площади, поэтому точные ширина и высота зависят от выбранного соотношения. Пятнадцать фиксированных соотношений идут от 21:9 через квадратные и вертикальные форматы до 9:21. Профиль управляет размером через соотношение и разрешение; он не предоставляет поля seed, width или height из запросов FLUX.2. Документированный селектор версии сейчас обозначает обновляемый выпуск, а не датированное соответствие весам поставщика. Процесс разработчика возвращает изображение после асинхронной обработки вместе с расширенным промптом. Подписанная ссылка скачивания действует один час. Сохраняйте само изображение, конечный промпт и референсы, не полагаясь на временную ссылку. Для проверенного материала сравните запрошенный текст, положение предметов, идентичность референсов и изменённую область в целевом размере показа. Завершённая генерация — начало проверки этих визуальных требований. **Ailoot Ultra · Картинки** `POST /v1/images/generations` `black-forest-labs/flux-3-image` [`black-forest-labs/flux-3-image`](https://ailoot.ai/models/ru/#m=black-forest-labs%2Fflux-3-image&route=Ultra&caller=black-forest-labs%2Fflux-3-image&fmt=images) Black Forest Labs /`black-forest-labs/flux-3-image` ### Начало FLUX 3 Image создаёт и редактирует изображения по текстовому заданию и набору до десяти референсов. Добавляет ограничивающие рамки в промпте для композиции и локальных изменений, привязку к веб-источникам и поиску изображений, а также пять классов разрешения. Допустимые входные данные Текст · Картинки Результаты Картинки ### Доступно в Ailoot · входные данные и методы **Ailoot Ultra · Картинки** `POST /v1/images/generations` Входные данные `text`, `image` Результат `image` | Поле | Тип | Требование | Значения и ограничения | По умолчанию | | --- | --- | --- | --- | --- | | Поле`model` | Тип`string` | ТребованиеОбязательно | Значения и ограничения black-forest-labs/flux-3-image | По умолчанию— | | Поле`prompt` | Тип`string` | ТребованиеОбязательно | Значения и ограничения Минимальная длина: 1 | По умолчанию— | | Поле`resolution` | Тип`string` | ТребованиеНеобязательно | Значения и ограничения 768, 1K, 1.5K, 2K, 4K | По умолчанию— | | Поле`aspect_ratio` | Тип`string` | ТребованиеНеобязательно | Значения и ограничения 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21, auto | По умолчанию— | | Поле`n` | Тип`integer` | ТребованиеНеобязательно | Значения и ограничения Минимум: 1 Максимум: 1 | По умолчанию— | | Поле`input_references` | Тип`array` | ТребованиеНеобязательно | Значения и ограничения Минимум элементов: 0 Максимум элементов: 10 | По умолчанию— | | Поле`provider` | Тип`object` | ТребованиеНеобязательно | Значения и ограничения | По умолчанию— | Параметры и жизненный цикл метода | Параметр | Контракт | | --- | --- | | Параметр`content_type` | Контрактapplication/json | | Параметр`required` | Контрактmodel, prompt | | Параметр`material_types` | Контрактtext, image | Жизненный цикл: `synchronous_result_then_owned_library` `GET /v1/media/tasks/{task_id}` · Фактически возвращённый task\_id или запись в медиатеке `GET /v1/media/assets/{asset_id}/content` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### Тарифы ##### Как рассчитывается итоговая плата Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом. Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода. Быстрый режим Не указано При выборе быстрого режима Режим flex Не указано При выборе режима flex Максимальная интенсивность рассуждений Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default) #### Оценочные ставки для сравнения #### Цены по конфигурациям Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку. | Конфигурация | Шкала ставок | Прогноз количества | Плата | | --- | --- | --- | --- | | КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Прогноз количества— | Плата Вход · Входные токены · Оценка только для сравнения **—** / 1K токенов Выход · Выходные токены · Оценка только для сравнения **—** / 1K токенов Вход · Чтение кэша · Оценка только для сравнения **—** / 1K токенов Вход · Запись в кэш · Оценка только для сравнения **—** / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения **—** / 1K токенов | | КонфигурацияОриентировочная стоимость генерации | Шкала ставок— | Прогноз количестваОценка для одной генерации | Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения **$0.082** оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации. | Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. [Как работают резервирование и расчёт →](https://ailoot.ai/docs/ru/billing/reserve/) ### Примеры запросов #### Ailoot Ultra · Картинки curl ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_REQUEST' import json,os from pathlib import Path p={'model': 'black-forest-labs/flux-3-image', 'prompt': 'a red panda astronaut floating in space, studio lighting'} Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import base64, json, os, subprocess from pathlib import Path from urllib.parse import urlsplit, urljoin def save_images(items): if not items: raise SystemExit("No completed images; retain the full response") for index, item in enumerate(items): encoded=item.get("b64_json") uri=item.get("url", "") if not encoded and uri.startswith("data:image/"): header, separator, encoded=uri.partition(",") if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI") if encoded: raw=base64.b64decode(encoded,validate=True) elif uri: uri=urljoin("https://api.ailoot.ai",uri) parsed=urlsplit(uri) if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password: raise SystemExit("Invalid returned image URL") owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content") args=["curl","--fail-with-body","--silent","--show-error",uri] if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]] temporary=Path(f"image-{index}.bin") subprocess.run(args+["-o",str(temporary)],check=True) raw=temporary.read_bytes() temporary.unlink() else: raise SystemExit("Image has neither bytes nor URL") if not raw: raise SystemExit("Empty image result") ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"