Flux 2 Pro

Flux 2 Pro (black-forest-labs/flux-2-pro) — флагман от Black Forest Labs для image-генерации. Работает с двумя эндпоинтами: POST /v1/images/generations для генерации по тексту и POST /v1/images/edits для работы по картинке-образцу. Модель платная — генерации списываются с баланса.

Параметры

Поле	Описание
`model`	`black-forest-labs/flux-2-pro` (или короткое `flux-2-pro`)
`prompt`	Описание изображения, обязательное
`n`	Сколько картинок, от 1 до 4; каждая тарифицируется отдельно
`aspect_ratio`	`1:1`, `2:3`, `3:2`, `9:16`, `9:21`, `16:9`, `21:9`; по умолчанию `1:1`
`resolution`	`1k` или `2k`; по умолчанию `1k`
`size`	Явный размер `WxH` — альтернатива паре `aspect_ratio` + `resolution`
`quality`	У модели нет такой ручки: передача параметра вернёт `400`

Модель мыслит парой «формат + разрешение», а WxH — производное от них: 1k даёт площадь около мегапикселя, 2k — около четырёх. Соответствия для ходовых комбинаций:

Формат	1k	2k
`1:1`	`1024x1024`	`2048x2048`
`16:9`	`1344x768`	`2688x1520`
`9:16`	`768x1344`	`1520x2688`
`21:9`	`1568x672`	`3072x1296`
`9:21`	`672x1568`	`1296x3072`

Полный список из 14 допустимых size — поле sizes в каталоге; значение вне списка вернёт 400.

Примеры

import base64

img = client.images.generate(
    model="black-forest-labs/flux-2-pro",
    prompt="Дизайн-концепт кроссовка на пресс-форме, студийный свет, чистый фон",
    extra_body={"aspect_ratio": "3:2", "resolution": "2k"},
)
with open("sneaker.png", "wb") as f:
    f.write(base64.b64decode(img.data[0].b64_json))

curl https://api.mixen.ai/v1/images/generations \
  -H "Authorization: Bearer $MIXEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "black-forest-labs/flux-2-pro",
    "prompt": "Дизайн-концепт кроссовка на пресс-форме, студийный свет, чистый фон",
    "aspect_ratio": "3:2",
    "resolution": "2k"
  }'

Широкий баннер явным размером

{
  "model": "black-forest-labs/flux-2-pro",
  "prompt": "Баннер обжарочной кофейни: утренний свет, зерно, крафтовая типографика",
  "size": "3072x1296"
}

Редактирование по образцу

Модель принимает картинки-образцы (references: true), поэтому доступен /v1/images/edits с multipart/form-data:

curl https://api.mixen.ai/v1/images/edits \
  -H "Authorization: Bearer $MIXEN_API_KEY" \
  -F model=black-forest-labs/flux-2-pro \
  -F image=@sketch.png \
  -F prompt="Преврати набросок в фотореалистичный рендер, фон студийный"

Ответ всегда содержит b64_json — файлы не хостятся. Оба эндпоинта отвечают синхронно; ставьте таймаут HTTP-клиента не меньше 120 секунд.

Цена

4.0108 ₽ ($0.045) за изображение — единая витринная цена из каталога. Актуальные значения — каталог.

Сильные стороны и ограничения

Семь форматов кадра, включая ультра-широкие 21:9 и 9:21 под баннеры и обложки.
Два разрешения: 1k (около мегапикселя) и 2k (около четырёх, вплоть до 3072x1296).
Четырнадцать фиксированных size — по одному на каждую пару «формат + разрешение».
Редактирование по образцу через /v1/images/edits — тот же ключ и тот же синтаксис, что у генерации.
Рядом в каталоге: Flux 2 Flex — 8.0216 ₽ ($0.09), Flux 2 Max — 9.3585 ₽ ($0.105) за картинку; набор параметров у семейства общий.
Работает только с баланса; ручки quality нет — размер вне таблицы модели вернёт 400.

Все модели — в каталоге. Общий порядок работы с изображениями — гайд по изображениям.