Tác vụ bất đồng bộ
Hủy tác vụ
Hủy một tác vụ bất đồng bộ đang chờ xử lý khi mô hình hỗ trợ tính năng hủy
Tổng quan
Sử dụng DELETE /v1/tasks/{id} để hủy một tác vụ bất đồng bộ chưa bắt đầu chạy. Sử dụng cùng ID tác vụ từ phản hồi tạo tác vụ hoặc poll_url được trả về.
Các tác vụ được hỗ trợ
Tính năng hủy khả dụng cho các tác vụ Seedance đang chờ xử lý sử dụng seedance-2.0, seedance-2.5-fast hoặc seedance-2.5 khi tác vụ đó hỗ trợ hủy. Một tác vụ đã đang chạy hoặc ở trạng thái kết thúc không thể bị hủy. Tác vụ bị hủy sẽ không bị tính phí. Trạng thái vẫn có thể truy vấn được trong khi bản ghi tác vụ công khai vẫn được lưu giữ.
Để hủy một tác vụ được tạo thông qua endpoint Seedance tương thích với Volc, xem Hủy tác vụ (Tương thích Volc).
Tham số đường dẫn
ID tác vụ bất đồng bộ được trả về bởi yêu cầu tạo hoặc được nhúng trong poll_url.
Phản hồi
Định danh tác vụ bất đồng bộ chính thức.
Bí danh định danh tác vụ bất đồng bộ.
URL trạng thái cho tác vụ. URL này vẫn hợp lệ sau khi hủy. Thực hiện poll GET /v1/tasks/{id} với id.
Trạng thái tác vụ. Một 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ụ đã bị hủy trước khi thực thi.
Đánh dấu hủy. Giá trị là cancelled khi việc hủy thành công.
Lý do hủy hoặc thông báo lỗi tác vụ.
Hành vi lỗi
| HTTP | Mã | Ý nghĩa |
|---|---|---|
400 | missing_task_id, invalid_task_id | ID tác vụ bị thiếu hoặc không phải là ID tác vụ hợp lệ |
400 | unsupported_task_cancel | Loại tác vụ hoặc mô hình không hỗ trợ hủy |
403 | task_not_owned | Tác vụ không thuộc về workspace của API key này |
404 | async_task_not_found | Tác vụ đã hết hạn hoặc không khả dụng |
409 | task_not_cancellable | Tác vụ đang xử lý, đã hoàn thành hoặc không còn khả năng hủy. current_status cung cấp trạng thái hiện tại của nó |
503 | async_task_owner_unavailable | Không thể đọc tác vụ vào lúc này. Vui lòng thử lại |
Yêu cầu
curl -X DELETE "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"Phản hồi
{
"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