Изображение

FLUX.1 Kontext API

FLUX.1 Kontext — семейство контекстных моделей для редактирования и генерации изображений по тексту с вариантами Pro и Max, предсказуемой ценой за изображение и асинхронной обработкой задач.

Контекстное редактированиеТекст в изображениеФиксированная цена за изображение

Получить API ключ Документация API

Преимущества сервиса

Официальные скидки
Оплата по факту
Быстро и без задержек

Input

Модель

Референсное изображение

Промпт

Соотношение сторон

Формат вывода

Зерно (необязательно)

Расширение промпта

Модерация контента

Допуск безопасности2

Результат

Image link valid for 72 hours

Цены на FLUX.1 Kontext API

Прозрачные цены без скрытых комиссий. Платите только за то, что используете.

Вариант	Золотая ценаТекущая цена	Платиновая цена	Бриллиантовая цена	Официальная цена	Ваша экономия
`flux-kontext-pro`	0.32Credits(~$0.032)/изобр	0.304Credits(~$0.0304)/изобр	0.288Credits(~$0.0288)/изобр	0.4Credits(~$0.04)/изобр	20%
`flux-kontext-max`	0.64Credits(~$0.064)/изобр	0.608Credits(~$0.0608)/изобр	0.576Credits(~$0.0576)/изобр	0.8Credits(~$0.08)/изобр	20%

* Фактические расходы зависят от конечного результата.

Возможности FLUX.1 Kontext API

Функции с акцентом на редактирование, понятные настройки и единый асинхронный процесс

Редактирование с учетом контекста

Меняйте фон, объект, цвет или визуальную обработку с помощью инструкций на естественном языке, а модель будет учитывать контекст исходного изображения.

До 4 референсных изображений

Передайте до четырех общедоступных URL изображений как подсказки для композиции и сохранения идентичности. Работа с несколькими референсами является экспериментальной функцией.

9 соотношений сторон

В поле size можно выбрать 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9 или 9:21.

Форматы вывода и контроль безопасности

Выбирайте формат PNG, JPEG или WebP и задавайте safety_tolerance в диапазоне от 0 до 6.

Единый асинхронный API

Отправьте запрос через POST /v1/images/generations, затем опрашивайте GET /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.

Фиксированная оплата за изображение

Каждый запрос возвращает одно изображение по фиксированной цене модели независимо от соотношения сторон и числа референсов. Средства за неудачные задачи возвращаются автоматически.

Варианты Pro и Max

Выбирайте flux-kontext-pro для более быстрой и доступной повседневной работы, а flux-kontext-max — когда качество результата важнее скорости и бюджета.

Расширение промпта и повторное использование seed

Включите prompt_upsampling, чтобы расширить инструкции, или повторно используйте фиксированный seed с теми же входными данными, чтобы повысить воспроизводимость результата.

Для каких задач подходит FLUX.1 Kontext

Используйте референс, когда важен визуальный контекст, или не добавляйте его для генерации по тексту

Товары, фоны и объекты

Создавайте варианты товарных изображений, заменяйте сцены или изменяйте отдельные объекты с помощью коротких инструкций.

Согласованность персонажей и стиля

Используйте существующее изображение как контекст, чтобы переносить черты персонажа или визуальный стиль в новые правки. Результат может зависеть от промпта и исходного изображения.

Экспериментальное объединение референсов

Сочетайте подсказки из нескольких изображений, например чтобы поместить объект в другую сцену или объединить визуальные референсы. Можно использовать до четырех изображений.

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

Отправьте промпт без image_urls, чтобы создать новое изображение с любым вариантом Kontext.

Материалы для кампаний и соцсетей

Адаптируйте ключевой визуал в варианты для кампаний или социальных сетей, а затем выберите поддерживаемое соотношение сторон для каждого места размещения.

Итерации креативной концепции

Начните с готового изображения, уточняйте отдельные элементы с помощью текстовых инструкций и исследуйте управляемые визуальные направления в ходе итераций.

Начало работы с FLUX.1 Kontext

Создайте аккаунт, пройдите аутентификацию, затем отправьте единую задачу генерации и опрашивайте ее статус

Создайте аккаунт и пополните баланс

Войдите в APIMart и пополните баланс. Одни и те же средства можно использовать для всех поддерживаемых моделей.

→

Создайте API-ключ

Создайте ключ в панели управления и передавайте его как Bearer-токен в заголовке Authorization.

→

Отправьте задачу и опрашивайте статус

Отправьте POST-запрос на /v1/images/generations, прочитайте data[0].task_id и опрашивайте /v1/tasks/{task_id} до статуса completed или failed.

Получить API-ключ

Пример FLUX.1 Kontext API: текст в изображение и редактирование

Вызовите flux-kontext-pro одним POST-запросом. Генерация асинхронная: отправьте задачу, затем опрашивайте эндпоинт задач, чтобы получить ссылку на изображение.

1
Авторизация запросов к FLUX.1 Kontext API
Сохраните ключ APIMart в переменной окружения APIMART_API_KEY и передавайте Authorization: Bearer <key> в каждом запросе.
2
Отправка задачи FLUX.1 Kontext
Отправьте POST /v1/images/generations с model flux-kontext-pro, промптом и size. Для редактирования добавьте image_urls — до четырёх референсов. Адреса example.com — заглушки: замените их своими общедоступными изображениями или данными Base64. ID задачи — в data[0].task_id.
3
Получение результата FLUX.1 Kontext
Опрашивайте GET /v1/tasks/{task_id}, пока status не станет completed, затем возьмите ссылку на изображение из data.result.images[0].url[0]. APIMart хранит результаты 72 часа, поэтому скачайте нужные изображения заранее.
Все параметры, размеры вывода и поля ответа описаны в справочнике FLUX.1 Kontext API.

POST /v1/images/generations

curl -X POST https://api.apimart.ai/v1/images/generations \
  -H "Authorization: Bearer $APIMART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-kontext-pro",
    "prompt": "Уютный уголок для чтения с зелёным креслом, тёплый свет лампы и дождь за окном",
    "size": "4:3",
    "output_format": "png"
  }'

import os
import time
import requests

API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}

# 1. Submit the generation task
payload = {
  "model": "flux-kontext-pro",
  "prompt": "Уютный уголок для чтения с зелёным креслом, тёплый свет лампы и дождь за окном",
  "size": "4:3",
  "output_format": "png"
}
resp = requests.post(f"{API_BASE}/v1/images/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]

# 2. Poll the task until it finishes
for _ in range(200):
    task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
    task_resp.raise_for_status()
    task = task_resp.json()["data"]
    if task["status"] == "completed":
        print(task["result"]["images"][0]["url"][0])
        break
    if task["status"] == "failed":
        raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
    time.sleep(3)
else:
    raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")

curl -X POST https://api.apimart.ai/v1/images/generations \
  -H "Authorization: Bearer $APIMART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-kontext-pro",
    "prompt": "Замените куртку на тёмно-красную кожаную, сохранив лицо, позу и фон без изменений",
    "size": "auto",
    "output_format": "png",
    "image_urls": [
      "https://example.com/portrait.jpg"
    ]
  }'

TASK_ID="task_xxx"  # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $APIMART_API_KEY"

Параметры FLUX.1 Kontext API

Параметр	Тип	Обязательный	По умолчанию	Описание
`model`	string	Да	По умолчанию: flux-kontext-pro	flux-kontext-pro или flux-kontext-max.
`prompt`	string	Да	По умолчанию: —	Опишите изображение или правку, которую нужно применить к референсам.
`image_urls`	string[]	Нет	По умолчанию: —	До 4 референсов: публичные URL или Base64. Для текста в изображение не передавайте.
`size`	string	Нет	По умолчанию: 1:1	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9, 9:21 или auto. Вывод около 1 МП: width и height приводят к ошибке задачи, а resolution не влияет на результат.
`output_format`	string	Нет	По умолчанию: png	png, jpeg или webp.
`seed`	integer	Нет	По умолчанию: —	Тот же seed и входные данные помогают воспроизвести результат; без него seed случайный.
`prompt_upsampling`	boolean	Нет	По умолчанию: false	Модель расширяет и переписывает промпт перед генерацией.
`safety_tolerance`	integer	Нет	По умолчанию: 2	От 0 (строже всего) до 6.
`nsfw_check`	boolean	Нет	По умолчанию: false	Проверка промпта и входных изображений через omni-moderation-latest перед отправкой.

Сравнение моделей FLUX API на APIMart

Один API-ключ APIMart открывает доступ ко всем моделям FLUX ниже. Модели изображений тарифицируются за изображение, FLUX 3 Video — за секунду видео.

Модель	Подходит для	Выход
FLUX 3 Image API	FLUX 3 API для изображений: генерация и редактирование по 10 референсам, поиск-граундинг, вывод до 4K	от 768sq до 4K (около 16 МП)
FLUX 3 Image Klein API	Более дешёвые изображения FLUX 3 с seed, 1–16 шагами и выводом PNG или JPEG	от 768sq до 4K (около 16 МП)
FLUX 3 Video API	Текст в видео, 1–10 ключевых кадров, продолжение видео и черновики со синхронным звуком	HD или FHD, 5–20 с
FLUX.2 API	Выбор между FLUX.2 Pro, Max и Flex на одной странице	1–4 МП
FLUX.2 Pro API	Баланс качества и стоимости для продакшена, до 8 референсов	1–4 МП
FLUX.2 Max API	Максимальное качество в линейке FLUX.2, до 8 референсов	1–4 МП
FLUX.2 Flex API	Настраиваемые steps и guidance для типографики и макетов	1–4 МП
FLUX.1 Kontext APIЭта страница	Выбор между FLUX.1 Kontext Pro и Max на одной странице	около 1 МП
FLUX.1 Kontext Pro API	Контекстное редактирование по фиксированной цене за изображение, до 4 референсов	около 1 МП
FLUX.1 Kontext Max API	Более качественное редактирование Kontext с точным следованием промпту	около 1 МП

Частые вопросы о FLUX.1 Kontext

Выбор модели, входные данные, настройки, оплата и выполнение задач

Что такое FLUX.1 Kontext?

FLUX.1 Kontext — семейство контекстно-зависимых моделей изображений от Black Forest Labs. Оно создано прежде всего для редактирования изображений по текстовым инструкциям, но также умеет генерировать изображения только по тексту.

Чем Pro отличается от Max?

Обе модели поддерживают текст в изображение и редактирование по референсам — до четырёх, вывод около 1 МП. flux-kontext-pro — более дешёвый вариант для повседневных правок; flux-kontext-max даёт более высокое качество и точнее следует промпту, но стоит вдвое дороже за изображение. Время выполнения зависит от задачи и нагрузки.

Когда вышел FLUX.1 Kontext?

Black Forest Labs выпустила FLUX.1 Kontext, включая модели [pro] и [max], 29 мая 2025 года. На APIMart они вызываются как flux-kontext-pro и flux-kontext-max.

Сколько референсных изображений можно отправить?

В image_urls можно передать до четырех URL. Суммарный размер выходного изображения и всех референсов не должен превышать 9 MP. Использование нескольких референсов является экспериментальной функцией, и каждый URL должен быть общедоступным.

Можно ли указать произвольный размер изображения?

Kontext выводит около 1 MP; resolution не действует, а width или height отклоняются. В size можно указать одно из девяти поддерживаемых соотношений либо строку WIDTHxHEIGHT; строка с пикселями преобразуется в ближайшее поддерживаемое соотношение. Фактическое соотношение для 16:9 и 9:16 может отклоняться примерно на 4%.

Какие форматы и настройки seed доступны?

Для выбора png, jpeg или webp используйте output_format. Параметр seed необязателен и по умолчанию выбирается случайно; повторное использование фиксированного seed с теми же входными данными помогает воспроизвести результат.

Может ли Max переписать мой промпт?

Это возможно. Во время замеров flux-kontext-max расширял промпт, даже когда prompt_upsampling не был включен явно. Учитывайте возможность переформулировки и проверяйте результаты, если формулировку необходимо сохранить без изменений.

Как работают асинхронные задачи, возвраты и общедоступные URL?

Отправьте запрос на генерацию и опрашивайте полученный task_id до статуса completed или failed. Средства за неудачные задачи возвращаются автоматически. URL референсов должны быть общедоступными; хосты, блокирующие трафик из дата-центров, могут помешать загрузке, поэтому используйте надежный публичный URL.

Сколько стоит FLUX.1 Kontext API?

FLUX.1 Kontext API тарифицируется за каждое изображение. Базовые цены на APIMart (октябрь 2026): flux-kontext-pro стоит $0.04, а flux-kontext-max — $0.08 за изображение, без доплат за соотношение сторон и число референсов. Для участников Gold — $0.032 и $0.064, Platinum и Diamond экономят до 28%. Неудачные задачи возвращаются, итоговое списание — в поле cost завершённой задачи.

Как получить API-ключ FLUX.1 Kontext?

Зарегистрируйтесь в APIMart, откройте страницу API Keys в личном кабинете и создайте ключ. Один и тот же ключ подходит для Black Forest Labs FLUX.1 Kontext API и всех остальных моделей платформы; оплата по факту использования, без подписки.

Как пользоваться FLUX.1 Kontext API и где документация?

Передайте API-ключ APIMart как Bearer-токен и отправьте POST на /v1/images/generations, указав model = flux-kontext-pro или flux-kontext-max, промпт и при необходимости image_urls. Возьмите data[0].task_id из ответа и опрашивайте /v1/tasks/{task_id}, пока задача не перейдёт в статус completed или failed. Все параметры и примеры кода для Flux Kontext API — в документации APIMart (docs.apimart.ai).

Бесплатен ли FLUX.1 Kontext API?

Нет. У FLUX.1 Kontext API на APIMart нет бесплатного лимита. Оплата по факту использования, тарификация за каждое сгенерированное изображение, а за неудачные задачи средства возвращаются автоматически. Участники Gold получают скидку 20%, а уровни Platinum и Diamond — до 28%. Актуальные цены на Pro и Max — в таблице цен на этой странице.

Какие модели Flux API доступны в APIMart?

APIMart предоставляет три семейства моделей Black Forest Labs по одному API-ключу. FLUX 3 Image (flux-3-image) и FLUX 3 Image Klein (flux-3-image-klein) генерируют и редактируют изображения по 10 референсам; FLUX.2 (flux-2-pro, flux-2-max и flux-2-flex) — генерация и редактирование по 8 референсам; FLUX.1 Kontext (flux-kontext-pro и flux-kontext-max) специализируется на контекстном редактировании. Все модели изображений используют POST /v1/images/generations, а FLUX 3 Video (flux-3-video) — POST /v1/videos/generations.

Что выбрать для редактирования: FLUX.1 Kontext, FLUX.2 или FLUX 3 Image?

FLUX.1 Kontext подходит для быстрых контекстных правок по фиксированной цене за изображение: вывод около 1 МП и до 4 референсов. FLUX.2 Pro, Max и Flex выдают до 4 МП, принимают до 8 референсов и тарифицируются по мегапикселям. FLUX 3 Image принимает до 10 референсов и выводит до 4K с ценой по разрешению. Все три работают с одним ключом APIMart; таблица сравнения на этой странице ведёт к каждой модели.

Частые вопросы о FLUX.1 Kontext

Выбор модели, входные данные, настройки, оплата и выполнение задач

FLUX.1 Kontext API

Цены на FLUX.1 Kontext API

Возможности FLUX.1 Kontext API

Для каких задач подходит FLUX.1 Kontext

Начало работы с FLUX.1 Kontext

Создайте аккаунт и пополните баланс

Создайте API-ключ

Отправьте задачу и опрашивайте статус

Пример FLUX.1 Kontext API: текст в изображение и редактирование

Авторизация запросов к FLUX.1 Kontext API

Отправка задачи FLUX.1 Kontext

Получение результата FLUX.1 Kontext

Параметры FLUX.1 Kontext API

Сравнение моделей FLUX API на APIMart

Частые вопросы о FLUX.1 Kontext

Что такое FLUX.1 Kontext?

Чем Pro отличается от Max?

Когда вышел FLUX.1 Kontext?

Сколько референсных изображений можно отправить?

Можно ли указать произвольный размер изображения?

Какие форматы и настройки seed доступны?

Может ли Max переписать мой промпт?

Как работают асинхронные задачи, возвраты и общедоступные URL?

Сколько стоит FLUX.1 Kontext API?

Как получить API-ключ FLUX.1 Kontext?

Как пользоваться FLUX.1 Kontext API и где документация?

Бесплатен ли FLUX.1 Kontext API?

Какие модели Flux API доступны в APIMart?

Что выбрать для редактирования: FLUX.1 Kontext, FLUX.2 или FLUX 3 Image?

Похожие модели

Статьи о FLUX.1 Kontext

Возможности FLUX.1 Kontext API

Для каких задач подходит FLUX.1 Kontext

Начало работы с FLUX.1 Kontext

Создайте аккаунт и пополните баланс

Создайте API-ключ

Отправьте задачу и опрашивайте статус

Частые вопросы о FLUX.1 Kontext

Что такое FLUX.1 Kontext?

Чем Pro отличается от Max?

Когда вышел FLUX.1 Kontext?

Сколько референсных изображений можно отправить?

Можно ли указать произвольный размер изображения?

Какие форматы и настройки seed доступны?

Может ли Max переписать мой промпт?

Как работают асинхронные задачи, возвраты и общедоступные URL?

Сколько стоит FLUX.1 Kontext API?

Как получить API-ключ FLUX.1 Kontext?

Как пользоваться FLUX.1 Kontext API и где документация?

Бесплатен ли FLUX.1 Kontext API?

Какие модели Flux API доступны в APIMart?

Что выбрать для редактирования: FLUX.1 Kontext, FLUX.2 или FLUX 3 Image?

Похожие модели