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

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.