Введение
FLUX.2 [flex] Edit запускает FLUX.2 [flex] от Black Forest Labs на ваших готовых изображениях. Он принимает от одного до трёх исходников и инструкцию — новый свет, новая сцена или добавленная надпись — и возвращает результат в 1k в пропорциях исходника или в одной из девяти пропорций.
Выберите режим по исходному материалу
| Что у вас есть | Режим |
|---|---|
| текстовый бриф | FLUX.2 [flex]: текст в изображение |
| изображения, которые нужно изменить или объединить | FLUX.2 [flex]: правка |
Ключевые возможности и особенности
Смена света с сохранением героя
В нашем тесте дневной портрет стал дождливой ночью с мокрыми камнями, светом витрины и каплями дождя, а женщина, её пальто и поза остались прежними.
Композиции из нескольких исходников
Ссылайтесь на каждый исходник по номеру и пишите, как они соединяются. В нашем тесте с духами флакон с одного фото встал на мраморный выступ с другого, а свет и отражение были согласованы.
Текст поверх результата
Берите в кавычки любой заголовок или надпись, которые нужно добавить. Наша композиция вернулась с заголовком, написанным как задано; «No.» на этикетке может вернуться знаком номера.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | До 5000 символов. Напишите, что изменить и что должно остаться прежним, и ссылайтесь на каждый исходник по номеру — image 1, image 2. Не менее 1 символов · Не более 5000 символов |
image_urls | Да | От 1 до 3 исходных изображений в том порядке, в каком на них ссылается промпт. Цена одинакова независимо от числа исходников. Не менее 1 элементов · Не более 3 элементов |
aspect_ratio | Нет | auto (по умолчанию) сохраняет примерно размер и пропорции первого исходника; либо выберите одну из девяти пропорций от 21:9 до 9:21. Пропорции на цену не влияют. |
resolution | Нет | Для правки доступно только 1k. Учитывается при выбранных фиксированных пропорциях; при auto размер результата повторяет первый исходник. |
seed | Нет | Необязательное целое число от 0 до 2147483647. Используйте его с тем же промптом и исходниками, чтобы сравнивать варианты рядом. |
Стоимость
$0.115 / изображение
Оплата за изображение по одной фиксированной цене: число исходников и соотношение сторон на неё не влияют. Отклонённые и неудачные запросы не оплачиваются.
Сценарии использования
Сцены с товарами
Перенесите предметный снимок в стилизованную обстановку и добавьте этикетку или заголовок.
Вариации настроения и погоды
Покажите один портрет на закате, под дождём или в неоновом свете клиенту, который выбирает направление.
Пейзажи и повседневные изображения
Меняйте время суток, сезон или фон пейзажа или уличной сцены.
Руководство по промптам и практические советы
Пишите, что остаётся
После описания изменения перечислите лицо, одежду и позу, которые должны остаться прежними.
Нумеруйте исходники
Пишите в промпте image 1 и image 2, чтобы у каждого исходника была понятная роль.
Держитесь безопасного материала
Редактирование отклоняет портреты гораздо охотнее, чем текст в изображение, даже на уровне «Мягкий», поэтому используйте его для товаров, пейзажей и повседневных портретов.
Выбирайте auto, чтобы сохранить кадр
С auto результат следует размеру первого исходника. Фиксированные пропорции выбирайте, только когда нужен другой кадр.
Закладывайте одну-две минуты
В наших тестах правки заняли от 45 до 120 секунд.
Быстрый старт 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-2-flex/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# 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.

























