logo算力仓
使用指南接口文档帮助支持商务合作

SeeDance 2.0 视频接口文档

SeeDance 2.0 视频接口文档

豆包 SeeDance 2.0 提供高质量视频生成模型，本文档描述了使用 SeeDance 2.0 模型进行视频生成的完整 API 接口规范。所有视频生成调用都使用相同的 /v1/video/generations 端点，根据用例使用不同的参数。

支持的模型

目前支持的模型包括：

模型描述
doubao-seedance-2-0-fast-260128SeeDance 2.0 快速视频生成模型
doubao-seedance-2-0-260128SeeDance 2.0 视频生成模型
doubao-seedance-2-0-fast-260128SeeDance 2.0 快速视频生成模型（海外版）
doubao-seedance-2-0-260128SeeDance 2.0 视频生成模型（海外版）

概述

SeeDance 2.0 视频生成功能提供异步任务处理机制：

  1. 提交任务：发送图像和文本提示词，创建视频生成任务
  2. 查询状态：通过任务 ID 查询生成进度和状态
  3. 获取结果：任务完成后获取生成的视频文件

任务状态流转

queued → in_progress → completed
                ↓
            failed
  • queued: 任务已提交，等待处理
  • in_progress: 任务正在处理中
  • completed: 任务成功完成，视频已生成
  • failed: 任务失败

接口列表

方法路径说明
POST/v1/video/generations提交视频生成任务
GET/v1/video/generations/{task_id}查询任务状态

调用示例

1. 基础文本提示词

文生视频使用 prompt 与 model。顶层可选字段包括 duration、size；其他选项可按需放在 metadata 中。

请求体：

{
    "prompt": "A large hand-shaped marble statue with vines growing on it, on a platform in the middle of a shallow pool of water.",
    "model": "doubao-seedance-2-0-fast-260128",
    "duration": 8,
    "size": "720p",
    "metadata": {
        "ratio": "16:9",
        "callback_url": ""
    }
}
字段类型必填说明
promptstring是文生视频提示词
modelstring是模型名称（如 doubao-seedance-2-0-fast-260128）
durationinteger否默认 5。取值：闭区间 4～15 的整数，或 -1 表示自动选择时长
sizestring否默认 720p。允许：480p、720p
metadataobject否额外元数据
metadata.ratiostring否默认 adaptive。允许：16:9、4:3、1:1、3:4、9:16、21:9、adaptive
metadata.callback_urlstring否若设置，将尝试向指定 URL 发送回调。详见 回调。

2. 首帧 / 末帧图像

在 images 中传入 1～2 个图像 URL：第一项为首帧；若传两项，第二项为末帧。顶层可选 duration、size，与 基础文本提示词 一致。

请求体：

{
    "prompt": "图中女孩对着镜头说「茄子」，360度环绕运镜",
    "model": "doubao-seedance-2-0-fast-260128",
    "images": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg",
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg"
    ],
    "duration": 8,
    "size": "720p",
    "metadata": {
        "ratio": "16:9",
        "callback_url": ""
    }
}
字段类型必填说明
promptstring是视频生成提示词
modelstring是模型名称（如 doubao-seedance-2-0-fast-260128）
imagesstring 数组是1～2 个图像 URL：首帧，以及可选的末帧
durationinteger否默认 5。取值：闭区间 4～15 的整数，或 -1 表示自动选择时长
sizestring否默认 720p。允许：480p、720p
metadataobject否额外元数据
metadata.ratiostring否默认 adaptive。允许：16:9、4:3、1:1、3:4、9:16、21:9、adaptive
metadata.callback_urlstring否若设置，将尝试向指定 URL 发送回调。详见 回调。

3. 参考图像

同样使用顶层 images 数组。在 metadata 中设置 "imageMode": "reference" 时，图片作为参考图输入（而非首末帧）。此模式下最多可传 9 张图。顶层可选 duration、size，以及 metadata.ratio，与 基础文本提示词 一致。提示词中可用 [图1]、[图2] 等与 images 顺序对应的占位引用。

请求体：

{
    "prompt": "[图1]戴着眼镜穿着蓝色T恤的男生和[图2]的柯基小狗，坐在[图3]的草坪上，3D卡通风格",
    "model": "doubao-seedance-2-0-fast-260128",
    "images": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_1.png",
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_2.png",
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_3.png"
    ],
    "duration": 8,
    "size": "720p",
    "metadata": {
        "imageMode": "reference",
        "ratio": "16:9",
        "callback_url": ""
    }
}
字段类型必填说明
promptstring是提示词；使用 [图1] … [图N] 按顺序引用参考图
modelstring是模型名称（如 doubao-seedance-2-0-fast-260128）
imagesstring 数组是参考图 URL（本模式下最多 9 张）
durationinteger否默认 5。取值：闭区间 4～15 的整数，或 -1 表示自动选择时长
sizestring否默认 720p。允许：480p、720p
metadataobject否本模式需包含 imageMode
metadata.imageModestring是（本模式）取值为 reference
metadata.ratiostring否默认 adaptive。允许：16:9、4:3、1:1、3:4、9:16、21:9、adaptive
metadata.callback_urlstring否若设置，将尝试向指定 URL 发送回调。详见 回调。

4. 参考视频

在 metadata.referenceVideos 中传入参考视频 URL（最多 3 个）。提示词中可按顺序指代这些视频（如下例中的 视频1 / 视频2 / 视频3）。

请求体：

{
    "prompt": "视频1中的拱形窗户打开，进入美术馆室内，接视频2，之后镜头进入画内，接视频3",
    "model": "doubao-seedance-2-0-fast-260128",
    "size": "720p",
    "duration": 8,
    "metadata": {
        "ratio": "16:9",
        "referenceVideos": [
            "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_extend_video1.mp4",
            "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_extend_video2.mp4",
            "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_extend_video3.mp4"
        ],
        "callback_url": ""
    }
}
字段类型必填说明
promptstring是描述如何衔接、使用参考视频的提示词（如按顺序使用 [video 1]、[video 2]、[video 3]）
modelstring是模型名称（如 doubao-seedance-2-0-fast-260128）
durationinteger否默认 5。取值：闭区间 4～15 的整数，或 -1 表示自动选择时长
sizestring否默认 720p。允许：480p、720p
metadataobject否本模式需包含 referenceVideos
metadata.ratiostring否默认 adaptive。允许：16:9、4:3、1:1、3:4、9:16、21:9、adaptive
metadata.referenceVideosstring 数组是（本模式）参考视频 URL，最多 3 个
metadata.callback_urlstring否若设置，将尝试向指定 URL 发送回调。详见 回调。

参考视频（及输入总体）约束：

  • 数量： referenceVideos 中最多 3 个 URL。
  • 封装格式： mp4 或 mov。
  • 分辨率： 480p 或 720p。
  • 单段时长： 每个视频时长须在 [2, 15] 秒（含端点）；所有输入视频时长之和不得超过 15 秒。
  • 宽高比（宽 ÷ 高）：须在 [0.4, 2.5]（含端点）。
  • 宽、高（像素）：各自须在 [300, 6000]（含端点）。
  • 总像素数（宽 × 高）：须在 [409600, 927408]（含端点）。
  • 文件大小： 单个文件不超过 50 MB。
  • 帧率： 须在 [24, 60] fps（含端点）。

5. 多模态参考

可在同一请求中组合 参考图（images + metadata.imageMode: reference）、参考视频（metadata.referenceVideos）与 参考音频（metadata.referenceAudio）。提示词中可按资源角色指代（如 视频1、音频1、图片1 / 图片2）。参考视频仍需满足上文 参考视频 一节中的约束。

请求体：

{
    "prompt": "全程使用视频1的第一视角构图，全程使用音频1作为背景音乐。第一人称视角果茶宣传广告，seedance牌「苹苹安安」苹果果茶限定款；首帧为图片1，你的手摘下一颗带晨露的阿克苏红苹果，轻脆的苹果碰撞声；2-4 秒：快速切镜，你的手将苹果块投入雪克杯，加入冰块与茶底，用力摇晃，冰块碰撞声与摇晃声卡点轻快鼓点，背景音：「鲜切现摇」；4-6 秒：第一人称成品特写，分层果茶倒入透明杯，你的手轻挤奶盖在顶部铺展，在杯身贴上粉红包标，镜头拉近看奶盖与果茶的分层纹理；6-8 秒：第一人称手持举杯，你将图片2中的果茶举到镜头前（模拟递到观众面前的视角），杯身标签清晰可见，背景音「来一口鲜爽」，尾帧定格为图片2。背景声音统一为女生音色。",
    "model": "doubao-seedance-2-0-fast-260128",
    "images": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg",
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg"
    ],
    "size": "720p",
    "duration": 11,
    "metadata": {
        "imageMode": "reference",
        "referenceVideos": [
            "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4"
        ],
        "referenceAudio": [
            "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
        ],
        "ratio": "16:9",
        "callback_url": ""
    }
}
字段类型必填说明
promptstring是长提示词，可按需使用 [video N]、[audio N]、[image N] 等指代资源
modelstring是模型名称（如 doubao-seedance-2-0-fast-260128）
imagesstring 数组否当 metadata.imageMode 为 reference 时作为参考图（最多 9 张，见上文 参考图像）
durationinteger否默认 5。取值：闭区间 4～15 的整数，或 -1 表示自动选择时长
sizestring否默认 720p。允许：480p、720p
metadataobject否组合下列字段
metadata.imageModestring使用参考图时取值为 reference
metadata.referenceVideosstring 数组否参考视频 URL（最多 3 个，约束见 参考视频）
metadata.referenceAudiostring 数组否参考音频 URL
metadata.ratiostring否默认 adaptive。允许：16:9、4:3、1:1、3:4、9:16、21:9、adaptive
metadata.callback_urlstring否若设置，将尝试向指定 URL 发送回调。详见 回调。

1. 提交视频生成任务

请求体请参考上文 调用示例；按实际场景填写字段。

完整请求：

curl -X POST "https://computevault.unodetech.xyz/v1/video/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer API_KEY" \
  -d @request-body.json

接口地址:

POST /v1/video/generations

请求头:

参数类型必填描述
Content-Typestring是application/json
Authorizationstring是Bearer API_KEY

响应示例:

{
  "task_id": "TASK_ID"
}

响应字段说明:

字段类型说明
task_idstring任务 ID，用于后续查询任务状态

2. 查询任务状态

完整请求：

curl -X GET "https://computevault.unodetech.xyz/v1/video/generations/TASK_ID" \
  -H "Authorization: Bearer API_KEY"

接口地址:

GET /v1/video/generations/{task_id}

请求头:

参数类型必填描述
Authorizationstring是Bearer API_KEY

路径参数:

参数类型必填说明
task_idstring是任务 ID

响应示例（处理中）：

{
    "code": "success",
    "message": "",
    "data": {
        "task_id": "<TASK_ID>",
        "action": "generate",
        "status": "IN_PROGRESS",
        "fail_reason": "",
        "submit_time": 1776717808,
        "start_time": 1776717809,
        "finish_time": 0,
        "progress": "30%",
        "data": {
            "created_at": 1776717808,
            "draft": false,
            "execution_expires_after": 172800,
            "generate_audio": true,
            "id": "<TASK_ID>",
            "model": "doubao-seedance-2-0-fast-260128",
            "service_tier": "default",
            "status": "running",
            "updated_at": 1776717808
        }
    }
}

响应示例（成功）：

注意： 任务成功时，data.fail_reason 字段会包含视频下载 URL 而非错误信息——这是上游 SeeDance API 的已知行为。推荐通过 data.data.content.video_url 字段获取视频地址。

{
    "code": "success",
    "message": "",
    "data": {
        "task_id": "<TASK_ID>",
        "action": "generate",
        "status": "SUCCESS",
        "fail_reason": "<VIDEO_URL>",
        "submit_time": 1776717808,
        "start_time": 1776717818,
        "finish_time": 1776717962,
        "progress": "100%",
        "data": {
            "content": {
                "video_url": "<VIDEO_URL>"
            },
            "created_at": 1776717808,
            "draft": false,
            "duration": 4,
            "execution_expires_after": 172800,
            "framespersecond": 24,
            "generate_audio": true,
            "id": "<TASK_ID>",
            "model": "doubao-seedance-2-0-fast-260128",
            "ratio": "16:9",
            "resolution": "480p",
            "seed": 93719,
            "service_tier": "default",
            "status": "succeeded",
            "updated_at": 1776717961,
            "usage": {
                "completion_tokens": 40594,
                "total_tokens": 40594
            }
        }
    }
}

3. 回调

POST <YOUR_CALLBACK_URL>

Webhook 请求由「外层」结构与载荷组成，格式如下：

{
  "webhook_type": "VIDEO_TASK",
  "payload": {
    "channel_type": "DoubaoVideo",
    "data": {}
  }
}

payload.data 中的数据格式与 2. 查询任务状态 接口响应中的 data 字段一致。

请求示例（任务进行中）

{
  "webhook_type": "VIDEO_TASK",
  "payload": {
    "channel_type": "DoubaoVideo",
    "data": {
      "task_id": "<TASK_ID>",
      "action": "generate",
      "status": "IN_PROGRESS",
      "fail_reason": "",
      "submit_time": 1776717808,
      "start_time": 1776717809,
      "finish_time": 0,
      "progress": "30%",
      "data": {
        "created_at": 1776717808,
        "draft": false,
        "execution_expires_after": 172800,
        "generate_audio": true,
        "id": "<TASK_ID>",
        "model": "doubao-seedance-2-0-fast-260128",
        "service_tier": "default",
        "status": "running",
        "updated_at": 1776717808
      }
    }
  }
}

请求示例（任务成功完成）

{
  "webhook_type": "VIDEO_TASK",
  "payload": {
    "channel_type": "DoubaoVideo",
    "data": {
      "task_id": "<TASK_ID>",
      "action": "generate",
      "status": "SUCCESS",
      "fail_reason": "<VIDEO_URL>",
      "submit_time": 1776717808,
      "start_time": 1776717818,
      "finish_time": 1776717962,
      "progress": "100%",
      "data": {
        "content": {
          "video_url": "<VIDEO_URL>"
        },
        "created_at": 1776717808,
        "draft": false,
        "duration": 4,
        "execution_expires_after": 172800,
        "framespersecond": 24,
        "generate_audio": true,
        "id": "<TASK_ID>",
        "model": "doubao-seedance-2-0-fast-260128",
        "ratio": "16:9",
        "resolution": "480p",
        "seed": 93719,
        "service_tier": "default",
        "status": "succeeded",
        "updated_at": 1776717961,
        "usage": {
          "completion_tokens": 40594,
          "total_tokens": 40594
        }
      }
    }
  }
}

这篇文档对您有帮助吗？

最后更新于

目录

SeeDance 2.0 视频接口文档
支持的模型
概述
任务状态流转
接口列表
调用示例
1. 基础文本提示词
2. 首帧 / 末帧图像
3. 参考图像
4. 参考视频
5. 多模态参考
1. 提交视频生成任务
完整请求：
接口地址:
请求头:
响应示例:
响应字段说明:
2. 查询任务状态
完整请求：
接口地址:
请求头:
路径参数:
响应示例（处理中）：
响应示例（成功）：
3. 回调
请求示例（任务进行中）
请求示例（任务成功完成）