TokenLab 新增已排隊 Seedance 影片任務的取消功能

TokenLab 現在支援在 Seedance 影片生成任務開始處理前，取消佇列中的任務。如果您提交的任務包含錯誤的提示詞 (prompt)、錯誤的來源圖片或重複的請求，您可以呼叫 DELETE /v1/tasks/{id} 來停止該任務，避免其佔用處理資源。這解決了所有執行非同步影片管線開發者都會遇到的痛點：提交後才後悔。

重點摘要

• 取消功能適用於支援的模型中處於佇列狀態的任務；一旦任務進入處理階段或達到終止狀態，通常就無法再取消。
• API 端點為 DELETE /v1/tasks/{id}，ID 與您在建立任務時收到的任務 ID 相同。
• 已取消的任務仍可透過標準的任務狀態端點進行查詢，因此您的輪詢 (polling) 邏輯無需進行特殊處理。
• 此功能對於高流量的非同步影片佇列最有價值，因為錯誤輸入和重複重試的情況很常見，若任由其執行會造成資源浪費。

為什麼這對影片生成管線很重要

影片生成不像文字補全，如果不喜歡輸出結果，直接忽略即可。Seedance 任務是以非同步方式執行，需要實際時間進行處理，且從被接受的那一刻起就會佔用佇列位置。如果您的應用程式提交了一個帶有錯誤提示詞、損毀的來源圖片或與實際使用案例不符解析度的任務，您之前唯一的選擇就是讓它執行完畢，然後丟棄結果。

這在兩個方面造成了浪費。首先，您正在等待一個本可以用來處理您真正需要之任務的佇列位置。其次，如果您的系統針對單一使用者操作會分發多個影片任務（這在編輯工具、批次內容管線或任何具有重試邏輯的系統中很常見），一個 Bug 或使用者的雙擊操作可能會悄悄堆積多個針對相同意圖的佇列任務。如果沒有取消功能，無論您是否還需要該結果，所有任務都會執行到完成為止。

任務取消功能讓您可以從源頭解決此問題。當您偵測到錯誤輸入、重複提交或使用者發起的終止操作（例如關閉分頁、取消上傳或改變生成請求的主意）時，您可以直接取消佇列中的任務，而不必等待其完成後再在下游丟棄輸出。

Seedance 任務取消功能運作方式

其機制是對任務資源發送標準的 DELETE 請求：

DELETE /v1/tasks/{id}

您需要傳入建立影片生成任務時所回傳的相同任務 ID。如果任務仍在佇列中且該模型支援取消，TokenLab 會將其標記為已取消，且該任務將不會進入處理階段。

以下是幾種值得納入設計的行為：

• 佇列中的任務可被取消。這是主要的處理窗口。如果任務尚未開始處理，取消操作通常會成功。
• 處理中或已終止的任務可能無法取消。一旦任務進入主動處理階段，或已達到終止狀態（已完成、失敗或先前已取消），取消呼叫可能會被拒絕。您的整合程式應將此視為預期的結果，而非需要積極重試的錯誤條件。
• 已取消的任務仍可查詢。取消後，您仍然可以呼叫標準的任務狀態端點，並取得顯示已取消狀態的任務物件。這對於日誌記錄、稽核以及向終端使用者顯示工作歷史的儀表板非常重要——您不會因為任務被取消而失去對其發生狀況的追蹤。
• 並非所有任務/模型組合都支援取消。在將取消功能整合至關鍵路徑前，請查閱目前的說明文件，確認哪些 Seedance 任務類型允許此操作。支援程度會因模型及影片生成 API 內的任務類型而異。

關於完整的請求與回應架構，請參閱任務取消參考文件。

何時該使用取消功能

取消功能是用於特定失敗模式的工具，而非管理每個佇列任務的通用控制手段。以下是它在您的管線中發揮作用的場景：

情境	取消功能如何提供協助
提交了錯誤的提示詞	在任務消耗處理資源產生您不需要的輸出前停止它
附加了錯誤的來源圖片/影片	同上——在提交後捕捉輸入驗證失敗
重複提交（雙擊、重試風暴）	取消冗餘的副本，保留第一個有效的任務執行
使用者在流程中途放棄請求	在生成開始前關閉分頁、取消上傳或使用者改變主意
佇列積壓導致任務過期	如果任務對於請求它的使用者工作階段已不再相關，取消它而非讓其完成後閒置

取消功能不適用於：因為不耐煩而試圖停止已經在處理中的任務，或是將「取消後重新提交」作為提交前驗證輸入的替代方案。請務必先進行驗證。取消功能是安全網，而非主要控制手段。

非同步影片佇列的整合檢查清單

如果您要將取消功能整合到現有的 Seedance 整合中，請執行以下清單：

• 將建立時回傳的任務 ID 儲存到應用程式稍後可以查詢的地方（工作階段狀態、任務資料表或您的佇列所使用的任何儲存方式）。
• 新增由您自己的重複偵測邏輯觸發的取消路徑，而不僅僅是依賴使用者操作——這可以自動捕捉重試風暴。
• 優雅地處理「無法取消」的回應。如果任務已經進入處理階段，請勿將被拒絕的取消請求視為致命錯誤——若有必要，請退回到等待結果並將其丟棄的流程。
• 在發出取消呼叫後，持續輪詢任務狀態端點以確認狀態確實變更為已取消，而不是僅僅假設 DELETE 回應成功就代表完成。
• 將取消功能作為任何「使用者關閉應用程式」或工作階段終止邏輯中的明確步驟，這樣被放棄的任務就不會無謂地執行到完成。
• 像記錄已完成和失敗的任務一樣記錄已取消的任務——這些資料對於發現重複提交或錯誤輸入驗證的模式非常有用。

如果您尚未為 Seedance 任務建立穩健的輪詢邏輯，請在閱讀此功能說明時一併參考非同步任務與輪詢指南——取消與輪詢是任務生命週期管理問題的兩個面向。

常見問題 (FAQ)

我可以取消已經在處理中的 Seedance 任務嗎？ 通常不行。取消功能是為佇列中的任務設計的。一旦任務進入主動處理階段，它可能就無法再被取消，您應該檢查取消呼叫的回應，而不是假設它一定會成功。

已取消的任務在查詢任務狀態時還會出現嗎？ 會。已取消的任務仍可透過標準的任務狀態端點進行查詢。您會在那裡看到反映出的已取消狀態，這能確保您的日誌和歷史記錄即使對於提早停止的任務也能保持一致。

每個 Seedance 任務類型都支援取消嗎？ 不一定。支援程度取決於特定的任務與模型組合。在將取消功能作為整合中的硬性保證之前，請務必查閱目前的 API 參考文件。

來源與時效性

本文反映了截至 2026-07-07 為止的 TokenLab API 文件與觀察到的行為。如需最新的端點詳細資訊，請直接查閱任務取消 API 參考文件與Seedance API 指南，因為任務對取消功能的支援可能會隨著模型更新而變更。

---

如果您正在將影片生成功能整合到產品中，並且需要在 Seedance、Veo 3、PixVerse V6 或 Kling 3.0 之間進行可靠的佇列控制，TokenLab 為您提供了一個具有一致任務生命週期行為的 API 介面，包括在支援的影片模型中進行取消操作。請查閱說明文件，並在下一次高流量執行前清理您的整合程式。

相關閱讀與後續步驟

針對佇列中 Seedance 影片任務的取消功能，讓開發者能更有效地控制運算支出與任務佇列，但若能同時深入了解更廣泛的影片生成領域，效果會更好。關於 Seedance 如何融入常見影片工作流程的背景資訊，請參閱Seedance API 指南：何時在 AI 影片生成中使用它。如果您在決定模型前正在比較多個供應商，2026 年最佳 AI 影片模型 API 指南：開發者應如何選擇影片生成模型涵蓋了關鍵的選擇標準，而2026 年 AI 影片 API 定價：開發者應如何比較成本則分析了各項服務的成本結構。

模型可用性與定價變動頻繁，請在高流量生產環境使用前確認目前的模型與定價細節。準備好親自測試取消功能與其他佇列控制了嗎？建立 API 金鑰並立即開始吧。