GET /requests/{requestId} — результат генерации
GET /fal/api/blackforestlabs/flux-3-max/requests/{requestId} возвращает результат завершенного задания генерации видео FLUX 3 Max со ссылкой для скачивания MP4-файла. Также поддерживается полный путь с {path} (.../text-to-video/requests/{requestId} или .../image-to-video/requests/{requestId}). Описание ответа приведено в документации fal Queue Result и схеме FLUX 3 Max.
curl "https://hub.coreinfra.ai/fal/api/blackforestlabs/flux-3-max/requests/$REQUEST_ID" \
-H "Authorization: Key $COREINFRA_API_KEY"
Фрагмент успешного ответа (200 OK):
{
"video": {
"url": "https://hub.coreinfra.ai/fal/api/blackforestlabs/flux-3-max/requests/019a7b2e-.../content?t=...",
"content_type": "video/mp4",
"file_name": "output.mp4",
"file_size": 3146509,
"width": 1280,
"height": 704,
"fps": 24.0,
"num_frames": 121,
"duration": 5.04
},
"seed": 1071130842,
"timings": {
"inference": 3.8
}
}
Отличия от API fal
- Используйте ключ хаба, с помощью которого было создано задание.
- Поле
video.urlсодержит подписанную ссылку на скачивание видео через хаб (/fal/api/.../requests/{requestId}/content?t=...). Ссылка действует 7 дней с момента создания задания и не требует заголовкаAuthorization. - Сам JSON-ответ результата хранится на стороне очереди 1 час после завершения генерации (или 6 минут, если размер ответа составляет 10 КБ и более). Прочитайте результат сразу после перехода статуса в
COMPLETEDи скачайте видео (или сохранитеvideo.url). После истечения срока хранения JSON повторный вызовGET /requests/{requestId}вернет статус-код404. - Первое успешное чтение результата списывает зарезервированную стоимость задания; отказ от чтения результата не отменяет оплату успешно выполненного задания. Если чтение результата вернуло
422(ошибка валидации входных данных),499(задание отменено) или подтвержденную ошибку выполнения (500/504), резерв освобождается без списания средств. Объект ответа не содержит поляusage.
Ошибки
| Статус-код | Условие |
|---|---|
400 | Задание еще не завершено — дождитесь статуса COMPLETED через GET /status |
401 | Недействителен ключ хаба |
404 | Неизвестное задание, задание создано с другим ключом хаба либо истек срок хранения JSON-результата (1 час / 6 минут) |
422 | Ошибка валидации параметров на стороне модели (резерв освобождается) |
429 | Временная ошибка чтения результата (с заголовком Retry-After: 1); повторите запрос |
499 | Задание было отменено (резерв освобождается) |
Формат ошибок описан в разделе fal API; общие ошибки — в справочнике API.
