Введение
FLUX.1 Kontext [pro] Текст в изображение — более быстрая из двух коммерческих моделей Kontext, которые Black Forest Labs выпустила 29 мая 2025 года. Kontext задуман как контекстная модель: та же сеть, что рисует картинку по фразе, может потом взять эту картинку обратно и изменить в ней одну вещь. Этот эндпоинт — первая половина такого цикла. Вы описываете сцену, получаете фото примерно в один мегапиксель и отправляете удачный кадр в эндпоинт редактирования, когда нужен другой наряд, другой свет или исправленная вывеска.
Выбор режима по исходному материалу
| Что у вас есть | Режим |
|---|---|
| только описание сцены | FLUX.1 Kontext [pro] Текст в изображение |
| одно фото, которое нужно изменить | FLUX.1 Kontext [pro] Редактирование |
Ключевые возможности и особенности
Надпись появляется там, где вы её поставили
Kontext [pro] читает слова в кавычках как буквы, которые нужно нарисовать. В нашем тесте с туалетным столиком мы попросили записку помадой на зеркале и получили «Room 412 - Midnight» красным рукописным штрихом на стекле; в тесте с мотелем «PALM COURT» стал розовой неоновой вывеской с рукописным шрифтом. Оба варианта написаны так, как было задано.
Шесть форматов, около мегапикселя каждый
Квадрат, два горизонтальных, два вертикальных и сверхширокий 21:9. Каждый возвращается примерно в одном мегапикселе: 1280x720 при 16:9, 864x1152 при 3:4 и 1520x656 при 21:9 в наших запусках.
Создано для последующей правки
Кадры из этого эндпоинта сразу уходят в эндпоинт редактирования. Там та же модель меняет одежду, погоду или текст, сохраняя лицо и позу, поэтому сцена, нарисованная здесь, — хороший первый кадр для серии.
Быстрый ответ
Большинство наших запусков текста в изображение завершились за 10–30 секунд, включая 21:9 и 9:16.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Обязательно, до 5000 символов. Опишите человека, одежду, место, свет и объектив предложениями; слова в кавычках рисуются как надпись. Не менее 1 символов · Не более 5000 символов |
aspect_ratio | Нет | Одно из 1:1 (по умолчанию), 16:9, 9:16, 4:3, 3:4 или 21:9. Каждый формат — около мегапикселя и стоит одинаково. |
output_format | Нет | jpeg (по умолчанию) для файлов поменьше, png для вывода без потерь. Формат на цену не влияет. |
enable_prompt_expansion | Нет | По умолчанию выключено. Если включить, Kontext [pro] добавит описательных деталей в промпт перед генерацией; это помогает коротким промптам и может занять чуть больше времени. По умолчанию: |
Стоимость
$0.028 / изображение
Генерация по тексту в Kontext [pro] оплачивается за изображение; формат, тип файла и расширение промпта цену не меняют. Отклонённые и неудачные запросы не оплачиваются.
Сценарии использования
Доски персонажей и гардероба
Нарисуйте человека один раз в подходящей для истории обстановке, а затем разветвите этот кадр на наряды и настроения правками, вместо того чтобы каждый раз генерировать новое лицо.
Вывески, записки и реквизит
Двери отелей, неон, рукописные записки и этикетки, где в определённом месте должны стоять определённые слова.
Кадры для соцсетей и кампаний
9:16 для сторис, 16:9 для шапок и 21:9 для баннеров из одного и того же текстового брифа.
Руководство по промптам и практические советы
Описывайте кадр, а не список тегов
Кто, во что одет, где находится, откуда падает свет и какой объектив угадывается. Kontext [pro] лучше следует обычным предложениям, чем цепочкам ключевых слов.
Каждое нужное слово — в кавычки
Пишите точный текст в кавычках и указывайте, где он находится: на зеркале, над дверью, на билете.
Расширение промпта для коротких запросов
Промпт в одну строку может дать плоский результат. Включите расширение промпта, чтобы модель добавила деталей, или оставьте его выключенным, когда важно каждое слово.
Думайте о шаге редактирования заранее
Если позже собираетесь менять наряд, сейчас чётко опишите лицо, волосы и позу — именно за них будет держаться правка.
Быстрый старт 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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1",
"output_format": "jpeg"
}
}'
# 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.


























