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

GET /requests/{requestId}/content — скачивание видео

GET /fal/api/blackforestlabs/flux-3-max/requests/{requestId}/content?t=... скачивает сгенерированный MP4-файл по подписанной ссылке из поля video.url ответа результата. Это собственный адрес доставки контента хаба.

curl "https://hub.coreinfra.ai/fal/api/blackforestlabs/flux-3-max/requests/$REQUEST_ID/content?t=$TOKEN" \
--output video.mp4

Успешный ответ (200 OK или 206 Partial Content при передаче заголовка Range) передает поток байтов видео и сохраняет присутствующие в ответе заголовки файла (Content-Type, Content-Length, Accept-Ranges, а для частичного ответа — Content-Range).

Отличия от API fal​

  • Подписанная ссылка без заголовка авторизации. Заголовок Authorization для этого запроса не нужен: доступ к файлу предоставляет параметр t в подписанной ссылке video.url. Любой, у кого есть полная ссылка, может скачать видео — храните ее как секрет.
  • Срок действия — 7 дней. Ссылка действует 7 суток с момента создания задания (POST в очередь). По истечении этого срока запрос возвращает статус-код 410 Gone. Скачайте и сохраните нужные видеофайлы до истечения 7 дней.
  • Поддержка докачки. Запрос поддерживает стандартный HTTP-заголовок Range для частичного чтения и докачки файла.
  • Без повторной оплаты. Скачивание видео не создает резерва и не списывает средства с баланса хаба.

Ошибки​

Статус-кодУсловие
404Отсутствует или недействителен параметр подписи t, либо видеофайл больше недоступен в хранилище
410Истек срок действия ссылки (прошло более 7 дней с момента создания задания)
502Ошибка на стороне провайдера при скачивании файла; повторите запрос

Формат ошибок описан в разделе fal API.