TokenLab

비동기 작업

작업 취소 (Cancel Task)

모델이 취소를 지원하는 경우 대기 중인 비동기 작업을 취소합니다

DELETE
/v1/tasks/{id}

개요

DELETE /v1/tasks/{id}를 사용하여 아직 실행되지 않은 비동기 작업을 취소합니다. 생성 응답 또는 반환된 poll_url에 포함된 동일한 작업 ID를 사용하십시오.

지원되는 작업

취소 기능은 seedance-2.0, seedance-2.0-fast 또는 seedance-2.5를 사용하는 Seedance 작업 중 해당 작업이 취소를 지원하는 경우에 사용할 수 있습니다. 이미 실행 중이거나 종료 상태인 작업은 취소할 수 없습니다. 취소된 작업은 요금이 부과되지 않습니다. 공개 작업 기록이 유지되는 동안에는 상태를 계속 조회할 수 있습니다.

Volc 호환 Seedance 엔드포인트를 통해 생성된 작업을 취소하려면 작업 취소 (Volc 호환)를 참조하십시오.

경로 매개변수

idstringpath필수

생성 요청 시 반환되거나 poll_url에 포함된 비동기 작업 ID입니다.

응답

idstring

표준 비동기 작업 식별자입니다.

task_idstring

비동기 작업 식별자 별칭입니다.

poll_urlstring

작업 상태 URL입니다. 취소 후에도 유효합니다. id를 사용하여 GET /v1/tasks/{id}를 폴링하십시오.

statusstring

작업 상태입니다. 성공적으로 취소된 작업은 기존 상태 값과의 호환성을 위해 cancelled: true와 함께 failed로 반환됩니다.

cancelledboolean

실행 전에 작업이 취소된 경우 true입니다.

cancellation_statusstring

취소 마커입니다. 취소가 성공하면 값은 cancelled가 됩니다.

errorstring

취소 사유 또는 작업 실패 메시지입니다.

오류 동작

HTTP코드의미
400missing_task_id, invalid_task_id작업 ID가 누락되었거나 유효하지 않은 작업 ID입니다
400unsupported_task_cancel작업 유형 또는 모델이 취소를 지원하지 않습니다
403task_not_owned해당 작업이 이 API 키의 워크스페이스에 속하지 않습니다
404async_task_not_found작업이 만료되었거나 사용할 수 없습니다
409task_not_cancellable작업이 이미 처리 중이거나 완료되었거나 더 이상 취소할 수 없는 상태입니다. current_status를 통해 상태를 확인할 수 있습니다
503async_task_owner_unavailable현재 작업을 읽을 수 없습니다. 다시 시도하십시오

예시

요청

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

인증

BearerAuth
AuthorizationBearer <token>

API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.

위치: header

경로 매개변수

id*string

id / task_id로 반환되거나 poll_url에 포함된 비동기 작업 ID입니다.

응답

application/json

application/json

application/json

application/json

application/json

application/json

application/json