TokenLab

Video & tư liệu

Hủy tác vụ (Tương thích Volc)

Hủy một tác vụ tương thích Seedance đang chờ xử lý hoặc có thể hủy.

DELETE
/api/v3/contents/generations/tasks/{id}

Tổng quan

Việc hủy chỉ thành công khi tác vụ vẫn đang ở trạng thái queued. Một yêu cầu DELETE thành công sẽ trả về HTTP 200 với nội dung phản hồi trống. Hãy truy vấn tác vụ sau đó để xác nhận trạng thái cuối cùng.

Xem thêm Mô hình Video Seedance 2.0 và Tạo Video.

Ngữ nghĩa hủy tác vụ

  • Yêu cầu chỉ có thể thành công khi tác vụ đang ở trạng thái queued.
  • Nếu tác vụ đã ở trạng thái running, hoặc đã hoàn tất, thất bại, hoặc hết hạn, endpoint sẽ trả về 409 với mã task_not_cancellable; hãy truy vấn tác vụ để xác nhận trạng thái hiện tại của nó.
  • Một tác vụ đã hủy sẽ có trạng thái cancelled và không trả về kết quả video.
  • Một ID tác vụ không tồn tại sẽ trả về 404.

Ví dụ

curl -X DELETE https://api.tokenlab.sh/api/v3/contents/generations/tasks/cgt-20260102030405-a1b2c \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"
curl -X DELETE "https://example.com/api/v3/contents/generations/tasks/string"
Trống

Xác thực

BearerAuth
AuthorizationBearer <token>

Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.

Vị trí: header

Tham số đường dẫn

id*string

ID tác vụ tương thích được trả về bởi endpoint tạo. Các ID bắt đầu bằng cgt-.

Phản hồi

application/json

application/json

application/json

application/json

application/json

application/json