Введение
FLUX.1 Fill Dev LoRA Инпейнтинг перерисовывает закрытую маской часть одного изображения на FLUX.1 Fill [dev] — модели заливки от Black Forest Labs на 12 миллиардов параметров — и подгружает до трёх ваших файлов LoRA. Белое в маске перерисовывается по вашему промпту, чёрное возвращается как было. Платформа не добавляет фильтр контента ни к промпту, ни к весам, ни к изображению.
Ключевые возможности и особенности
Остальная картинка остаётся
В наших тестах область вне маски возвращалась нетронутой, а полностью чёрная маска вернула фото без изменений, так что лицо, комната или предметный кадр переживают правку.
Заливка в тон света
Модель обучена вписываться в окружение: шёлковое платье подхватило вольфрамовый свет ателье, а худи — низкое солнце студии без всяких дополнительных подсказок.
Ваши LoRA внутри маски
За запрос загружается до трёх LoRA для FLUX.1 dev. LoRA в стиле пиксель-арт превратил закрытую маской стену в фреску; LoRA без фильтров воспроизвёл то, что базовая модель смягчала.
До четырёх вариантов за запуск
Запросите от одного до четырёх изображений по одной маске и выберите лучшую заливку, оплата за изображение.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Опишите, что должно быть в белой области: предмет или одежду, её материал и свет, в котором она находится. Триггерную фразу LoRA ставьте первой. Не менее 1 символов · Не более 5000 символов |
image_url | Да | Фото, которое нужно перерисовать. Результат сохраняет его соотношение сторон; длинную сторону задаёт уровень разрешения. |
mask_url | Да | Чёрно-белое изображение того же размера, что и исходник: белое перерисовывается, чёрное сохраняется. |
resolution | Нет | 1k даёт длинную сторону 1024 пикселя и выбран по умолчанию; 1.5k даёт 1536. Стороны округляются вниз до кратных 32. |
num_outputs | Нет | Сколько вариантов по одной маске, от 1 до 4; по умолчанию 1. Каждое изображение оплачивается, поэтому четыре стоят в четыре раза больше одного. |
loras | Нет | До трёх записей {path, scale}, обученных под FLUX.1 dev; scale от 0 до 4, 1 — нейтрально. Используйте публичную прямую ссылку на файл .safetensors. По умолчанию: |
guidance_scale | Нет | Насколько строго заливка следует промпту, от 28 до 35; по умолчанию 30. На цену не влияет. |
steps | Нет | Число шагов шумоподавления, от 1 до 50; по умолчанию 28. Меньше шагов — быстрее и чуть мягче. |
seed | Нет | Сохраняет сопоставимость заливок, пока вы меняете промпт или LoRA. Он не гарантирует одинаковых пикселей при каждом запуске. |
Стоимость
$0.042 / изображение
Оплата за изображение: запуск из четырёх изображений стоит в четыре раза больше одного. Уровень разрешения и загрузка LoRA на цену не влияют.
Сценарии использования
Мода и смена гардероба
Меняйте одежду, цвет или вырез на готовом фото, пока модель, поза и декорации остаются такими, как в кадре.
Ретушь
Перерисуйте руку, уберите предмет или замените элемент фона, закрыв маской только эту область.
Искусство внутри сцены
Закройте маской стену, холст или лист бумаги и нарисуйте на них мурал или набросок с помощью стилевой LoRA.
Руководство по промптам и практические советы
Описывайте белую область
Пишите, что окажется в маске и как это освещено: "a floor-length crimson silk slip dress with thin straps, catching warm tungsten light". Остальное фото заново описывать не нужно.
Закрывайте маской с запасом
Включайте лямки, воротники, капюшоны и отражения в зеркале всего, что вы меняете. Всё, что останется за маской, останется на картинке.
Держите маску на холсте исходника
Экспортируйте маску того же размера, что и фото. Маска другого размера растягивается, и белая область смещается.
Просите несколько вариантов
Заливки меняются от seed к 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-1-fill-dev-lora/edit",
"input": {
"image_url": "https://example.com/reference.png",
"mask_url": "https://example.com/reference.png",
"num_outputs": 1,
"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.
