О модели FLUX.1 Dev ControlNet LoRA
FLUX.1 Dev ControlNet LoRA генерирует изображения на FLUX.1 [dev] от Black Forest Labs под управлением ControlNet Union Pro 2.0 от Shakker Labs и подгружает до трёх файлов LoRA, обученных под FLUX.1 dev. Одно управляющее изображение (скелет позы, карта глубины, линии canny или soft-edge либо фото в оттенках серого) фиксирует композицию, всё остальное решает промпт, и ничего не фильтруется.
Вызывайте его по имени модели black-forest-labs/flux-1-dev-controlnet-lora/text-to-image через POST /jobs/createTask, от 6 кредитов за изображение (0,06 $). Новые аккаунты получают 30 бесплатных кредитов, чтобы вы могли сначала попробовать в Playground.
Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
control_guidance_end | Нет | Fraction of the denoising steps at which the control image stops applying, from 0 to 1; not before the start. ≥ 0 · ≤ 1 · По умолчанию: 0.8 |
control_guidance_start | Нет | Fraction of the denoising steps at which the control image starts to apply, from 0 to 1. ≥ 0 · ≤ 1 · По умолчанию: 0 |
control_image_url | Да | Control image: a pose skeleton, depth map, canny or soft-edge line map, or a grayscale or plain photo. The result keeps its aspect ratio. |
control_strength | Нет | How strongly the result follows the control image, from 0 to 1. ≥ 0 · ≤ 1 · По умолчанию: 0.7 |
guidance_scale | Нет | Насколько строго модель следует промпту. ≥ 0 · ≤ 20 · По умолчанию: 3.5 |
loras | Нет | Загрузите свои LoRA, чтобы закрепить стиль или персонажа. По умолчанию: [] |
num_outputs | Нет | Сколько результатов сделать за раз. ≥ 1 · ≤ 4 · По умолчанию: 1 |
output_format | Нет | Формат файла результата. jpeg · png · webp · По умолчанию: jpeg |
prompt | Да | Describe the picture you want: subject, clothing, setting and light. The control image only sets the layout. |
resolution | Нет | Размер результата. Больше — чётче и дороже. 1k · 1.5k · По умолчанию: 1k |
seed | Нет | Одно и то же число даёт повторяемый результат. ≥ 0 · ≤ 2147483647 |
steps | Нет | Больше шагов — больше деталей, но дольше. ≥ 1 · ≤ 50 · По умолчанию: 28 |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за изображение | ≈ USD |
|---|---|---|
| Стандарт | 5,4 | 0,054 $ |
Каждая задача округляется вверх до целых кредитов, поэтому один запуск на самом дешёвом уровне стоит 6 кредитов за изображение (0,06 $).
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API FLUX.1 Dev ControlNet LoRA в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model black-forest-labs/flux-1-dev-controlnet-lora/text-to-image и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "black-forest-labs/flux-1-dev-controlnet-lora/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"control_image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"resolution": "1k",
"num_outputs": 1,
"output_format": "jpeg"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.
Вопросы об API FLUX.1 Dev ControlNet LoRA
Сколько стоит API FLUX.1 Dev ControlNet LoRA?
FLUX.1 Dev ControlNet LoRA стоит 6 кредитов (0,06 $) за изображение. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у FLUX.1 Dev ControlNet LoRA в API?
Укажите black-forest-labs/flux-1-dev-controlnet-lora/text-to-image — Создать картинку в поле model запроса POST /jobs/createTask.
Что такое управляющее изображение?
Карта нужной вам структуры: цветной скелет позы, карта глубины в оттенках серого, белые линии canny или soft-edge на чёрном либо фото в оттенках серого. Модель повторяет её композицию и позу, а всё остальное берёт из промпта.
Определяет ли модель позу или глубину сама?
Нет. Отправляйте саму карту. Обычное фото тоже принимается, но оно ограничивает картинку так же, как карта в оттенках серого, поэтому контуры и формы одежды переносятся.
Какие LoRA здесь работают?
LoRA, обученные под FLUX.1 dev, в виде прямой ссылки на скачивание файла .safetensors. В наших тестах LoRA для SDXL приводила к ошибке запроса, поэтому проверьте базовую модель на странице LoRA, прежде чем её подключать.
Можно ли использовать изображения в коммерческих целях?
Лицензия FLUX.1 [dev] от Black Forest Labs разрешает использовать созданные изображения в личных, научных и коммерческих целях. Лицензию каждой подключаемой LoRA определяет её автор, поэтому смотрите карточку модели.
Какие ограничения у API FLUX.1 Dev ControlNet LoRA?
Разрешения: 1K · 1.5K; Результатов за вызов: 1–4; Длина промпта (символов): 5,000; Максимальный размер загрузки: 10 MB. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать FLUX.1 Dev ControlNet LoRA без кода?
Да. Playground запускает FLUX.1 Dev ControlNet LoRA на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.
Все модели FLUX
FLUX.1 Dev LoRA не имеет контрольного изображения и подходит для свободной композиции.
- FLUX.2 Max APIФлагманский FLUX: фотореалистичный свет и точные фирменные цветаОт 11 кредитов за изображение
- FLUX 3 APIВидео с синхронным звуком и быстрым черновым режимомОт 45 кредитов за клип длиной 5 с
- FLUX.2 Klein 9B LoRA APIБыстрый FLUX.2 Klein 9B, до трёх твоих LoRAОт 3 кредитов за изображение
- FLUX.2 Klein Base 9B LoRA APIНедистиллированный Klein 9B для разнообразных образов с твоими LoRAОт 4 кредитов за изображение
- FLUX.2 Klein 4B LoRA APIМаленький быстрый FLUX.2 Klein 4B с твоими LoRAОт 3 кредитов за изображение
- FLUX.2 Klein Base 4B LoRA APIНедистиллированный Klein 4B, загружает твои LoRAОт 3 кредитов за изображение
- FLUX.2 Klein 9B APIБыстрые правки FLUX без искажения лиц и позОт 2 кредитов за изображение
- FLUX.2 Klein 4B APIСамый маленький и быстрый FLUX для черновиковОт 2 кредитов за изображение
- FLUX.2 Dev LoRA APIКартинки и правки FLUX.2 Dev с твоими LoRAОт 4 кредитов за изображение
- FLUX.2 Pro APIФотореализм, читаемый текст и цвета по HEX-кодуОт 5 кредитов за изображение
- FLUX.2 Flex APIПишет заголовки и подписи ровно так, как заданоОт 9 кредитов за изображение
- FLUX.2 Dev APIFLUX с открытыми весами, собирает нескольких людей в одной сценеОт 2 кредитов за изображение
- FLUX.1 Krea Dev LoRA APIФотографичный FLUX.1 Krea с твоими LoRAОт 4 кредитов за изображение
- FLUX.1 Dev ControlNet LoRA APIУправление позой, глубиной или контурами на FLUX.1, с твоими LoRAОт 6 кредитов за изображение
- FLUX.1 Fill Dev LoRA APIПерерисовка по маске на FLUX.1 Fill с твоими LoRAОт 7 кредитов за изображение
- FLUX.1 Dev LoRA APIКлассический FLUX.1 Dev, до трёх твоих LoRAОт 3 кредитов за изображение
- FLUX.1 Schnell LoRA APIБыстрый FLUX.1 Schnell, загружает твои LoRAОт 1 кредита за изображение

