popnow
ВойтиСоздавать

black-forest-labs/flux-2-dev/text-to-imageОт 2 кредитов за изображение· Создать картинку

FLUX.2 [dev] — модель с открытыми весами и 32 миллиардами параметров из семейства FLUX.2 от Black Forest Labs. Она пишет читаемый текст прямо на изображении, следует hex-кодам цвета и правит картинки по одному–трём референсам. «Текст в изображение» и правка работают в размере около мегапикселя или до 2048 пикселей по длинной стороне, в девяти соотношениях сторон.

Вызывайте его по имени модели black-forest-labs/flux-2-dev/text-to-image через POST /jobs/createTask, от 2 кредита за изображение (0,02 $). Новые аккаунты получают 30 бесплатных кредитов, чтобы вы могли сначала попробовать в Playground.

  • Создать картинку
  • Редактировать картинку
  • До 2K
  • До 3 референсов
  • Соотношений сторон: 9
от Black Forest LabsПолучить API-ключFLUX.2 Dev: примеры и промпты →

Пока это руководство есть только на английском. →

Параметры запроса

ПараметрОбязательныйОписание
seedНетОдно и то же число даёт повторяемый результат. ≥ 0 · ≤ 2147483647
promptДаDescribe the subject, setting, light and style in plain sentences.
resolutionНетРазмер результата. Больше — чётче и дороже. 1k · 2k · По умолчанию: 1k
aspect_ratioНетФорма кадра: широкая, квадратная или вертикальная. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 · По умолчанию: 1:1

Цены

Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.

ВариантКредиты за изображение≈ USD
Стандарт1,740,017 $

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

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

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

Вызов API FLUX.2 Dev в три шага

  1. Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
  2. Отправьте запрос. Отправьте POST /jobs/createTask с model black-forest-labs/flux-2-dev/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-2-dev/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "aspect_ratio": "1:1",
    "resolution": "1k"
  }
}'

# 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.2 Dev

Сколько стоит API FLUX.2 Dev?

FLUX.2 Dev стоит от 2 кредита (0,02 $) за изображение — на самой дешёвой задаче «Создать картинку». Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.

Какое имя модели у FLUX.2 Dev в API?

Укажите black-forest-labs/flux-2-dev/text-to-image — Создать картинку; black-forest-labs/flux-2-dev/edit — Редактировать картинку в поле model запроса POST /jobs/createTask.

Умеет ли она писать текст на изображении?

Да, короткий текст получается хорошо: в наших тестах вывески в кавычках выходили с той орфографией, что мы задали. Берите точные слова в кавычки и указывайте, где они стоят. В длинных абзацах всё ещё бывают ошибки.

Работают ли hex-цвета?

Да, как сильная подсказка. Код вроде #FF4F8B рядом с неоновой вывеской окрасил комнату в пурпурный. Точного совпадения цвета ждать не стоит.

Сколько референсов можно использовать?

От одного до трёх в режиме правки — в том порядке, в каком их называет промпт. При объединении людей пишите «женщина с image 1» и «мужчина с image 2».

Какие ограничения у API FLUX.2 Dev?

Разрешения: 1K · 2K; Соотношения сторон: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +3; Длина промпта (символов): 5,000. Запросы за пределами этих ограничений отклоняются до любого списания.

Можно попробовать FLUX.2 Dev без кода?

Да. Playground запускает FLUX.2 Dev на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.

Все модели FLUX

FLUX.2 Pro стабильнее на тексте и лицах; Dev — открытая модель семейства.

Ещё о FLUX.2 Dev