PUT /requests/{requestId}/cancel — отмена задания
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.
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):
{"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; общие ошибки — в справочнике API.
