Введение
FLUX.1 Kontext [max] Редактирование меняет стиль фото или правит его по письменной инструкции с помощью премиальной модели Kontext от Black Forest Labs, выпущенной 29 мая 2025 года. Это уровень для правок, которые затрагивают весь кадр — новую эпоху, другое время суток или другой сезон, — когда люди и надписи всё равно должны остаться невредимыми.
Какой режим подходит вашему материалу
| Что у вас есть | Режим |
|---|---|
| готовое фото для смены стиля или правки | FLUX.1 Kontext [max] Редактирование |
| описание сцены, а картинки пока нет | FLUX.1 Kontext [max] Текст в изображение |
Ключевые возможности и особенности
Смена стиля всего кадра без замены актёров
Наша пара на крыше стала чёрно-белым кадром фильма-нуар 1950-х с жёстким рисующим светом. Оба лица, объятие и силуэт платья сохранились; вывеска осталась читаемой, лишь слегка обрезанной новым кадрированием.
Смена времени суток и сезона
Купе ночного поезда перенеслось в рассвет над заснеженными горами, красный халат стал шёлком цвета слоновой кости, а бокал вина — чашкой кофе; лицо женщины и поза с поджатыми ногами не изменились.
Несколько изменений в одной инструкции
В правке купе Kontext [max] выполнил сразу три изменения — свет, одежду и реквизит, — не затронув остального.
Формат следует за исходником
С auto результат сохраняет кадрирование исходника: крыша 16:9 вернулась в 1328x752, купе 3:4 — в 864x1152.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Обязательно, до 5000 символов. Сначала назовите новый образ или изменения, затем якоря: лица, позу, крой одежды и любые надписи, которые нужно сохранить. Не менее 1 символов · Не более 5000 символов |
image_url | Да | Обязательно. Единственное фото, которое правит Kontext [max]: JPEG, PNG или WebP до 10 МБ. Не менее 1 символов |
aspect_ratio | Нет | auto (по умолчанию) повторяет исходное фото. Выберите 1:1, 16:9, 9:16, 4:3, 3:4 или 21:9, чтобы перекадрировать; цена та же. |
output_format | Нет | jpeg (по умолчанию) или png, без разницы в цене. |
enable_prompt_expansion | Нет | По умолчанию выключено. Если включить, перед правкой Kontext [max] добавит в инструкцию описательные детали; не включайте, когда правка должна сделать ровно то, что вы написали. По умолчанию: |
Стоимость
$0.056 / изображение
Каждая правка Kontext [max] оплачивается за изображение по той же фиксированной ставке, что и генерация по тексту. За отклонённые и сбойные запросы плата не взимается.
Сценарии использования
Эпохи и жанры
Нуар, цветная плёнка 1970-х, глянцевый журнал: одно фото, переснятое в другой эпохе для кампании или мудборда.
Непрерывность в течение дня
Утренняя версия, золотой час и ночь одной и той же сцены с теми же людьми.
Смена гардероба и реквизита на готовых кадрах
Замените халат, бокал, сумку или шляпу на изображении, которое вам уже нравится.
Спасти почти удачный кадр
Исправьте единственное, что не так в хорошем изображении, вместо новой генерации.
Руководство по промптам и практические советы
Сначала образ, затем якоря
«Сделай из фото чёрно-белый кадр нуара 1950-х», а затем «оставь оба лица, их позу и вывеску как есть».
Группируйте связанные изменения
Свет, одежда и реквизит могут уместиться в одну инструкцию, если описывают один новый момент, как рассвет с халатом цвета слоновой кости и кофе.
Называйте надписи, которые нужно сохранить
Называйте вывеску или этикетку её словами, чтобы правка считала её тем, что нужно сберечь.
Обрезайте осознанно
Выбирайте соотношение, только если нужен новый кадр; иначе auto избавит от неожиданной обрезки.
Сравнивайте лица после крупной смены стиля
Смена эпохи и света — самое тяжёлое испытание для узнаваемости. Положите результат рядом с исходником; если лицо уплыло, повторите правку, поставив лицо первым в списке того, что нужно сохранить.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "black-forest-labs/flux-1-kontext-max/edit",
"input": {
"aspect_ratio": "auto",
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.


























