Tác vụ bất đồng bộ
Hủy tác vụ
Hủy tác vụ bất đồng bộ đang chờ khi nhà cung cấp và model hỗ trợ
Tổng quan
Dùng DELETE /v1/tasks/{id} để hủy một tác vụ bất đồng bộ chưa bắt đầu chạy. Dùng cùng task ID từ phản hồi create hoặc ID trong poll_url.
Tác vụ được hỗ trợ
Có thể hủy tác vụ Seedance đang chờ dùng seedance-1.5-pro, seedance-2.0, seedance-2.0-fast hoặc seedance-2.5 nếu tác vụ hỗ trợ hủy. Không thể hủy tác vụ đã chạy hoặc ở trạng thái cuối. Có thể tra cứu trạng thái khi bản ghi tác vụ công khai còn được lưu.
Tham số đường dẫn
Async task ID do yêu cầu create trả về hoặc nằm trong poll_url.
Phản hồi
Định danh async task chính tắc.
Bí danh của định danh async task.
Polling URL ưu tiên cho tác vụ. URL vẫn hợp lệ sau khi hủy.
Trạng thái tác vụ. Tác vụ hủy thành công được trả về là failed với cancelled: true để tương thích với các giá trị trạng thái hiện có.
true khi tác vụ được hủy trước khi thực thi.
Dấu hiệu hủy. Giá trị là cancelled khi hủy thành công.
Lý do hủy hoặc thông báo lỗi của tác vụ.
Hành vi lỗi
400 unsupported_task_cancel nghĩa là loại tác vụ, nhà cung cấp hoặc model không hỗ trợ hủy. 409 task_not_cancellable nghĩa là tác vụ đã xử lý, đã ở trạng thái cuối hoặc không còn hủy được. 403 nghĩa là API key không có quyền truy cập tác vụ.
Ví dụ
Yêu cầu
curl -X DELETE "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "failed",
"cancelled": true,
"cancellation_status": "cancelled",
"error": "Task cancelled before execution"
}{ "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "status": "failed", "cancelled": true, "cancellation_status": "cancelled", "error": "Task cancelled before execution"}Xác thực
BearerAuth 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 tác vụ async được trả về bởi id / task_id, hoặc được nhúng trong poll_url
Phản hồi
application/json
application/json
application/json
application/json
application/json
application/json
application/json