Введение
FLUX.2 Dev: правка изменяет или объединяет до трёх исходных изображений на FLUX.2 [dev] от Black Forest Labs — модели с открытыми весами и 32 миллиардами параметров. Опишите новый наряд, место или свет, назовите, что должно остаться, и получите одно изображение. Лица остаются близкими к исходникам, людей с разных фото можно поместить в одну сцену, а фильтр не применяется ни к исходникам, ни к промпту, ни к результату.
Выберите режим по исходному материалу
| Что у вас есть | Режим |
|---|---|
| от одного до трёх изображений, которые нужно изменить или объединить | FLUX.2 Dev: правка |
| только текстовый бриф | FLUX.2 Dev: текст в изображение |
Ключевые возможности и особенности
До трёх референсов
Перечисляйте изображения в том порядке, в каком их называет промпт, и ссылайтесь на них как image 1, image 2 и image 3. В нашем тесте женщина с одного портрета и мужчина с другого танцевали вместе в новой сцене, а оба лица остались близки к фото.
Кадрирование по исходнику
При auto результат сохраняет пропорции первого изображения в размере около мегапикселя. Выбирайте соотношение сторон и 2k, когда нужен другой кроп или больше пикселей.
Одна фиксированная цена
Цена за изображение одинакова для одного, двух или трёх исходников и для 1k или 2k.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | До 5000 символов. Напишите, что изменить и что должно остаться прежним. Не менее 1 символов · Не более 5000 символов |
image_urls | Да | От одного до трёх исходных изображений, до 10 МБ каждое, в том порядке, в каком на них ссылается промпт («image 1», «image 2»). Лучше всего лица сохраняются с чётких фото анфас. Не менее 1 элементов · Не более 3 элементов |
aspect_ratio | Нет | auto (по умолчанию) сохраняет пропорции первого исходного изображения при размере около мегапикселя. Выберите одну из девяти пропорций от 21:9 до 9:21, чтобы перекадрировать. |
resolution | Нет | 1k (по умолчанию) или 2k; учитывается только при выбранном соотношении сторон. При auto результат остаётся около мегапикселя. |
seed | Нет | Целое число от 0 до 2147483647. Оставляйте его неизменным, пока меняете промпт, — так результаты проще сравнивать; он не гарантирует одинаковое изображение и не влияет на цену. |
Стоимость
$0.023 / изображение
Оплата за изображение по единой цене — независимо от числа исходников и уровня размера. Неудачные запросы не оплачиваются.
Сценарии использования
Новый наряд и обстановка для того же человека
Перенесите человека из офиса в бар или с улицы на пляж, сменив наряд и свет, — лицо останется прежним.
Двое людей в одной сцене
Соберите людей с отдельных портретов в один кадр для парного снимка или пары персонажей.
Новый свет и смена цвета
Попросите новый источник света заданного hex-цвета и сохраните остальную композицию.
Руководство по промптам и практические советы
Скажите, что остаётся
Начните с «same man, same face and beard», затем перечислите, что меняется. Короткие чёткие списки работают лучше длинных описаний.
Нумеруйте людей
При объединении фото пишите «the woman from image 1 and the man from image 2» и просите сохранить оба лица в точности как на фото.
Когда важно, держите в кадре одного человека
Добавьте «alone in the frame, no other people», чтобы на заднем плане не появлялись лишние фигуры.
Начинайте с auto
Сначала оставьте auto. Когда содержание вас устроит, выберите соотношение сторон и 2k и сохраните seed, чтобы сравнить увеличенную версию.
Берите чёткие исходники
Хорошо освещённые фото анфас лучше всего переносят лица. Второй и третий человек получаются чуть менее устойчиво, чем первый.
Быстрый старт 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-dev/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.
























