메인 콘텐츠로 건너뛰기

​
개요

DELETE /v1/tasks/{id}를 사용해 아직 실행을 시작하지 않은 비동기 작업을 취소합니다. create 응답의 작업 ID 또는 poll_url에 포함된 동일한 ID를 사용하세요.

​
지원 작업

취소는 해당 작업에 선택된 제공자가 지원하는 경우에만 대기 중인 Seedance 동영상 작업에서 사용할 수 있습니다. 지원 모델은 seedance-1.5-pro, seedance-2.0, seedance-2.0-fast입니다. 이미 processing/running 상태인 작업은 취소할 수 없습니다. 완료, 실패, 만료 또는 미지원 작업은 상태와 과금 정산을 위해 계속 조회할 수 있습니다.

​
경로 매개변수

​
id
string
필수
create 요청에서 반환되었거나 poll_url에 포함된 비동기 작업 ID입니다.

​
응답

​
id
string
표준 비동기 작업 식별자입니다.
​
task_id
string
비동기 작업 식별자 별칭입니다.
​
poll_url
string
작업의 권장 폴링 URL입니다. 취소 후에도 유효합니다.
​
status
string
작업 상태입니다. 성공적으로 취소된 작업은 기존 상태 값과의 호환성을 위해 failed로 반환되고 cancelled: true가 포함됩니다.
​
cancelled
boolean
작업이 실행 전에 취소되면 true입니다.
​
cancellation_status
string
취소 마커입니다. 취소 성공 시 값은 cancelled입니다.
​
error
string
취소 사유 또는 작업 실패 메시지입니다.

​
오류 동작

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"
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"
}