비동기 작업
작업 취소 (Cancel Task)
모델이 취소를 지원하는 경우 대기 중인 비동기 작업을 취소합니다
개요
DELETE /v1/tasks/{id}를 사용하여 아직 실행되지 않은 비동기 작업을 취소합니다. 생성 응답 또는 반환된 poll_url에 포함된 동일한 작업 ID를 사용하십시오.
지원되는 작업
취소 기능은 seedance-2.0, seedance-2.0-fast 또는 seedance-2.5를 사용하는 Seedance 작업 중 해당 작업이 취소를 지원하는 경우에 사용할 수 있습니다. 이미 실행 중이거나 종료 상태인 작업은 취소할 수 없습니다. 취소된 작업은 요금이 부과되지 않습니다. 공개 작업 기록이 유지되는 동안에는 상태를 계속 조회할 수 있습니다.
Volc 호환 Seedance 엔드포인트를 통해 생성된 작업을 취소하려면 작업 취소 (Volc 호환)를 참조하십시오.
경로 매개변수
생성 요청 시 반환되거나 poll_url에 포함된 비동기 작업 ID입니다.
응답
표준 비동기 작업 식별자입니다.
비동기 작업 식별자 별칭입니다.
작업 상태 URL입니다. 취소 후에도 유효합니다. id를 사용하여 GET /v1/tasks/{id}를 폴링하십시오.
작업 상태입니다. 성공적으로 취소된 작업은 기존 상태 값과의 호환성을 위해 cancelled: true와 함께 failed로 반환됩니다.
실행 전에 작업이 취소된 경우 true입니다.
취소 마커입니다. 취소가 성공하면 값은 cancelled가 됩니다.
취소 사유 또는 작업 실패 메시지입니다.
오류 동작
| HTTP | 코드 | 의미 |
|---|---|---|
400 | missing_task_id, invalid_task_id | 작업 ID가 누락되었거나 유효하지 않은 작업 ID입니다 |
400 | unsupported_task_cancel | 작업 유형 또는 모델이 취소를 지원하지 않습니다 |
403 | task_not_owned | 해당 작업이 이 API 키의 워크스페이스에 속하지 않습니다 |
404 | async_task_not_found | 작업이 만료되었거나 사용할 수 없습니다 |
409 | task_not_cancellable | 작업이 이미 처리 중이거나 완료되었거나 더 이상 취소할 수 없는 상태입니다. current_status를 통해 상태를 확인할 수 있습니다 |
503 | async_task_owner_unavailable | 현재 작업을 읽을 수 없습니다. 다시 시도하십시오 |
요청
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"
}인증
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