FLUX.2 [flex] — версия Black Forest Labs для генерации и редактирования изображений, специализирующаяся на типографике, отображении текста и сохранении мелких деталей. Она использует текстовые инструкции сцены и референсные изображения, выдавая картинку. Её определяющая настройка — регулируемое сэмплирование: документированный профиль предоставляет шаги вывода и guidance, позволяя уточнять визуальное задание и словами, и параметрами.
Типографическая задача начинается с самого текста. Заключите каждую строку в кавычки, задайте место, различайте заголовок, вспомогательный текст и подпись. Опишите стиль букв, масштаб и цвет относительно сцены. Авторское задание постера может показывать кобальтово-синий велосипед в светлой студии, с крупным заголовком над рамой и меньшей строкой характеристик под ней. Изображение должно одновременно ясно показывать товар и порядок чтения.
Для детального товарного визуала обозначьте части, определяющие полезность результата: циферблат, надпись на органе управления, шов, край материала или маркировку упаковки. Предоставьте читаемый референс и объясните задаваемую им особенность. В целом похожая сцена всё равно может изменить критическую букву или компонент, поэтому сравнивайте созданную деталь в целевом размере показа. Специализация модели — причина задавать точные требования, а не гарантия отсутствия необходимости вычитки и визуальной проверки.
Конкретный профиль разработчика принимает от одного до пятидесяти шагов вывода, по умолчанию пятьдесят. Описание связывает большее число шагов с детализацией и реализмом. Guidance находится в диапазоне от 1.5 до 10, по умолчанию 5. Более высокое значение усиливает следование промпту, но может снижать реализм. Поэтому точные дизайнерские указания и естественная фотографичность могут требовать разных настроек внутри профиля.
Сравнивая изменение настройки, сохраняйте формулировки, референсы и форму результата. Оценивайте особенность, ради которой внесено изменение: формы букв, положение объекта или текстуру материала. Меняйте параметр по конкретной визуальной причине, не считая большее число автоматически лучшим. Это настройки сэмплирования разработчика; четырёхшаговый дистиллированный [klein] и стандартные настройки [pro] или [max] относятся к другим моделям.
В спецификации [flex] расширение промпта включено по умолчанию и отключается собственной настройкой prompt_upsampling. При необходимости это сохраняет подробное задание в исходном виде. Общее руководство рекомендует ставить основной объект и важное действие перед второстепенным оформлением и описывает структурированные JSON-промпты наряду с естественным языком. Используйте структуру, в которой проще задать необходимые отношения.
Конкретный профиль запроса содержит восемь позиций референсных изображений. Интерактивный процесс разработчика отдельно допускает до десяти; эти числа относятся к разным интерфейсам. Определите, задаёт ли картинка редактируемую сцену, товар, персонажа, одежду или стиль. Для правки обозначьте объект и изменение, затем окружающую композицию, материалы или свет, которые нужно сохранить.
Авторская задача упаковки может использовать коробку из первого изображения и отделку из второго, заменить переднюю этикетку утверждённым текстом и сохранить пропорции коробки. В групповой композиции каждому объекту можно назначить отдельный референс и сохранять эти назначения. Примеры семейства охватывают смену предметов и фона, композиции, правку текста и стилизацию. Запросите одну связанную правку с понятной целью, затем сравните и изменённую область, и сохраняемые части.
Руководство FLUX.2 документирует минимум 64×64 пикселя, размеры кратно 16 и результат до 4 мегапикселей; для обычного применения рекомендуется до 2 мегапикселей. Конкретная спецификация [flex] перечисляет JPEG, PNG и WebP, по умолчанию JPEG. Также предусмотрен необязательный случайный seed. Для сравнения версий сохраняйте фактическую модель, seed и настройки сэмплирования вместе с исходными референсами: одно имя семейства не определяет полную конфигурацию генерации.
В работе с важным цветом связывайте каждый hex-код с названным предметом или текстовым элементом. Для композиции задайте пропорции через размеры изображения и оставьте достаточно места для читаемых надписей. В общем руководстве нет механизма негативного промпта, поэтому позитивно описывайте нужный вид: резкий фокус, чистый фон или явно свободную область для текста. Многоязычные примеры поддерживают написание культурно специфического задания на подходящем языке, но не устанавливают гарантированное фиксированное число языков.
Процесс FLUX.2 разработчика возвращает изображение после обработки и использует временные подписанные ссылки с десятиминутным окном получения. Сохраняйте само изображение вместе с заданием. Проверяйте типографику, мелкие детали, идентичность референсов и визуальную обработку до размещения в макете. Итоговым материалом может стать выбранный постер, товарное изображение или отредактированная композиция с точными настройками для следующей правки.
", "aboutText": "FLUX.2 [flex] — версия Black Forest Labs для генерации и редактирования изображений, специализирующаяся на типографике, отображении текста и сохранении мелких деталей. Она использует текстовые инструкции сцены и референсные изображения, выдавая картинку. Её определяющая настройка — регулируемое сэмплирование: документированный профиль предоставляет шаги вывода и guidance, позволяя уточнять визуальное задание и словами, и параметрами.\n\n### Надписи и мелкие детали\n\nТипографическая задача начинается с самого текста. Заключите каждую строку в кавычки, задайте место, различайте заголовок, вспомогательный текст и подпись. Опишите стиль букв, масштаб и цвет относительно сцены. Авторское задание постера может показывать кобальтово-синий велосипед в светлой студии, с крупным заголовком над рамой и меньшей строкой характеристик под ней. Изображение должно одновременно ясно показывать товар и порядок чтения.\n\nДля детального товарного визуала обозначьте части, определяющие полезность результата: циферблат, надпись на органе управления, шов, край материала или маркировку упаковки. Предоставьте читаемый референс и объясните задаваемую им особенность. В целом похожая сцена всё равно может изменить критическую букву или компонент, поэтому сравнивайте созданную деталь в целевом размере показа. Специализация модели — причина задавать точные требования, а не гарантия отсутствия необходимости вычитки и визуальной проверки.\n\n### Шаги и guidance решают разные задачи\n\nКонкретный профиль разработчика принимает от одного до пятидесяти шагов вывода, по умолчанию пятьдесят. Описание связывает большее число шагов с детализацией и реализмом. Guidance находится в диапазоне от 1.5 до 10, по умолчанию 5. Более высокое значение усиливает следование промпту, но может снижать реализм. Поэтому точные дизайнерские указания и естественная фотографичность могут требовать разных настроек внутри профиля.\n\nСравнивая изменение настройки, сохраняйте формулировки, референсы и форму результата. Оценивайте особенность, ради которой внесено изменение: формы букв, положение объекта или текстуру материала. Меняйте параметр по конкретной визуальной причине, не считая большее число автоматически лучшим. Это настройки сэмплирования разработчика; четырёхшаговый дистиллированный [klein] и стандартные настройки [pro] или [max] относятся к другим моделям.\n\nВ спецификации [flex] расширение промпта включено по умолчанию и отключается собственной настройкой prompt_upsampling. При необходимости это сохраняет подробное задание в исходном виде. Общее руководство рекомендует ставить основной объект и важное действие перед второстепенным оформлением и описывает структурированные JSON-промпты наряду с естественным языком. Используйте структуру, в которой проще задать необходимые отношения.\n\n### Правки по референсам\n\nКонкретный профиль запроса содержит восемь позиций референсных изображений. Интерактивный процесс разработчика отдельно допускает до десяти; эти числа относятся к разным интерфейсам. Определите, задаёт ли картинка редактируемую сцену, товар, персонажа, одежду или стиль. Для правки обозначьте объект и изменение, затем окружающую композицию, материалы или свет, которые нужно сохранить.\n\nАвторская задача упаковки может использовать коробку из первого изображения и отделку из второго, заменить переднюю этикетку утверждённым текстом и сохранить пропорции коробки. В групповой композиции каждому объекту можно назначить отдельный референс и сохранять эти назначения. Примеры семейства охватывают смену предметов и фона, композиции, правку текста и стилизацию. Запросите одну связанную правку с понятной целью, затем сравните и изменённую область, и сохраняемые части.\n\n### Размер, цвет и полученное изображение\n\nРуководство FLUX.2 документирует минимум 64×64 пикселя, размеры кратно 16 и результат до 4 мегапикселей; для обычного применения рекомендуется до 2 мегапикселей. Конкретная спецификация [flex] перечисляет JPEG, PNG и WebP, по умолчанию JPEG. Также предусмотрен необязательный случайный seed. Для сравнения версий сохраняйте фактическую модель, seed и настройки сэмплирования вместе с исходными референсами: одно имя семейства не определяет полную конфигурацию генерации.\n\nВ работе с важным цветом связывайте каждый hex-код с названным предметом или текстовым элементом. Для композиции задайте пропорции через размеры изображения и оставьте достаточно места для читаемых надписей. В общем руководстве нет механизма негативного промпта, поэтому позитивно описывайте нужный вид: резкий фокус, чистый фон или явно свободную область для текста. Многоязычные примеры поддерживают написание культурно специфического задания на подходящем языке, но не устанавливают гарантированное фиксированное число языков.\n\nПроцесс FLUX.2 разработчика возвращает изображение после обработки и использует временные подписанные ссылки с десятиминутным окном получения. Сохраняйте само изображение вместе с заданием. Проверяйте типографику, мелкие детали, идентичность референсов и визуальную обработку до размещения в макете. Итоговым материалом может стать выбранный постер, товарное изображение или отредактированная композиция с точными настройками для следующей правки.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "a35704212c5baf9b937ea381f8dc9e12ee10f191b6adbcef3322b782d44a7077", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ru", "methods": [ { "html": "black-forest-labs/flux.2-flexFLUX.2 [flex] специализируется на типографике изображений и мелких визуальных деталях, предоставляя регулируемые шаги сэмплирования и guidance. Используйте текст и референсы для постеров, товарных макетов или точных правок, балансируя следование заданию и реализм.
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
FLUX.2 [flex] — версия Black Forest Labs для генерации и редактирования изображений, специализирующаяся на типографике, отображении текста и сохранении мелких деталей. Она использует текстовые инструкции сцены и референсные изображения, выдавая картинку. Её определяющая настройка — регулируемое сэмплирование: документированный профиль предоставляет шаги вывода и guidance, позволяя уточнять визуальное задание и словами, и параметрами.
Типографическая задача начинается с самого текста. Заключите каждую строку в кавычки, задайте место, различайте заголовок, вспомогательный текст и подпись. Опишите стиль букв, масштаб и цвет относительно сцены. Авторское задание постера может показывать кобальтово-синий велосипед в светлой студии, с крупным заголовком над рамой и меньшей строкой характеристик под ней. Изображение должно одновременно ясно показывать товар и порядок чтения.
Для детального товарного визуала обозначьте части, определяющие полезность результата: циферблат, надпись на органе управления, шов, край материала или маркировку упаковки. Предоставьте читаемый референс и объясните задаваемую им особенность. В целом похожая сцена всё равно может изменить критическую букву или компонент, поэтому сравнивайте созданную деталь в целевом размере показа. Специализация модели — причина задавать точные требования, а не гарантия отсутствия необходимости вычитки и визуальной проверки.
Конкретный профиль разработчика принимает от одного до пятидесяти шагов вывода, по умолчанию пятьдесят. Описание связывает большее число шагов с детализацией и реализмом. Guidance находится в диапазоне от 1.5 до 10, по умолчанию 5. Более высокое значение усиливает следование промпту, но может снижать реализм. Поэтому точные дизайнерские указания и естественная фотографичность могут требовать разных настроек внутри профиля.
Сравнивая изменение настройки, сохраняйте формулировки, референсы и форму результата. Оценивайте особенность, ради которой внесено изменение: формы букв, положение объекта или текстуру материала. Меняйте параметр по конкретной визуальной причине, не считая большее число автоматически лучшим. Это настройки сэмплирования разработчика; четырёхшаговый дистиллированный [klein] и стандартные настройки [pro] или [max] относятся к другим моделям.
В спецификации [flex] расширение промпта включено по умолчанию и отключается собственной настройкой prompt_upsampling. При необходимости это сохраняет подробное задание в исходном виде. Общее руководство рекомендует ставить основной объект и важное действие перед второстепенным оформлением и описывает структурированные JSON-промпты наряду с естественным языком. Используйте структуру, в которой проще задать необходимые отношения.
Конкретный профиль запроса содержит восемь позиций референсных изображений. Интерактивный процесс разработчика отдельно допускает до десяти; эти числа относятся к разным интерфейсам. Определите, задаёт ли картинка редактируемую сцену, товар, персонажа, одежду или стиль. Для правки обозначьте объект и изменение, затем окружающую композицию, материалы или свет, которые нужно сохранить.
Авторская задача упаковки может использовать коробку из первого изображения и отделку из второго, заменить переднюю этикетку утверждённым текстом и сохранить пропорции коробки. В групповой композиции каждому объекту можно назначить отдельный референс и сохранять эти назначения. Примеры семейства охватывают смену предметов и фона, композиции, правку текста и стилизацию. Запросите одну связанную правку с понятной целью, затем сравните и изменённую область, и сохраняемые части.
Руководство FLUX.2 документирует минимум 64×64 пикселя, размеры кратно 16 и результат до 4 мегапикселей; для обычного применения рекомендуется до 2 мегапикселей. Конкретная спецификация [flex] перечисляет JPEG, PNG и WebP, по умолчанию JPEG. Также предусмотрен необязательный случайный seed. Для сравнения версий сохраняйте фактическую модель, seed и настройки сэмплирования вместе с исходными референсами: одно имя семейства не определяет полную конфигурацию генерации.
В работе с важным цветом связывайте каждый hex-код с названным предметом или текстовым элементом. Для композиции задайте пропорции через размеры изображения и оставьте достаточно места для читаемых надписей. В общем руководстве нет механизма негативного промпта, поэтому позитивно описывайте нужный вид: резкий фокус, чистый фон или явно свободную область для текста. Многоязычные примеры поддерживают написание культурно специфического задания на подходящем языке, но не устанавливают гарантированное фиксированное число языков.
Процесс FLUX.2 разработчика возвращает изображение после обработки и использует временные подписанные ссылки с десятиминутным окном получения. Сохраняйте само изображение вместе с заданием. Проверяйте типографику, мелкие детали, идентичность референсов и визуальную обработку до размещения в макете. Итоговым материалом может стать выбранный постер, товарное изображение или отредактированная композиция с точными настройками для следующей правки.
POST /v1/images/generationstext, imageimage| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения black-forest-labs/flux.2-flex | По умолчанию— |
Полеprompt | Типstring | ТребованиеОбязательно | Значения и ограничения Минимальная длина: 1 | По умолчанию— |
Полеaspect_ratio | Типstring | ТребованиеНеобязательно | Значения и ограничения 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | По умолчанию— |
Полеoutput_format | Типstring | ТребованиеНеобязательно | Значения и ограничения png, jpeg | По умолчанию— |
Полеn | Типinteger | ТребованиеНеобязательно | Значения и ограничения Минимум: 1 Максимум: 1 | По умолчанию— |
Полеinput_references | Типarray | ТребованиеНеобязательно | Значения и ограничения Минимум элементов: 0 Максимум элементов: 8 | По умолчанию— |
Поле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}
Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Прогноз количества | Расчётная единица | Плата |
|---|---|---|---|---|
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Прогноз количества— | Расчётная единица— | Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов |
| Конфигурациямегапиксель входного изображения | Шкала ставок— | Прогноз количества— | Расчётная единицаза мегапиксель входного изображения | Плата Вход · мегапиксель входного изображения · Оценка только для сравнения $0.12 за мегапиксель входного изображения |
| Конфигурациямегапиксель выходного изображения | Шкала ставок— | Прогноз количества— | Расчётная единицаза мегапиксель выходного изображения | Плата Выход · мегапиксель выходного изображения · Оценка только для сравнения $0.12 за мегапиксель выходного изображения |
| КонфигурацияОриентировочная стоимость генерации | Шкала ставок— | Прогноз количестваОценка для одной генерации | Расчётная единица— | Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.12 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации. |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'black-forest-labs/flux.2-flex', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nЗагрузите каждое полученное изображение или сохраните его содержимое Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nСохраните каждое готовое изображение; загрузите содержимое по каждому полученному URL или декодируйте его содержимое Base64.
Сохраняйте полный ответ и заголовки, все фактические результаты, исходные возвращённые идентификаторы и все поля использования. Восстанавливайте исходную операцию без повторной отправки запроса создания.
Сохраните возвращённый X-Client-Request-ID для сверки. Читайте только фактически возвращённые значения task_id/asset_id или собственную медиатеку; никогда не составляйте URL задачи из ID операции и никогда не отправляйте запрос создания повторно.
| Поле | Тип |
|---|---|
Полеcreated | Тип |
Полеdata[].url | Тип |
Полеdata[].b64_json | Тип |
Полеusage | Тип |
Ailoot Ultra black-forest-labs/flux.2-flex
/v1/images