POST /{owner}/{app}/{path} — создание видеозадания
POST /fal/api/blackforestlabs/flux-3-max/text-to-video и POST /fal/api/blackforestlabs/flux-3-max/image-to-video ставят задание генерации видео в очередь для моделей FLUX 3 Max Text to Video и FLUX 3 Max Image to Video. Общий протокол очереди описан в документации fal Queue API, схема модели — в описании FLUX 3 Max API.
curl https://hub.coreinfra.ai/fal/api/blackforestlabs/flux-3-max/text-to-video \
-H "Authorization: Key $COREINFRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt":"Бумажный кораблик плывет по ручью","duration":5,"resolution":"720p"}'
Фрагмент ответа (200 OK):
{
"status": "IN_QUEUE",
"request_id": "019a7b2e-...",
"response_url": "https://hub.coreinfra.ai/fal/api/blackforestlabs/flux-3-max/requests/019a7b2e-...",
"status_url": "https://hub.coreinfra.ai/fal/api/blackforestlabs/flux-3-max/requests/019a7b2e-.../status",
"cancel_url": "https://hub.coreinfra.ai/fal/api/blackforestlabs/flux-3-max/requests/019a7b2e-.../cancel"
}
Отличия от API fal
Модель выбирается путем запроса после /fal/api/. Поддерживаются только blackforestlabs/flux-3-max/text-to-video и blackforestlabs/flux-3-max/image-to-video; любой другой путь возвращает ошибку со статус-кодом 404. Стандартные поля модели (prompt, aspect_ratio, reasoning_level, generate_audio, seed) работают как описано в документации FLUX 3 Max.
- В
image-to-videoполяimage_urlиend_image_urlпринимают только данные в кодировке base64 (data:image/...;base64,...), например черезfal_client.encode_file()илиfal_client.encode_image(). Ссылки на внешние ресурсы (http(s)) отклоняются со статус-кодом422. - До резервирования средств хаб проверяет параметры тарификации:
durationдолжен быть целым числом секунд от5до20(по умолчанию5), аresolution— одним из значений"720p","1080p","2K"или"4K"(по умолчанию"720p"). Значения другого типа,nullили вне допустимого списка отклоняются со статус-кодом422. - Параметры вебхуков (
fal_webhook) и заголовкиX-Fal-*игнорируются. Синхронные вызовы/fal/run/*отклоняются со статус-кодом400. - Максимальный размер тела запроса на
/fal/api— 64 МиБ (при превышении возвращается статус-код413).
Резерв и списание
При постановке в очередь резервируется стоимость запрошенной длительности duration по ставке выбранного resolution на странице «Тарифы». Окончательное списание происходит при чтении готового результата; прекращение опроса или отказ от чтения результата не отменяют запущенное задание и оплату выполненной генерации. При ошибке генерации или отмене в очереди до запуска резерв освобождается без списания (см. «Стоимость видео»).
Ошибки
| Статус-код | Условие |
|---|---|
400 | Вызов синхронного пути /fal/run/* (поддерживается только очередь /fal/api/*) |
401 | Недействителен ключ хаба |
404 | Неподдерживаемый путь модели |
413 | Тело запроса превышает допустимый размер (64 МиБ) |
422 | Некорректный JSON-объект, duration вне диапазона 5..20, неподдерживаемое resolution или ссылка на внешний ресурс вместо изображения в кодировке base64 |
Формат ошибок описан в разделе fal API; общие ошибки авторизации, баланса и лимитов расходов — в общем справочнике.
