GET /requests/{requestId}/status — статус задания
GET /fal/api/blackforestlabs/flux-3-max/requests/{requestId}/status возвращает текущее состояние задания в очереди (IN_QUEUE, IN_PROGRESS или COMPLETED). Также принимается полный путь с именем операции (.../text-to-video/requests/{requestId}/status или .../image-to-video/requests/{requestId}/status). Поля ответа описаны в документации fal Queue Status.
curl "https://hub.coreinfra.ai/fal/api/blackforestlabs/flux-3-max/requests/$REQUEST_ID/status?logs=1" \
-H "Authorization: Key $COREINFRA_API_KEY"
Фрагмент ответа завершенного задания (200 OK; пока задание в очереди или выполняется — 202 Accepted):
{
"status": "COMPLETED",
"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",
"logs": null
}
Отличия от API fal
- Используйте ключ хаба, с помощью которого было создано задание. Если указан полный путь с
{path}, он должен совпадать с путем, на который отправлялось задание. - Поддерживается query-параметр
logsсо значениями0,1,trueилиfalse; остальные query-параметры игнорируются. Потоковый адресstatus/streamне поддерживается. - В ответе всегда присутствуют поле
logs(иqueue_position, пока задание в очереди), аstatus_url,response_urlиcancel_urlуказывают наhub.coreinfra.ai. - Опрос статуса не тарифицируется. После получения
status: "COMPLETED"без поляerrorвыполните запрос к API методу результата, чтобы получить ссылку на видео и завершить расчет по заданию (fal_client.subscribe()выполняет это автоматически). Если задание завершилось со статусомCOMPLETEDи непустым полемerror, резерв освобождается без списания.
Ошибки
| Статус-код | Условие |
|---|---|
401 | Недействителен ключ хаба |
404 | Неизвестное задание или задание создано с другим ключом хаба |
429 | Временная ошибка связи при чтении статуса (с заголовком Retry-After: 1); повторите запрос |
Формат ошибок описан в разделе fal API; общие ошибки — в справочнике API.
