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

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.