TokenLab

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ợ

DELETE
/v1/tasks/{id}

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

idstringpathbắt buộc

Async task ID do yêu cầu create trả về hoặc nằm trong poll_url.

Phản hồi

idstring

Định danh async task chính tắc.

task_idstring

Bí danh của định danh async task.

poll_urlstring

Polling URL ưu tiên cho tác vụ. URL vẫn hợp lệ sau khi hủy.

statusstring

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ó.

cancelledboolean

true khi tác vụ được hủy trước khi thực thi.

cancellation_statusstring

Dấu hiệu hủy. Giá trị là cancelled khi hủy thành công.

errorstring

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
curl -X DELETE "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"
Response
{
  "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
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ụ 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