Введение
FLUX 3 «изображение в видео» анимирует статичное изображение с помощью видеомодели FLUX 3 от Black Forest Labs. Передайте первый кадр и, если хотите, последний; модель создаст от 5 до 20 секунд движения с синхронным звуком в 720p или 1080p.
Выберите режим по исходному материалу
| Что у вас есть | Режим |
|---|---|
| текстовый бриф | FLUX 3: текст в видео |
| статичное изображение для анимации, при желании с последним кадром | FLUX 3: изображение в видео |
| клип, который нужно продолжить | FLUX 3: продление видео |
| клип, который нужно увеличить | FLUX 3: апскейл видео |
Ключевые возможности и особенности
Изображение задаёт облик
Человек, одежда и место берутся с первого кадра, поэтому в промпте нужно описать только действие, камеру и звук.
Первый и последний кадр
С последним изображением клип движется от одного к другому. Кадры, близкие по свету и положению, соединяются плавно; далеко отстоящие кадры могут дать резкую склейку посередине.
Формат следует за изображением
Не указывайте соотношение сторон, и клип сохранит формат первого кадра.
Оплата за секунду
Цена зависит от длины и уровня (самый низкий — draft, затем standard 720p, затем standard 1080p); последний кадр и настройка звука ничего не добавляют.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | До 5000 символов. Опишите, что происходит после первого изображения: действие, движение камеры и строку Sound:. Не менее 1 символов · Не более 5000 символов |
image_url | Да | Первый кадр, загруженный или по ссылке. Внешний вид героя берётся с этого изображения. Не менее 1 символов |
last_image_url | Нет | Необязательный последний кадр. Клип переходит от первого изображения к этому; если они сильно различаются, модель может сделать резкую склейку между ними вместо плавного перехода. Не менее 1 символов |
aspect_ratio | Нет | Одно из значений: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 или 2:1. Если не указывать, формат берётся с первого изображения. |
quality | Нет | standard (по умолчанию) рендерит в выбранном разрешении; draft — быстрый недорогой предпросмотр, всегда в 720p ( |
resolution | Нет | 720p (по умолчанию) или 1080p. 1080p стоит дороже. |
duration_seconds | Нет | Длина в целых секундах, от 5 до 20; по умолчанию 5. Оплата идёт за секунду, поэтому вместе с уровнем она определяет цену. |
generate_audio | Нет | Создавать синхронный звук вместе с изображением. По умолчанию включено; при отключении получится беззвучный файл. По умолчанию: |
Стоимость
Оплата за секунду видео по уровню: самый низкий — draft, затем standard 720p, затем standard 1080p. Звук включён или выключен — цена одна, а соотношение сторон на неё не влияет. Отклонённые и неудачные запросы не оплачиваются. Добавление последнего кадра цену не меняет.
| Разрешение | Качество: Черновик | Качество: Стандарт |
|---|---|---|
| $0.06 / секунду | $0.29 / секунду |
| $0.06 / секунду | $0.17 / секунду |
Сценарии использования
Оживление портретов
Улыбка, поворот головы, ветер в волосах и подходящий звук помещения.
Движения «до и после»
Смена времени суток или позы от начального кадра к конечному.
Кадры товаров и локаций
Медленная дуга камеры вокруг объекта, фотография которого у вас уже есть.
Руководство по промптам и практические советы
Описывайте движение, а не картинку
Изображение уже показывает, кто и где; пишите то, что меняется.
Держите два кадра близкими
Похожий свет и расположение дают плавное движение; сильно различающиеся кадры обычно соединяются склейкой.
Не полагайтесь на формулировку «одним кадром»
Просьба о едином кадре его не гарантирует, поэтому проверяйте результат.
Ожидайте лёгкого смещения лица в длинных движениях
Лицо может немного измениться при резких поворотах головы или когда его закрывают руки.
Проверяйте в draft
Опробуйте движение в draft до полного рендера.
Быстрый старт 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-3/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"quality": "standard",
"resolution": "720p"
}
}'
# 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.


























