TokenLab

비동기 작업

작업 취소

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

DELETE
/v1/tasks/{id}

개요

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

지원 작업

취소를 지원하는 대기 중 Seedance 작업에는 seedance-1.5-pro, seedance-2.0, seedance-2.0-fast, seedance-2.5가 포함됩니다. 실행 중이거나 종료 상태인 작업은 취소할 수 없습니다. 공개 작업 기록이 보관되는 동안 상태를 조회할 수 있습니다.

경로 매개변수

idstringpath필수

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

응답

idstring

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

task_idstring

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

poll_urlstring

작업의 권장 폴링 URL입니다. 취소 후에도 유효합니다.

statusstring

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

cancelledboolean

작업이 실행 전에 취소되면 true입니다.

cancellation_statusstring

취소 마커입니다. 취소 성공 시 값은 cancelled입니다.

errorstring

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

오류 동작

400 unsupported_task_cancel은 작업 유형, 공급자 또는 모델이 취소를 지원하지 않음을 의미합니다. 409 task_not_cancellable은 작업이 이미 처리 중이거나 종료 상태이거나 더 이상 취소할 수 없음을 의미합니다. 403은 API key가 해당 작업에 접근할 수 없음을 의미합니다.

예시

요청

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

인증

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