Введение
FLUX.1 Dev ControlNet LoRA Текст в изображение создаёт изображения на FLUX.1 [dev] — модели Black Forest Labs на 12 миллиардов параметров — под управлением ControlNet Union Pro 2.0 от Shakker Labs и подгружает до трёх ваших файлов LoRA. Одно управляющее изображение фиксирует позу, глубину или контуры; кто и что окажется на картинке, решает промпт. Платформа не добавляет фильтр контента ни к промпту, ни к весам, ни к изображению.
Ключевые возможности и особенности
Одна сеть, пять типов карт
Линии canny, мягкие контуры, глубина, скелеты поз и фото в оттенках серого работают через один и тот же эндпоинт. Переключателя режима нет: модель читает отправленную вами карту.
Сила и тайминг управления
Сила управления (от 0 до 1) задаёт, насколько строго соблюдается карта, а начало и конец окна управления — на каком участке шумоподавления она действует.
Ваши LoRA
За один запрос загружается до трёх LoRA для FLUX.1 dev. LoRA без фильтра контента с скелетом позы в наших тестах выдала уровень «Сильный».
До четырёх изображений за запуск
Запросите от одного до четырёх изображений по одной карте, оплата за изображение.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Опишите нужную картинку: героев, одежду, обстановку и свет. Управляющее изображение задаёт только композицию. Не менее 1 символов · Не более 5000 символов |
control_image_url | Да | Управляющая карта: скелет позы, карта глубины, линии canny или soft-edge либо фото в оттенках серого или обычное фото. Сама она не извлекается. |
control_strength | Нет | Насколько строго результат следует управляющей карте, от 0 до 1; по умолчанию 0,7. Карты позы хорошо работают около 0,9; при 0,3 наша поза была проигнорирована. |
control_guidance_start | Нет | Момент шумоподавления, от 0 до 1, с которого начинает действовать карта; по умолчанию 0. Не должен быть позже конца. |
control_guidance_end | Нет | Момент шумоподавления, от 0 до 1, на котором карта перестаёт действовать; по умолчанию 0,8. Более ранний конец, около 0,65 для карт позы, оставляет деталям больше свободы. |
resolution | Нет | 1k даёт длинную сторону 1024 пикселя и выбран по умолчанию; 1.5k даёт 1536, в соотношении сторон управляющего изображения. Стоят одинаково. |
num_outputs | Нет | Сколько изображений создать по одной карте, от 1 до 4; по умолчанию 1. Каждое изображение оплачивается, поэтому четыре стоят в четыре раза больше одного. |
loras | Нет | До трёх записей {path, scale}, обученных под FLUX.1 dev; scale от 0 до 4, 1 — нейтрально. LoRA для другого семейства моделей роняет запрос. По умолчанию: |
guidance_scale | Нет | Насколько точно изображение следует промпту, от 0 до 20; по умолчанию 3,5. На цену не влияет. |
steps | Нет | Число шагов шумоподавления, от 1 до 50; по умолчанию 28. Меньше шагов — быстрее и чуть мягче. |
output_format | Нет | По умолчанию JPEG, при необходимости PNG или WebP. Формат на цену не влияет. |
seed | Нет | Сохраняет сопоставимость результатов, пока вы меняете силу или LoRA. Он не гарантирует одинаковых пикселей при каждом запуске. |
Стоимость
$0.036 / изображение
Оплата за изображение: запуск из четырёх изображений стоит в четыре раза больше одного. Уровень разрешения, формат вывода и загрузка LoRA на цену не влияют.
Сценарии использования
Повторение позы
Один раз извлеките или нарисуйте скелет и рисуйте ту же позу с любым человеком и нарядом.
Пересъёмка фотографии
Сохраните композицию фото через его карту canny, soft-edge или в оттенках серого и смените героев, гардероб и свет.
Серии с одной композицией
Используйте одну управляющую карту, чтобы у всех изображений набора было одинаковое кадрирование.
Руководство по промптам и практические советы
Выбирайте карту по тому, что должно меняться
Скелет позы оставляет одежду на усмотрение промпта. Карты глубины и линий сохраняют складки одежды на фото, с которого их сняли, и в наших тестах модель следовала этим складкам, а не промпту.
Начните с рекомендуемых настроек
Shakker Labs советует силу 0,7 с окном до 0,8 для canny и soft edge, 0,8 для глубины и около 0,9 с окном до 0,65 для карт позы.
Следите за соотношением сторон
Результат принимает форму управляющего изображения. Обрежьте карту до нужного кадра перед отправкой.
Проверьте базовую модель LoRA
Работают только LoRA для FLUX.1 dev. LoRA для другого семейства моделей роняет запрос, а не игнорируется.
Быстрый старт 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-controlnet-lora/text-to-image",
"input": {
"control_image_url": "https://example.com/reference.png",
"num_outputs": 1,
"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.
