数眼智能
官网主页控制台API文档
条款与协议
官网主页控制台API文档
条款与协议
  1. 豆包Seedance视频生成
  • 快速开始
    • 平台简介
    • 控制台(入门)
    • API key
    • Base URL
  • 开发工具接入
    • OpenClaw
    • Claude Code
    • Claude Code IDE
    • Codex
    • OpenCode
    • Cline
    • Grok CLI
    • Gemini CLI
    • N8N
    • AutoClaw
    • 其他工具
  • AI大模型API
    • 文本生成API
      • 对话补全 Chat Completions
    • 视频生成接口API
      • 豆包Seedance视频生成
        • 00-概述
        • 01-创建视频生成任务
        • 02-查询视频生成任务
        • 03-查询视频生成任务列表
        • 04-取消或删除视频生成任务
        • Seedance 私域素材库 API
      • 海螺Hailuo视频生成
        • 00-概述
        • 01-文生视频-T2V
        • 02-图生视频-I2V
        • 03-首尾帧生成视频-FL2V
        • 04-主体参考视频-S2V
        • 05-查询任务状态
        • 06-视频下载
        • 07-附录-运镜指令与回调
      • MiniMax-H3视频生成
        • 00-概述
        • 01-创建视频生成任务
        • 02-创建视频再生成任务
        • 03-创建H3-Context-IR任务
        • 04-查询任务
        • 05-查询任务列表
        • 06-取消或删除任务
      • 可灵AI视频生成-新版接口
        • 00-概述
        • 01-文生视频
        • 02-图生视频
        • 03-Omni视频生成
        • 04-动作控制
        • 05-查询任务
      • 可灵AI视频生成-原版接口
        • 00-概述
        • 01-文生视频
        • 02-图生视频
        • 03-视频Omni
        • 04-多图参考生视频
        • 05-动作控制
        • 06-多模态视频编辑
        • 07-视频延长
        • 08-对口型
        • 09-数字人
        • 10-文生音效
        • 11-视频配音效
        • 12-语音合成
        • 13-音色克隆
        • 14-图像识别
        • 15-主体管理
        • 16-视频特效
      • Vidu视频生成
        • 00-概述
        • 01-文生视频
        • 02-图生视频
        • 03-参考生视频
        • 04-首尾帧
        • 05-智能多帧
        • 06-场景特效模板
        • 07-模板成片
        • 08-查询任务
      • 即梦视频生成
        • 00-概述
        • 01-3.0Pro视频生成
        • 02-720P文生视频
        • 03-720P图生视频-首帧
        • 04-720P图生视频-首尾帧
        • 05-720P图生视频-运镜
        • 06-1080P文生视频
        • 07-1080P图生视频-首帧
        • 08-1080P图生视频-首尾帧
        • 09-错误码
      • 万相视频生成
        • 00-概述
        • 01-文生视频
        • 02-图生视频
        • 03-参考生视频
        • 04-视频编辑
        • 05-首尾帧生视频
        • 06-动作迁移与视频换人
        • 07-数字人视频
        • 08-通用视频编辑-VACE
        • 09-查询任务
      • HappyHorse
        • HappyHorse-文生视频
        • HappyHorse-图生视频-基于首帧
        • HappyHorse-参考生视频
        • HappyHorse-视频编辑
    • 通用图像生成API
      • 图像生成接口文档
    • Rerank重排序模型
      • 重排序
  • 搜索/阅读API
    • 网页阅读API
      • Web Reader API
    • 联网搜索API
      • 搜索API
      • 搜索+阅读API
    • 模态卡API
      • 天气
        • 天气模态卡
        • 城市 ID 对照表
        • 天气查询API
      • 搜索 API(旧)
      • 热搜 API
    • 文件OCR解析API
      • PDF文件
      • URL解析
  • 进阶与系统接口
    • CODE&错误码
    • HTTP注意事项
    • 身份验证
    • 接入指南
    • 在线调试
    • 数据更新相关
    • API 密钥与额度查询接口
    • API 密钥管理接口文档
    • 额度与密钥查询
    • Models(列出模型)
    • 查询账户信息
  1. 豆包Seedance视频生成

04-取消或删除视频生成任务

取消或删除视频生成任务#

取消排队中的视频生成任务,或删除已结束任务的记录。执行哪种操作由任务当前状态决定。

请求#

DELETE https://platform.shuyanai.com/seedance/api/v3/contents/generations/tasks/{id}

请求参数#

路径参数#

参数类型必填说明
idstring是视频生成任务 ID,由01-创建视频生成任务返回。

请求头#

头部必填说明
Authorization是Bearer sk-xxx

不同状态下的行为#

任务当前状态是否支持执行操作操作后
queued(排队中)是取消排队状态变为 cancelled,24 小时后自动删除
running(生成中)否—生成中的任务无法取消
succeeded(生成成功)是删除任务记录不可再查询,视频 URL 失效
failed(生成失败)是删除任务记录不可再查询
cancelled(已取消)是删除任务记录不可再查询
expired(已过期)是删除任务记录不可再查询
注意:删除操作不可逆。删除后任务 ID 不可再查询,视频下载链接(如有)也将失效。

请求示例#

响应参数#

本接口无业务返回字段,成功时 HTTP 状态码为 200。

响应示例#

HTTP/1.1 200 OK

错误场景#

HTTP 状态码错误场景
400请求参数错误(如 ID 格式不合法)
401鉴权失败,API Key 无效或未传入
404任务不存在(task_not_exist:ID 不存在或已超过 7 天保留期被自动清除)
429请求频率超限
500服务端内部错误
上一页
03-查询视频生成任务列表
下一页
Seedance 私域素材库 API