# GET /requests/{requestId}/status — статус задания

Проверка статуса видеозадания в очереди /fal/api и коды ответа.

`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](https://docs.fal.ai/model-apis/model-endpoints/queue).

```bash
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`):

```json
{
  "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 методу результата](https://coreinfra.ru/docs/reference/fal/result.md), чтобы получить ссылку на видео и завершить расчет по заданию (`fal_client.subscribe()` выполняет это автоматически). Если задание завершилось со статусом `COMPLETED` и непустым полем `error`, резерв освобождается без списания.

## Ошибки

| Статус-код | Условие                                                                                     |
| ---------- | ------------------------------------------------------------------------------------------- |
| `401`      | Недействителен ключ хаба                                                                    |
| `404`      | Неизвестное задание или задание создано с другим ключом хаба                                |
| `429`      | Временная ошибка связи при чтении статуса (с заголовком `Retry-After: 1`); повторите запрос |

Формат ошибок описан в [разделе fal API](https://coreinfra.ru/docs/reference/fal.md#errors); общие ошибки — в [справочнике API](https://coreinfra.ru/docs/reference.md#errors).
