Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
prompt | Да | Describe the subject, action, camera, light and sound for the shot. |
quality | Нет | Больше времени и денег ради мелких деталей. standard · draft · По умолчанию: standard |
resolution | Нет | Размер результата. Больше — чётче и дороже. 720p · 1080p · По умолчанию: 720p |
aspect_ratio | Нет | Форма кадра: широкая, квадратная или вертикальная. 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 2:1 · По умолчанию: 16:9 |
generate_audio | Нет | Добавляет звук под картинку: голоса, атмосферу и эффекты. По умолчанию: true |
duration_seconds | Нет | Длина ролика. Оплата посекундная. 5–20 · По умолчанию: 5 |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за секунду | ≈ USD |
|---|---|---|
| quality draft · resolution 1080p | 9 | 0,09 $ |
| quality draft · resolution 720p | 9 | 0,09 $ |
| quality standard · resolution 720p | 25,5 | 0,26 $ |
| quality standard · resolution 1080p | 43,5 | 0,44 $ |
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API FLUX 3 в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model black-forest-labs/flux-3/text-to-video и объектом 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-3/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"aspect_ratio": "16:9",
"quality": "standard",
"resolution": "720p",
"duration_seconds": 5
}
}'
# 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 3
Сколько стоит API FLUX 3?
FLUX 3 стоит от 45 кредитов (0,45 $) за клип длиной 5 с — на самой дешёвой задаче «Создать видео». Цены по вариантам: draft · 1080p 9 кредитов за секунду, draft · 720p 9 кредитов за секунду, standard · 720p 25,5 кредита за секунду, standard · 1080p 43,5 кредита за секунду. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у FLUX 3 в API?
Укажите black-forest-labs/flux-3/text-to-video — Создать видео; black-forest-labs/flux-3/image-to-video — Видео из картинки; black-forest-labs/flux-3/video-extend — Продлить видео; black-forest-labs/flux-3/upscale — Улучшить видео в поле model запроса POST /jobs/createTask.
Возвращает ли продление видео весь клип?
Нет. В результате только вновь созданный фрагмент, без вашего исходного клипа, поэтому соедините их в редакторе. Новый фрагмент начинается с последнего кадра исходного клипа; в нашем тесте он открывался коротким наплывом, а затем переходил к следующему действию.
Можно ли получить один длинный 20-секундный кадр?
Можно запросить до 20 секунд, но модель всё равно может сделать склейку или наплыв внутри клипа, особенно при сильной смене света или действия. Для контроля делайте клипы покороче и соединяйте их через продление.
Можно ли задать последний кадр?
Да, в режиме «изображение в видео». Клип переходит от первого изображения к последнему. Если два кадра сильно различаются по свету или месту, модель может сделать резкую склейку посередине вместо плавного перехода, поэтому для плавного движения подбирайте близкие кадры.
Какие ограничения у API FLUX 3?
Длина клипа: 5–20 s; Разрешения: 720p · 1080p; Соотношения сторон: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 2:1; Длина промпта (символов): 5,000. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать FLUX 3 без кода?
Да. Playground запускает FLUX 3 на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.
Все модели FLUX
LTX 2.5 доходит до родного 4K и тоже идёт 20 секунд. FLUX 3 добавляет дешёвый черновой уровень, а также extend и upscale в одном месте.
- 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 кредита за изображение

