Введение
FLUX.1 Kontext [pro] Редактирование принимает одно фото и письменную инструкцию и возвращает то же фото с выполненной инструкцией. Black Forest Labs представила Kontext 29 мая 2025 года как модель, которая редактирует в контексте: она читает присланное изображение, а не перерисовывает сцену с нуля, поэтому лица, позы, комнаты и надписи переживают правки, после которых модели «текст в изображение» пришлось бы начинать заново.
Выбор режима по исходному материалу
| Что у вас есть | Режим |
|---|---|
| одно фото, которое нужно изменить | FLUX.1 Kontext [pro] Редактирование |
| только описание сцены | FLUX.1 Kontext [pro] Текст в изображение |
Ключевые возможности и особенности
Локальная правка, остальное не трогается
В тесте с туалетным столиком атласную сорочку цвета шампанского заменили чёрным кружевом. Лицо, волосы, лампочки и надпись помадой на зеркале остались на своих местах.
Погода, время суток и свет в том же кадре
Бассейн мотеля превратился из сумерек в дождливую ночь: дождь на воде, неон в мокрой плитке, промокшая рубашка, а лицо и поза мужчины не изменились.
Вывески и надписи переживают правку
Текст, который уже есть на фото, сохраняется, если не попросить его изменить, а новый текст можно добавить в кавычках.
Сохранить формат или задать новый
Если соотношение сторон стоит на auto, результат повторяет исходник: фото 1344x768 вернулось в 1328x752, а квадрат — в 992x992. Выберите соотношение, чтобы обрезать или расширить кадр.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Обязательно, до 5000 символов. Начните с изменения, затем назовите, что должно остаться: лицо, волосы, поза, фон, существующие надписи. Не менее 1 символов · Не более 5000 символов |
image_url | Да | Обязательно. Одно фото 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 | Нет | По умолчанию выключено. Если включить, инструкция дополняется деталями перед правкой; оставьте выключенным, когда формулировка правки должна выполняться дословно. По умолчанию: |
Стоимость
$0.028 / изображение
Правки Kontext [pro] оплачиваются за изображение, как и генерация по тексту, независимо от размера и формы исходника. Отклонённые и неудачные запросы не оплачиваются.
Сценарии использования
Примерка нарядов и стайлинг
Один портрет — несколько образов: атлас, кружево, пиджак, халат, каждый как отдельная правка одного исходника.
Варианты настроения и света
День в ночь, сухо в дождь, тёплое в холодное — без потери человека в кадре.
Непрерывность серии
Отправляйте каждый результат как следующий исходник и ведите персонажа через цепочку небольших контролируемых изменений.
Исправление детали
Поменять текст на вывеске, убрать предмет, перекрасить одежду.
Руководство по промптам и практические советы
Сначала изменение, потом якоря
Сначала «Замени сорочку на чёрное кружево», затем «Сохрани в точности лицо, волосы, позу и надпись на зеркале».
Называйте вещи по внешнему виду
Пишите «атласная сорочка цвета шампанского», а не «её одежда»: модель находит область по описанию.
Одна правка за проход
Несколько небольших правок подряд лучше сохраняют узнаваемость, чем одна длинная инструкция, переписывающая всё.
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-pro/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.


























