от Black Forest Labs

Управление позой, глубиной или контурами на FLUX.1, с твоими LoRA

black-forest-labs/flux-1-dev-controlnet-lora/text-to-imageОт 6 кредитовза изображение · 0,06 $
  • До 1.5K
  • До 4 за раз
  • Свои LoRA
  • Создать картинку
Atelier night grayscaleСмотреть примеры

О модели 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,40,054 $

Каждая задача округляется вверх до целых кредитов, поэтому один запуск на самом дешёвом уровне стоит 6 кредитов за изображение (0,06 $).

Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.

Быстрый старт API

Вызов API FLUX.1 Dev ControlNet LoRA в три шага

  1. Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
  2. Отправьте запрос. Отправьте POST /jobs/createTask с model black-forest-labs/flux-1-dev-controlnet-lora/text-to-image и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
  3. Получите результат. Опрашивайте 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.1 Dev ControlNet LoRA