# Wan API 刪除任務介面 (https://wanapi.app/zh-tw/docs/delete-task)



此介面適用於所有模型。請以 `Authorization: Bearer YOUR_API_KEY` 將金鑰傳送到 `https://api.wanapi.app`。它只能刪除金鑰所屬帳戶的任務。

使用 `DELETE /v1/tasks/{task_id}` 與同一帳戶的金鑰刪除一個已結束的任務。只能刪除已完成或已失敗的任務。任務記錄及其儲存的影片與最後一幀檔案會被永久刪除；計費紀錄與已發生的費用不變。刪除後的任務無法再查詢或下載。每次請求只刪除一個任務。

```bash
curl -X DELETE "https://api.wanapi.app/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $WAN_API_KEY"
```

```json
{
  "id": "task_EXAMPLE",
  "object": "task.deleted",
  "deleted": true
}
```

## 錯誤 [#errors]

| 狀態  | 代碼                    | 說明                            |
| --- | --------------------- | ----------------------------- |
| 404 | `not_found`           | 任務不存在或屬於其他帳戶。                 |
| 409 | `task_not_finished`   | 任務仍在執行中；請在完成或失敗後再刪除。          |
| 409 | `artifact_unverified` | 無法核對已儲存的檔案，因此未刪除任何內容。請聯絡支援團隊。 |
| 503 | `delete_unavailable`  | 請稍後再試。重複送出此請求是安全的。            |
