Введение
FLUX.2 [max] Edit запускает модель FLUX.2 высшего качества от Black Forest Labs на ваших готовых фото. Она принимает от одного до трёх исходников и инструкцию, а возвращает изображение в пропорциях первого исходника или в одной из девяти пропорций, в 1k или 2k.
Выберите режим по исходному материалу
| Что у вас есть | Режим |
|---|---|
| текстовый бриф | FLUX.2 Max: текст в изображение |
| от одного до трёх фото, которые нужно изменить или объединить | FLUX.2 Max: правка |
Ключевые возможности и особенности
До трёх референсов
Объединяйте людей и места из разных фото в одном запросе. В нашем тесте с книжным магазином два портрета и интерьер превратились в одну сцену: у каждой героини сохранились лицо, причёска и одежда, а свет ламп магазина лёг на обеих.
Смена фона и света
Замените студийный фон гаванью в золотой час и переставьте свет на герое, не меняя лицо, бороду, выражение и одежду.
Одна цена за правку
Правка оплачивается за изображение по единой цене — независимо от числа исходников и уровня размера. Отклонённые запросы не оплачиваются.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | До 5000 символов. Напишите, что изменить и что должно остаться прежним. Не менее 1 символов · Не более 5000 символов |
image_urls | Да | От 1 до 3 исходных изображений, до 10 МБ каждое. В промпте укажите, что даёт каждое: человека, интерьер, товар. Не менее 1 элементов · Не более 3 элементов |
aspect_ratio | Нет | auto (по умолчанию) сохраняет пропорции первого исходного изображения при размере около мегапикселя; либо выберите одну из девяти пропорций от 21:9 до 9:21. |
resolution | Нет | 1k (по умолчанию) или 2k; учитывается только при выбранном соотношении сторон, при auto результат остаётся около мегапикселя. Правка стоит одинаково на любом уровне. |
seed | Нет | Необязательное целое число от 0 до 2147483647. Используйте его с тем же промптом и исходниками, чтобы удобнее сравнивать изменения; он не гарантирует одинаковое изображение. |
Стоимость
$0.076 / изображение
Оплата за изображение по единой цене за правку — независимо от числа исходников и уровня размера. Неудачные и отклонённые запросы не оплачиваются.
Сценарии использования
Фото товаров и мест
Новые фоны, новый свет и согласованные сцены для каталожных и рекламных изображений.
Ретушь повседневных портретов
Измените обстановку, свет или стиль повседневного портрета, сохранив узнаваемость человека.
Групповые сцены из отдельных фото
Соберите людей из отдельных портретов в одном интерьере или локации.
Руководство по промптам и практические советы
Пишите, что должно остаться прежним
После описания изменения перечислите лица, волосы, одежду и позу, которые трогать нельзя.
Нумеруйте исходники
Называйте их image 1, image 2 и image 3 в порядке загрузки и давайте каждому роль.
Используйте чистые повседневные исходные фото
Правки фильтруются строго: в наших тестах Max отклонял правки портретов уже на уровне «Мягкий». Безопасный материал — товары, места и портреты в обычной одежде.
Выбирайте auto, чтобы сохранить кадр
Auto сохраняет пропорции первого исходника; выбирайте соотношение сторон и уровень, когда нужен другой кадр или 2k.
Закладывайте до двух минут
Наши правки заняли примерно от 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-max/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.

























