Введение
FLUX 3 Klein Base: правка изображений меняет или объединяет один–три исходных изображения по письменной инструкции на FLUX 3 Image Klein Base от Black Forest Labs — недистиллированном чекпоинте на 5,6 млрд параметров. Ссылайтесь на исходники как image 1, image 2 и image 3, сохраняйте форму первого изображения через auto или выберите одну из пятнадцати и уровень 1k или 2k. В наших тестах правка в 1k занимала около 20–40 секунд; фильтрации нет.
Выберите режим по исходному материалу
| Что у вас есть | Режим |
|---|---|
| текстовое описание | FLUX 3 Klein Base: генерация по тексту |
| от одного до трёх изображений для изменения или объединения | FLUX 3 Klein Base: правка |
Ключевые возможности и особенности
Одежда с предметной съёмки
Дайте человека как image 1, а одежду, сфотографированную на вешалке, как image 2 — и правка оденет одного в другую. В наших тестах женщина в зимней парке вернулась в бордовом бархатном платье-комбинации в раздевалке сауны, с сохранёнными лицом и волосами.
Тот же человек, новое место
Лицо, борода и телосложение сохранились при полной смене наряда и места: турист в красной куртке в заснеженном лесу стал тем же мужчиной в открытой льняной рубашке на кедровой полке. Короткие, конкретные инструкции лучше всего сохраняли лица.
Объединение до трёх изображений
Две отдельные фотографии двух женщин стали одной сценой на полке сауны в одинаковых платьях, и оба лица узнаваемы. При трёх исходниках называйте, что даёт каждый, чтобы ничего не потерялось.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Обязательное, до 5000 символов. Назовите, что должно остаться (лицо, волосы, телосложение), затем изменение. Не менее 1 символов · Не более 5000 символов |
image_urls | Да | Обязательное: от одной до трёх публичных ссылок на изображения, до 10 МБ каждое. Ссылка, которая не открывается или не ведёт на изображение, отменяет запрос без списания. Не менее 1 элементов · Не более 3 элементов |
aspect_ratio | Нет | auto (по умолчанию) сохраняет форму первого исходника: портрет 880 x 1184 вернулся как 880 x 1184 в 1k и 1760 x 2368 в 2k. Либо выберите одну из пятнадцати форм от 3:1 до 1:3. |
resolution | Нет | 1k (по умолчанию) или 2k, также применяется при auto. 2k стоит примерно в четыре раза дороже 1k за результат и вдвое дороже за каждый исходник. |
output_format | Нет | JPEG (по умолчанию), PNG или WebP. На цену не влияет. |
seed | Нет | Необязательное, от 0 до 2 147 483 647. Используйте его повторно, чтобы сравнивать изменения инструкции; повторные правки получались близкими, но не всегда совпадающими по пикселям. |
Стоимость
Оплата за изображение: плата за уровень размера результата и отдельная плата за каждый исходник, в 2k обе выше. Соотношение сторон и формат вывода на цену не влияют.
| Спецификация | Стоимость |
|---|---|
| $0.054 / изображение |
| $0.216 / изображение |
Сценарии использования
Лукбуки и стайлинг
Поставьте одежду с фото товара на модель с другого фото, в новом месте и свете, для лукбуков и мудбордов.
Смена локации и гардероба
Переместите человека в новую обстановку и наряд одним проходом, сохранив его узнаваемость, для персонажных листов и серий.
Руководство по промптам и практические советы
Используйте номера изображений
Пишите image 1, image 2 и image 3 в порядке загрузки и задайте каждому роль: женщина из image 1, платье из image 2. Первое изображение также задаёт форму, когда соотношение сторон auto.
Сначала защитите, затем меняйте
Начните с того, что должно остаться прежним, например лицо, волосы и телосложение, затем опишите изменение: одежду, место, позу и свет. Модель может оставить одежду на месте, поэтому прямо указывайте, что человек должен носить.
Учитывайте цену за каждый исходник
Каждый исходник добавляет к цене, а 2k удваивает эту плату. Используйте один исходник, когда одного достаточно, и делайте черновики в 1k.
Быстрый старт 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-3-klein-base/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "jpeg",
"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.


























