Перейти к содержанию

fal API

fal-совместимый API хаба обслуживает асинхронную очередь генерации видео для двух моделей FLUX 3 Max: blackforestlabs/flux-3-max/text-to-video и blackforestlabs/flux-3-max/image-to-video. Общее устройство очереди описано в документации fal Queue API, а настройка Python SDK fal-client — на странице «fal-совместимый API».

Базовый адрес очереди: https://hub.coreinfra.ai/fal/api.

API методы​

В таблице ниже {owner}/{app} — blackforestlabs/flux-3-max, а {path} — text-to-video или image-to-video. Пути указаны относительно https://hub.coreinfra.ai/fal/api.

МетодыПутьНазначение
POST, OPTIONS/{owner}/{app}/{path}Постановка задания в очередь
GET, OPTIONS/{owner}/{app}/requests/{requestId}/statusСтатус задания
GET, OPTIONS/{owner}/{app}/requests/{requestId}Результат генерации
PUT, OPTIONS/{owner}/{app}/requests/{requestId}/cancelОтмена задания
GET, OPTIONS/{owner}/{app}/requests/{requestId}/content?t=...Скачивание видео

API методы статуса, результата и отмены также принимают полный путь с {path}: /{owner}/{app}/{path}/requests/{requestId}[/status|/cancel]. Запросы GET, POST и PUT к /fal/run/* (синхронный хост FAL_RUN_HOST) возвращают ошибку со статус-кодом 400.

Общие правила​

Для постановки в очередь, проверки статуса, чтения результата и отмены передавайте ключ хаба в заголовке Authorization: Key sk-ci2-... (используется в fal-client по умолчанию) или Authorization: Bearer sk-ci2-.... Доступ к заданию есть только у ключа, который его создал. Для скачивания видео заголовок Authorization не требуется — доступ подтверждается параметром t в подписанной ссылке.

Все ответы очереди (кроме потока байтов MP4 при скачивании видео) возвращаются в формате JSON. Потоковый SSE-режим (status/stream, stream()) не поддерживается.

Ошибки​

Пример ошибки обращения к очереди с полем detail:

{"detail":"Endpoint 'fal-ai/fast-sdxl' is not available on this hub."}

Ошибки проверки входных параметров (422 Unprocessable Entity) содержат массив элементов валидации в detail:

{
"detail": [
{
"loc": ["body", "duration"],
"msg": "duration must be a whole number of seconds from 5 to 20.",
"type": "invalid_duration"
}
]
}

Для неизвестного или чужого requestId API методы статуса и отмены возвращают статус-код 404 с полем status: "NOT_FOUND", а чтение результата — 404 с полем detail. Недействительный ключ возвращает статус-код 401; общие ошибки авторизации, баланса и лимитов расходов описаны в общем справочнике и на странице «Лимиты и ограничения».