Flux Kontext API

Flux Kontext API

Flux Kontext из линейки FLUX.1 умеет две вещи: рисовать картинку по тексту и точечно править готовое изображение. Сильная сторона - именно правки: заменить фон, переодеть человека, убрать лишний предмет, поменять надпись на вывеске, сохранив всё остальное в кадре.

Сценарии:

• Генерация - запуск без inputImage, картинка создаётся с нуля.
• Редактирование - запуск с одной ссылкой в inputImage и заданием, что поменять.

Модель понимает задания только на английском. По умолчанию включён автоперевод, так что можно писать и по-русски.

Каждый вызов создаёт асинхронную операцию. После запуска сохраните её id и проверяйте статус отдельным запросом.

Создание операции

• Endpoint: POST /api/v1/operations
• Авторизация: Authorization: Bearer brth_...
• Выполнение асинхронное: запрос сразу возвращает id и стартовый статус queued.

Версия модели выбирается параметром model:

• flux-kontext-pro - быстрые повседневные правки и генерации, 5 ₽;
• flux-kontext-max - аккуратнее с деталями, сложными сценами и надписями, 8 ₽.

Режим редактирования включается наличием поля inputImage.

Тело запроса

{
  "tool": "flux-kontext",
  "input": {
    "model": "flux-kontext-pro",
    "prompt": "...",
    "aspectRatio": "auto",
    "outputFormat": "jpeg"
  }
}

• tool - slug нейросети, всегда "flux-kontext".
• input - параметры запуска. Все поля передаются прямо внутри этого объекта, без дополнительной вложенности.

Параметры

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

Генерация по тексту

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "flux-kontext",
  "input": {
    "model": "flux-kontext-pro",
    "prompt": "Витрина маленькой пекарни утром, на полках круассаны и багеты, над дверью вывеска «Хлеб и кофе», мягкий солнечный свет",
    "enableTranslation": true,
    "aspectRatio": "4:3",
    "outputFormat": "jpeg"
  }
}'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'flux-kontext',
    input: {
      model: 'flux-kontext-pro',
      prompt:
        'Витрина маленькой пекарни утром, на полках круассаны и багеты, над дверью вывеска «Хлеб и кофе», мягкий солнечный свет',
      enableTranslation: true,
      aspectRatio: '4:3',
      outputFormat: 'jpeg',
    },
  }),
})

const data = await response.json()
console.log(data.id, data.status)

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        'tool': 'flux-kontext',
        'input': {
            'model': 'flux-kontext-pro',
            'prompt': 'Витрина маленькой пекарни утром, на полках круассаны и багеты, над дверью вывеска «Хлеб и кофе», мягкий солнечный свет',
            'enableTranslation': True,
            'aspectRatio': '4:3',
            'outputFormat': 'jpeg',
        },
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Редактирование изображения

Модель меняет только то, что указано в задании. При aspectRatio: "auto" результат сохраняет пропорции исходного фото.

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "flux-kontext",
  "input": {
    "model": "flux-kontext-pro",
    "prompt": "Сделай фон ночным городом с неоновыми вывесками, человека и позу не меняй",
    "inputImage": "https://cdn.example.com/portrait-1.jpg",
    "enableTranslation": true,
    "aspectRatio": "auto",
    "outputFormat": "jpeg"
  }
}'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'flux-kontext',
    input: {
      model: 'flux-kontext-pro',
      prompt: 'Сделай фон ночным городом с неоновыми вывесками, человека и позу не меняй',
      inputImage: 'https://cdn.example.com/portrait-1.jpg',
      enableTranslation: true,
      aspectRatio: 'auto',
      outputFormat: 'jpeg',
    },
  }),
})

const data = await response.json()

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        'tool': 'flux-kontext',
        'input': {
            'model': 'flux-kontext-pro',
            'prompt': 'Сделай фон ночным городом с неоновыми вывесками, человека и позу не меняй',
            'inputImage': 'https://cdn.example.com/portrait-1.jpg',
            'enableTranslation': True,
            'aspectRatio': 'auto',
            'outputFormat': 'jpeg',
        },
    },
    timeout=30,
)

print(response.json())

Редактирование в версии Max, задание на английском

Когда задание уже на английском, автоперевод можно выключить. Версия Max аккуратнее меняет надписи.

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "flux-kontext",
  "input": {
    "model": "flux-kontext-max",
    "prompt": "Replace the text on the shop sign with \"FRESH BREAD\", keep the font style and everything else unchanged",
    "inputImage": "https://cdn.example.com/shop-front.png",
    "enableTranslation": false,
    "aspectRatio": "auto",
    "outputFormat": "png",
    "promptUpsampling": false
  }
}'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'flux-kontext',
    input: {
      model: 'flux-kontext-max',
      prompt:
        'Replace the text on the shop sign with "FRESH BREAD", keep the font style and everything else unchanged',
      inputImage: 'https://cdn.example.com/shop-front.png',
      enableTranslation: false,
      aspectRatio: 'auto',
      outputFormat: 'png',
      promptUpsampling: false,
    },
  }),
})

const data = await response.json()

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        'tool': 'flux-kontext',
        'input': {
            'model': 'flux-kontext-max',
            'prompt': 'Replace the text on the shop sign with "FRESH BREAD", keep the font style and everything else unchanged',
            'inputImage': 'https://cdn.example.com/shop-front.png',
            'enableTranslation': False,
            'aspectRatio': 'auto',
            'outputFormat': 'png',
            'promptUpsampling': False,
        },
    },
    timeout=30,
)

print(response.json())

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

Ответ после создания

{
  "id": "op_uuid-123",
  "status": "queued",
  "tool": "flux-kontext",
  "cost": 5,
  "balance_after": 495,
  "created_at": "2026-09-30T12:45:51.971762+00:00"
}

Ответ после завершения

{
  "id": "op_uuid-123",
  "status": "completed",
  "tool": "flux-kontext",
  "cost": 5,
  "created_at": "2026-09-30T12:45:51.971762+00:00",
  "completed_at": "2026-09-30T12:46:21.540316+00:00",
  "result": {
    "type": "image",
    "urls": [
      "https://storage.bratuha.ru/results/flux-kontext/image-1.jpg"
    ]
  },
  "error_message": null
}

Ответ при ошибке

{
  "id": "op_uuid-123",
  "status": "failed",
  "tool": "flux-kontext",
  "cost": 5,
  "created_at": "2026-09-30T12:45:51.971762+00:00",
  "completed_at": "2026-09-30T12:46:05.180442+00:00",
  "result": null,
  "error_message": "Ваш запрос не прошел модерацию."
}

Проверка статуса

Сохраните id из ответа на создание и запрашивайте статус операции по нему:

GET /api/v1/operations/{id}

curl -H "Authorization: Bearer brth_ваш_ключ" \
  https://bratuha.ru/api/v1/operations/op_uuid-123

async function waitForResult(id: string) {
  while (true) {
    const response = await fetch(`https://bratuha.ru/api/v1/operations/${id}`, {
      headers: { Authorization: 'Bearer brth_ваш_ключ' },
    })
    const operation = await response.json()
    if (operation.status === 'completed' || operation.status === 'failed') {
      return operation
    }
    await new Promise((resolve) => setTimeout(resolve, 5000))
  }
}

Статус меняется с queued на processing, а затем на completed или failed. Обычно результат готов за 20-40 секунд. Опрашивать одну операцию можно не чаще раза в секунду, разумный интервал - 3-5 секунд.

Формат результата

{
  "type": "image",
  "urls": [
    "https://storage.bratuha.ru/results/flux-kontext/image-1.jpg"
  ]
}

• type - всегда "image".
• urls - массив с одной ссылкой на готовое изображение в выбранном outputFormat.

Результат около 1 мегапикселя. Например, портрет 768×1152 при aspectRatio: "auto" возвращается размером 816×1232.

Ценообразование

Цена фиксирована за одно изображение и зависит только от версии модели. Генерация и редактирование стоят одинаково, автоперевод и улучшение задания бесплатны.

Стоимость списывается при создании операции и приходит в поле cost ответа.

Ограничения и практические заметки

• POST /api/v1/operations не идемпотентен: каждый повторный запрос создаёт новую оплаченную операцию. Если ответ потерялся, не повторяйте запрос вслепую.
• Все операции асинхронные: сначала приходит queued, результат забирается по id.
• В inputImage передаётся одна внешняя ссылка http/https. Ссылка должна открываться без авторизации. Несколько изображений за раз модель не принимает.
• Модель понимает только английский. Если выключить enableTranslation и написать по-русски, модель может понять задание неправильно.
• Запросы проходят модерацию. Если запрос её не прошёл, операция завершится со статусом failed и сообщением «Ваш запрос не прошел модерацию.»
• Сложные правки надёжнее делать по шагам: сначала фон, потом одежда, потом свет. Каждый шаг - новая операция, где inputImage - результат предыдущего.
• Чтобы модель не трогала лишнее, прямо пишите, что должно остаться как есть: «лицо и позу не меняй».