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

























