# PUT /requests/{requestId}/cancel — отмена задания

Отмена видеозадания в очереди /fal/api и освобождение резерва.

`PUT /fal/api/blackforestlabs/flux-3-max/requests/{requestId}/cancel` запрашивает отмену задания в очереди. Также поддерживается полный путь с `{path}` (`.../text-to-video/requests/{requestId}/cancel` или `.../image-to-video/requests/{requestId}/cancel`). Описание операции приведено в [документации fal Queue Cancel](https://docs.fal.ai/model-apis/model-endpoints/queue).

```bash
curl -X PUT "https://hub.coreinfra.ai/fal/api/blackforestlabs/flux-3-max/requests/$REQUEST_ID/cancel" \
  -H "Authorization: Key $COREINFRA_API_KEY"
```

Ответ при отмене задания, еще находившегося в очереди (`200 OK`):

```json
{"status":"OK"}
```

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

* Используйте ключ хаба, с помощью которого было создано задание.
* Если задание еще находилось в очереди и не начало выполняться, возвращается статус-код `200` (`status: "OK"`), а зарезервированные средства сразу освобождаются без списания.
* Если генерация уже запущена, возвращается статус-код `202` (`status: "CANCELLATION_REQUESTED"`). Если задание остановится как отмененное (чтение результата вернет статус-код `499`), резерв освободится без списания.
* Если задание уже успело завершиться, возвращается статус-код `400` (`status: "ALREADY_COMPLETED"`) — отмена уже выполненного задания не отменяет списание.

## Ошибки

| Статус-код | Условие                                                      |
| ---------- | ------------------------------------------------------------ |
| `400`      | Задание уже завершено (`status: "ALREADY_COMPLETED"`)        |
| `401`      | Недействителен ключ хаба                                     |
| `404`      | Неизвестное задание или задание создано с другим ключом хаба |
| `502`      | Ошибка на стороне провайдера при обращении к очереди         |

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