Seedance 2.0
取消视频生成任务
本文介绍取消视频生成任务 API 的输入输出参数，供您使用接口时查阅字段含义。取消一个尚在排队中的任务，使其不再进入生成阶段。
可取消的状态
只有 queued（排队中）的任务可以取消。其他状态返回 403 OperationDenied.InvalidState，响应的 error.reasonCode 补充说明拒绝原因。已经进入生成阶段（running）的任务无法取消。
取消不是立即生效的
200 表示取消请求已被受理，任务不会在响应返回的同时变为 cancelled。最终状态以查询任务返回的 status，或 callback_url 收到的通知为准。
响应结构与查询任务一致。
接口详情
授权
BearerAuth Authorization<token>
需要鉴权的接口请传入 Bearer <token> 形式的访问令牌。
位置: header
路径参数
id*string
任务 ID
响应主体
application/json
application/json
application/json
application/json
application/json
application/json
application/json
在线请求
「发送」会向所选服务器地址发起真实调用，与生产环境请求等效，可能产生计费。
请求示例
curl -X POST "https://example.com/api/v3/contents/generations/tasks/string/cancel"响应示例
{ "content": { "expiredAt": "2026-06-04T10:02:00Z", "last_frame_url": "https://cdn.example.com/last-frame.png", "video_url": "https://cdn.example.com/output.mp4" }, "created_at": 1712664960, "duration": 5, "error": { "code": "upstream_failed", "message": "seedance task failed upstream" }, "execution_expires_after": 172800, "framespersecond": 24, "generate_audio": false, "id": "task_019db400-0000-7000-8000-000000000001", "model": "seedance-2.0", "ratio": "16:9", "resolution": "720p", "revised_prompt": "A cinematic ocean wave at sunset, golden hour lighting.", "seed": 42, "service_tier": "default", "status": "succeeded", "updated_at": 1712664990, "usage": { "completion_tokens": 88, "tool_usage": { "web_search": 0 }, "total_tokens": 88 }}{ "error": { "code": "InvalidParameter", "message": "The parameter content specified in the request is not valid. Request id: 0217790892668142434549f79b621a35", "param": "content", "reasonCode": "seedance_text_blocked_by_moderation", "requestId": "seedance_req_019e8808-d40e-7ccd-873c-072b78b15437", "type": "BadRequest" }}{ "error": { "code": "InvalidParameter", "message": "The parameter content specified in the request is not valid. Request id: 0217790892668142434549f79b621a35", "param": "content", "reasonCode": "seedance_text_blocked_by_moderation", "requestId": "seedance_req_019e8808-d40e-7ccd-873c-072b78b15437", "type": "BadRequest" }}{ "error": { "code": "InvalidParameter", "message": "The parameter content specified in the request is not valid. Request id: 0217790892668142434549f79b621a35", "param": "content", "reasonCode": "seedance_text_blocked_by_moderation", "requestId": "seedance_req_019e8808-d40e-7ccd-873c-072b78b15437", "type": "BadRequest" }}{ "error": { "code": "InvalidParameter", "message": "The parameter content specified in the request is not valid. Request id: 0217790892668142434549f79b621a35", "param": "content", "reasonCode": "seedance_text_blocked_by_moderation", "requestId": "seedance_req_019e8808-d40e-7ccd-873c-072b78b15437", "type": "BadRequest" }}{ "error": { "code": "InvalidParameter", "message": "The parameter content specified in the request is not valid. Request id: 0217790892668142434549f79b621a35", "param": "content", "reasonCode": "seedance_text_blocked_by_moderation", "requestId": "seedance_req_019e8808-d40e-7ccd-873c-072b78b15437", "type": "BadRequest" }}{ "error": { "code": "InvalidParameter", "message": "The parameter content specified in the request is not valid. Request id: 0217790892668142434549f79b621a35", "param": "content", "reasonCode": "seedance_text_blocked_by_moderation", "requestId": "seedance_req_019e8808-d40e-7ccd-873c-072b78b15437", "type": "BadRequest" }}常见问题
取消返回 403 OperationDenied.InvalidState
任务已不在 queued 状态——通常是已经开始生成（running），或已经进入终态。先查询任务确认当前 status：已进入生成阶段的任务无法取消，只能等待其进入终态。
取消成功后如何清理任务
任务转为 cancelled 后即进入终态，可以删除。删除只接受终态任务，所以顺序是先取消、待 status 变为 cancelled、再删除。