Введение
Отправьте одно исходное изображение и опишите результат. Сила решает, насколько результат уйдёт от исходника; с чёрно-белой маской перерисовывается только белая область, остальное остаётся как было. Можно подключить до трёх файлов LoRA, обученных под FLUX.1 [dev], цена за изображение фиксированная, ничего не фильтруется.
| Характеристика | Значение |
|---|---|
| Ввод | Изображение |
| Вывод | Изображение |
| Эндпоинты | Текст в изображение и редактирование изображений (сила, необязательная маска для инпейнтинга), оба с поддержкой LoRA |
| Базовая модель | FLUX.1 [dev] — трансформер rectified flow от Black Forest Labs на 12 миллиардов параметров |
| Вход LoRA | До 3 записей вида {path, scale}; path — прямой HTTPS-URL файла .safetensors |
| Сила LoRA | От 0 до 4 на запись (по умолчанию 1) |
| Guidance | От 0 до 20 (по умолчанию 3,5) |
| Размер результата | Около одного мегапикселя: 1024 x 1024 при 1:1, 1344 x 768 при 16:9, 1536 x 640 при 21:9 |
| Соотношения сторон | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21 |
| Форматы вывода | JPEG (по умолчанию), PNG, WebP |
Ключевые возможности и особенности
Фотографии, а не рендеры
LoRA Super Realism и ночная кабинка у дождливого окна: двое мужчин склонились друг к другу под тёплой подвесной лампой. Кожа, ткань и свет из окна читаются как на фотографии.
Журнальный облик одним триггером
«MJ v6» и LoRA в стиле Midjourney придают FLUX глянцевую журнальную подачу: красное атласное платье с открытой спиной на мраморной лестнице, боковой свет.
Смените медиум целиком
Мультяшная LoRA с удлинёнными конечностями на силе 1,2 превращает ту же модель в иллюстратора пин-апа: красный зонт, мокрая брусчатка и утрированные пропорции.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Опишите всё изображение, которое хотите получить. С маской опишите, что должно появиться в белой области. Не менее 1 символов · Не более 5000 символов |
image_url | Да | Изображение для правки. Результат сохраняет его форму примерно в 0,7 мегапикселя: в наших тестах исходник 1024 x 1536 вернулся как 672 x 1008. |
mask_url | Нет | Необязательно. Чёрно-белое изображение того же размера, что и исходник: белые области перерисовываются по промпту, чёрные остаются как есть. |
strength | Нет | Насколько уйти от исходника, от 0 до 1 (по умолчанию 0,8). С маской ставьте 0,9–1, чтобы белая область действительно изменилась. |
loras | Нет | До трёх записей {path, scale}, обученных под FLUX.1 [dev]; scale от 0 до 4, 1 — нейтрально. Используйте публичную прямую ссылку на файл .safetensors. По умолчанию: |
guidance_scale | Нет | Насколько точно результат следует промпту, от 0 до 20 (по умолчанию 3,5). Реалистичные LoRA часто выглядят естественнее чуть ниже. |
steps | Нет | Число шагов шумоподавления, от 1 до 50 (по умолчанию 28). Больше шагов — дольше генерация. |
output_format | Нет | По умолчанию JPEG, при необходимости PNG или WebP. На цену не влияет. |
seed | Нет | Сохраняет сравнимость результатов, пока вы подбираете силу или маску; одинаковый seed не гарантирует одинаковое изображение. |
Стоимость
$0.018 / изображение
Оплата за изображение по одной фиксированной цене. Маска, сила, число шагов и LoRA отдельно не тарифицируются.
Сценарии использования
LoRA, которую вы уже нашли
Если нужный облик лежит на Hugging Face или в другом хабе сообщества в виде LoRA для FLUX, здесь он запускается обычным API-вызовом: вставьте ссылку на файл, задайте scale, напишите промпт.
Модные и журнальные кадры
Реалистичные LoRA и LoRA в журнальном стиле дают вечерние платья с открытой спиной на мраморной лестнице и ночные посиделки в кабинке у дождливого окна с правдоподобным светом и кожей.
Стилизованные кампании
LoRA в духе мультфильмов, пин-апа и иллюстрации превращают один шаблон промпта в цельную серию в девяти соотношениях сторон.
Кадры без цензуры
LoRA без фильтров загружаются без проверки, а результат не фильтруется — для платформ, чьи пользователи ждут именно такой свободы.
Руководство по промптам и практические советы
Найдите триггер LoRA
Большинство LoRA для FLUX указывают триггерную фразу в карточке модели, например «Super Realism» или «MJ v6». Поставьте её в начало промпта, а затем опишите картинку.
Подстройте guidance под реалистичные LoRA
По умолчанию guidance равен 3,5. Реалистичные LoRA часто выглядят естественнее в пределах от 2 до 3,5; очень высокие значения тянут к глянцевой картинке с избыточной резкостью.
Поднимайте scale для сильных стилей
Некоторым стилевым LoRA нужен scale выше 1, чтобы взять верх. Наш мультяшный пример работал на 1,2; начните с 1 и двигайтесь шагами по 0,2.
Проверьте, что файл публичный
Используйте прямую ссылку, по которой скачивается файл .safetensors. Закрытые репозитории отвечают HTTP 401, и запрос падает раньше, чем появится хоть одно изображение.
Введение
FLUX.1 Dev LoRA Редактирование изображения меняет одно исходное изображение на FLUX.1 [dev] от Black Forest Labs по вашему промпту и максимум трём своим файлам LoRA. Без маски меняется стиль всего кадра, а сила от 0 до 1 решает, насколько результат уйдёт от исходника. С чёрно-белой маской перерисовывается только белая область, остальное сохраняется. Результат приходит в JPEG, PNG или WebP по фиксированной цене, ничего не фильтруется.
Выберите режим по исходному материалу
| Что у вас есть | Режим |
|---|---|
| изображение, которое нужно изменить целиком или частично | FLUX.1 Dev LoRA Редактирование изображения |
| только текстовое описание | FLUX.1 Dev LoRA Текст в изображение |
Ключевые возможности
Инпейнтинг по маске
Закрасьте белым то, что нужно изменить, а всё остальное — чёрным. В наших тестах маска на верхней части тела студийного портрета меняла только эту зону, а лицо, волосы и брюки оставались прежними.
Понятная сила
Значение по умолчанию 0,8 сохраняет позу и композицию; 0,95 позволяет перерисовать почти всё, включая лицо. С маской значения 0,9–1 гарантируют, что белая область действительно изменится.
Без цензуры, со своими весами
Исходник, промпт, веса и результат никогда не фильтруются. При силе 0,95 студийный портрет был отредактирован так, как требовал наш самый жёсткий тест, с LoRA без фильтров и без них.
Сценарии
Изменить часть фотографии
Замените наряд, фон или предмет, оставив остальную часть кадра нетронутой, для вариантов товара, тестов образов или ретуши портретов.
Сменить стиль с LoRA сообщества
Пропустите фото через одну из более чем тысячи LoRA для FLUX, чтобы придать ему вид плёнки, журнальный глянец или иллюстрацию, не трогая композицию.
Промпты и советы
Описывайте результат, а не команду
Пишите, что должно быть на готовом изображении. С маской описывайте только то, что должно быть в белой зоне, например «чёрный бархатный топ, мягкий студийный свет».
Смягчайте жёсткие края маски
Жёсткий прямоугольник оставляет видимый шов там, где он встречается с сохранёнными пикселями. Размойте край маски или ведите её по контуру заменяемого объекта.
Начните с 0,8 и меняйте шагом 0,05
Если исходник просвечивает, увеличьте силу; если лицо уплывает, уменьшите. Во время сравнения держите 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-dev-lora/edit",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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.
