Flux API

Эндпоинты изображений сгруппированы как Flux 3, Flux 2 и Flux 1. Для новой интеграции используйте FLUX 3 Image: один POST /bfl/v1/flux-3-image и для генерации по тексту, и для правки. FLUX 3 Image Klein нужен, когда надо зафиксировать seed, точные ширину и высоту или число шагов. Запросы отправляйте на https://api.ttapi.io с заголовком TT-API-KEY. Ключ создается в консоли. См. аутентификацию. Ответ на отправку сразу содержит jobId. Изображение появляется после завершения задачи. Опрашивайте эндпоинт получения результата или передайте webhook_url и получите результат колбэком. FLUX 3 Image и Klein тарифицируются по разрешению со скидкой 40% от официальной цены. См. цены на изображения.

Генерация и правка — один запрос

Без images модель создает новое изображение по prompt. С images тот же промпт становится инструкцией правки: изменить деталь, сменить стиль или собрать несколько изображений в одно. Пишите, что именно менять. «Измени птицу в центре изображения 1 на #e01075, остальное оставь как есть» надежнее, чем «сделай лучше». Несколько изображений называются изображение 1, изображение 2 и далее, в порядке массива. В промпте ссылайтесь на них так же.

curl --request POST 'https://api.ttapi.io/bfl/v1/flux-3-image' \
  --header 'Content-Type: application/json' \
  --header 'TT-API-KEY: YOUR_TTAPI_KEY' \
  --data-raw '{
    "prompt": "Change the bird in the middle of image 1 to #e01075 and leave the rest unchanged",
    "images": ["https://example.com/birds.webp"],
    "aspect_ratio": "3:2"
  }'

images принимает URL или base64 одной картинки, либо массив из 1–10 элементов. Каждое изображение не меньше 256×256 и не больше 16 мегапикселей. FLUX 3 Image не принимает input_image, seed, width и height. У Klein есть дополнительное правило: первое изображение — то, которое редактируют, и при отсутствии ширины и высоты оно задает размер результата.

Положение элементов через рамки

Чтобы поставить элемент в фиксированную область или изменить только часть кадра, допишите ограничивающие рамки в конец промпта. Координаты идут по сетке от 0 до 1000 в порядке [top, left, bottom, right]. Левый верхний угол — [0, 0], правый нижний — [1000, 1000]. Обозначьте объект угловыми скобками в промпте, а рамку и описание дайте в конце:

{
  "prompt": "A yellow background <background_1> with a running black silhouette <silhouette_1> in the center.[{\"id\":\"background_1\",\"bbox\":[0,0,1000,1000],\"desc\":\"A flat yellow-green background\"},{\"id\":\"silhouette_1\",\"bbox\":[150,150,850,850],\"desc\":\"A black figure running toward the left\"}]",
  "aspect_ratio": "1:1"
}

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

Сначала кадр, потом четкость

aspect_ratio по умолчанию auto. Для генерации по тексту лучше задать его явно, например 16:9, 1:1, 9:16 или 21:9. При auto сначала берется соотношение, названное в промпте. Если референса нет и в промпте нет соотношения, FLUX 3 Image использует 1:1, а Klein — 16:9. С референсами auto сохраняет пропорции первого изображения. resolution — ступень по площади в пикселях. По умолчанию 1k:

Ступень	Когда использовать
`768sq`	Пока вы еще меняете промпт. Результат 768×768
`1k`	Значение по умолчанию. Достаточно для веба и продуктовых картинок, около 1 мегапикселя
`1.5k`	Около 2 мегапикселей
`2k`	Кадрирование и более мелкие детали, около 4 мегапикселей
`4k`	Максимальная ступень, около 16 мегапикселей, заметно дольше

Смена разрешения запускает новую генерацию, поэтому композиция может отличаться от черновика более низкого разрешения. Точные ширина и высота зависят от соотношения сторон. У Klein одновременная передача width и height перекрывает оба поля выше. grounding включен по умолчанию. Модель может искать в вебе и по изображениям, чтобы сверить реальные объекты из промпта. Выключите его, если нужно рисовать только по промпту: обычно это быстрее.

Когда использовать Klein

FLUX 3 Image Klein делает то же, что FLUX 3 Image: генерацию по тексту, до 10 референсов и рамки. Дополнительно он принимает:

width и height вместе, каждое от 64 до 6256, произведение не больше 16822272
seed для повторения генерации, от 0 до 4294967295
output_format: jpeg или png, по умолчанию jpeg
steps от 1 до 16, по умолчанию 16

Эндпоинт сначала расширяет промпт, затем генерирует. Klein обучен на таких расширенных описаниях, поэтому отправляйте короткий промпт как есть.

Один полный вызов

curl --request POST 'https://api.ttapi.io/bfl/v1/flux-3-image' \
  --header 'Content-Type: application/json' \
  --header 'TT-API-KEY: YOUR_TTAPI_KEY' \
  --data-raw '{
    "prompt": "Ultra-wide cinematic shot of a foggy coastal highway, cliffs on one side and turquoise water on the other, one vintage car with its headlights on",
    "aspect_ratio": "21:9",
    "resolution": "1k"
  }'

Успешная отправка возвращает только идентификатор задачи:

{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "jobId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}

Получение результата:

curl --request GET 'https://api.ttapi.io/flux/fetch' \
  --header 'TT-API-KEY: YOUR_TTAPI_KEY' \
  --form 'jobId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'

PENDING_QUEUE — задача ждет в очереди. ON_QUEUE — идет генерация. После SUCCESS читайте data.imageUrl. Срок действия адреса ограничен, см. хранение. При FAILED смотрите message. Коды состояний описаны в ответах. На этапе отладки достаточно опроса с паузой в несколько секунд. Если у сервера уже есть публичный адрес, добавьте webhook_url в запрос отправки: результат придет туда после завершения.

Другие модели изображений

Flux 2 и Flux 1 по-прежнему доступны. Используйте пути ниже, если существующая интеграция должна остаться на конкретном поколении. Новые задачи лучше начинать с FLUX 3 Image выше.

Flux 2

Тарификация на 40% ниже официальной цены. См. цены на изображения.

Модель	Путь
Flux.2 Klein 4B	`POST /bfl/v1/flux-2-klein-4b`
Flux.2 Klein 9B	`POST /bfl/v1/flux-2-klein-9b`
Flux.2 Max	`POST /bfl/v1/flux-2-max`
Flux.2 Flex	`POST /bfl/v1/flux-2-flex`
Flux.2 Pro	`POST /bfl/v1/flux-2-pro`

Flux 1

Оплата за изображение. См. цены на изображения. Kontext используется для контекстного редактирования с референсами.

Модель	Путь
Flux.1 Kontext Max	`POST /bfl/v1/flux-kontext-max`
Flux.1 Kontext Pro	`POST /bfl/v1/flux-kontext-pro`
Flux.1.1 Pro Ultra	`POST /bfl/v1/flux-pro-1.1-ultra`
Flux.1.1 Pro	`POST /bfl/v1/flux-pro-1.1`
Flux.1 Pro	`POST /bfl/v1/flux-pro`
Flux.1 Dev	`POST /bfl/v1/flux-dev`

Генерация изображений

Генерация видео

Генерация музыки

Текст / LLM

Аккаунт

Flux API

Flux API

Генерация и правка — один запрос

Положение элементов через рамки

Сначала кадр, потом четкость

Когда использовать Klein

Один полный вызов

Другие модели изображений

Flux 2

Flux 1

​Flux API

​Генерация и правка — один запрос

​Положение элементов через рамки

​Сначала кадр, потом четкость

​Когда использовать Klein

​Один полный вызов

​Другие модели изображений

​Flux 2

​Flux 1

Flux API

Генерация и правка — один запрос

Положение элементов через рамки

Сначала кадр, потом четкость

Когда использовать Klein

Один полный вызов

Другие модели изображений

Flux 2

Flux 1