비동기 작업
작업 취소
공급자와 모델이 지원하는 경우 대기 중인 비동기 작업을 취소합니다
개요
DELETE /v1/tasks/{id}를 사용해 아직 실행을 시작하지 않은 비동기 작업을 취소합니다. create 응답의 작업 ID 또는 poll_url에 포함된 동일한 ID를 사용하세요.
지원 작업
취소를 지원하는 대기 중 Seedance 작업에는 seedance-1.5-pro, seedance-2.0, seedance-2.0-fast, seedance-2.5가 포함됩니다. 실행 중이거나 종료 상태인 작업은 취소할 수 없습니다. 공개 작업 기록이 보관되는 동안 상태를 조회할 수 있습니다.
경로 매개변수
create 요청에서 반환되었거나 poll_url에 포함된 비동기 작업 ID입니다.
응답
표준 비동기 작업 식별자입니다.
비동기 작업 식별자 별칭입니다.
작업의 권장 폴링 URL입니다. 취소 후에도 유효합니다.
작업 상태입니다. 성공적으로 취소된 작업은 기존 상태 값과의 호환성을 위해 failed로 반환되고 cancelled: true가 포함됩니다.
작업이 실행 전에 취소되면 true입니다.
취소 마커입니다. 취소 성공 시 값은 cancelled입니다.
취소 사유 또는 작업 실패 메시지입니다.
오류 동작
400 unsupported_task_cancel은 작업 유형, 공급자 또는 모델이 취소를 지원하지 않음을 의미합니다. 409 task_not_cancellable은 작업이 이미 처리 중이거나 종료 상태이거나 더 이상 취소할 수 없음을 의미합니다. 403은 API key가 해당 작업에 접근할 수 없음을 의미합니다.
예시
요청
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"}인증
BearerAuth API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
경로 매개변수
id / task_id로 반환되거나 poll_url에 포함된 비동기 작업 ID입니다.
응답
application/json
application/json
application/json
application/json
application/json
application/json
application/json