全部文档
当前文档

热搜词推荐

云服务器 虚拟私有网络 边缘节点计算 对等连接

相关产品

共搜索到 0 条结果

暂无内容

如果没有找到您期望的内容，请尝试其他搜索词

文档中心

星流平台

查看更多结果
未找到含当前关键字的文档标题
页面目录
全部展开全部收起
未找到含该关键词的产品
文档中心 星流平台 模型API服务 API文档 视频生成模型 Seedance 2.0

Seedance 2.0

最近更新时间：2026-07-10 20:02:45

Seedance 2.0 是一款多模态视频生成模型，采用音视频联合生成架构，支持文本、图片、音频、视频四种模态输入混合，具备视频编辑、视频延长等能力，可精确控制首尾帧、参考图、运镜方式与动作表现，并支持原生有声视频生成。本文介绍 Seedance 2.0 系列模型的 API 接口能力、请求参数与各类调用示例。

模型版本

模型名称

Model ID

定位

Seedance 2.0

seedance-2.0

追求高生成质量，推荐使用

能力总览

能力

Seedance 2.0

文生视频

✓

图生视频（首帧）

✓

图生视频（首尾帧）

✓

多模态参考（图片 / 视频 / 音频及组合）

✓

编辑视频

✓

延长视频

✓

生成有声视频（generate_audio）

✓

联网搜索工具（tools）

✓

返回视频产物对应的尾帧图（return_last_frame）

✓

输出分辨率

480p / 720p / 1080p / 4k

输出宽高比

21:9、16:9、4:3、1:1、3:4、9:16

输出时长

4 ~ 15 秒

输出视频格式

mp4

接口说明

Seedance 2.0 采用异步任务机制：先调用「创建任务」接口提交请求并获得 task_id，再调用「查询任务」接口轮询任务状态，任务成功后从返回结果中获取视频下载地址。

项

说明

创建任务

POST https://kspmas.ksyun.com/{model}/v3/contents/generations/tasks

查询任务

GET https://kspmas.ksyun.com/{model}/v3/contents/generations/tasks/{task_id}

鉴权方式

请求头携带 Authorization: Bearer $KSC_API_KEY

数据格式

Content-Type: application/json

说明
生成视频的预览 URL 有效期约为 24 小时，请及时转存视频文件。

创建任务

请求参数

字段

类型

必填

默认值

描述

model

string

必填

无

模型名称（Model ID） 枚举值：seedance-2.0

content

array

必填

无

多模态输入内容数组，每个元素描述一个文本、图片、视频或音频条目 详见下文「content 数组说明」

generate_audio

boolean

可选

false

是否在生成视频时同时生成声音 true：生成有声视频；false：不生成

resolution

string

可选

720p

输出视频分辨率 枚举值：480p、720p、1080p、4k

ratio

string

可选

16:9

输出视频宽高比 枚举值：21:9、16:9、4:3、1:1、3:4、9:16、adaptive adaptive：由模型根据输入素材自适应，可缓解首/尾帧图生视频的画面跳变

duration

int

可选

5

生成视频时长，单位 s 取值范围：4 ~ 15

watermark

boolean

可选

true

是否在生成的视频中添加水印

return_last_frame

boolean

可选

false

是否额外返回视频产物对应的尾帧图片

tools

array

可选

无

工具列表。设置 [{"type":"web_search"}] 可开启联网搜索 仅纯文本输入生效

callback_url

string

可选

无

任务状态变更时的回调通知地址

content 数组说明

content 为多模态内容数组，单个元素的字段如下：

字段

类型

必填

默认值

描述

type

string

必填

无

内容类型 枚举值：text、image_url、video_url、audio_url

text

string

条件必填

无

文本提示词，当 type 为 text 时填写 正向 / 负向描述均可写在此处

image_url

object

条件必填

无

图片对象，当 type 为 image_url 时填写，结构为 {"url":"..."}

video_url

object

条件必填

无

视频对象，当 type 为 video_url 时填写，结构为 {"url":"..."}

audio_url

object

条件必填

无

音频对象，当 type 为 audio_url 时填写，结构为 {"url":"..."}

role

string

可选

无

素材在本次生成中的用途 枚举值：reference_image、reference_video、reference_audio、first_frame、last_frame

说明
模态可任意组合，但不支持「文本 + 音频」与「纯音频」输入。数量上限：图片 0 ~ 9 张、视频 0 ~ 3 个、首帧 0 ~ 3 个。

提示词规则
提示词中需用「素材类型 + 序号」引用素材（例如"图片1""视频2"），序号为该素材在 content 中同类素材里的排序（从 1 开始）。不支持使用 Asset ID 指代素材。

响应体

{
    "id": "task_xx" // 任务 ID，系统生成，用于查询任务
}

调用示例

以下示例均省略了轮询查询部分，统一参见「查询任务」。

文生视频

纯文本输入，由文本提示词直接生成视频。

curl -X POST 'https://kspmas.ksyun.com/{model}/v3/contents/generations/tasks' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $KSC_API_KEY" \
  -d '{
    "model": "seedance-2.0",
    "content": [
      { "type": "text", "text": "宇航员在月球表面缓缓躺下，仰望地球，星空璀璨" }
    ],
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": true,
    "watermark": false
  }'

图生视频（首尾帧）

通过 role 指定 first_frame / last_frame，模型在两帧之间生成过渡视频。

curl -X POST 'https://kspmas.ksyun.com/{model}/v3/contents/generations/tasks' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $KSC_API_KEY" \
  -d '{
    "model": "seedance-2.0",
    "content": [
      { "type": "text", "text": "苹果，从采摘到装瓶" },
      { "type": "image_url", "image_url": { "url": "https://example.com/first.jpg" }, "role": "first_frame" },
      { "type": "image_url", "image_url": { "url": "https://example.com/last.jpg" },  "role": "last_frame" }
    ],
    "ratio": "adaptive",
    "duration": 5
  }'

多模态参考

输入文本、参考图、参考视频、参考音频，生成统一风格的新视频，可同时参考图片的角色色彩、视频的画面构图与运动方式、对话内容等核心信息。

curl -X POST 'https://kspmas.ksyun.com/{model}/v3/contents/generations/tasks' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $KSC_API_KEY" \
  -d '{
    "model": "seedance-2.0",
    "content": [
         {
            "type": "text",
            "text": "参考图片1的角色与图片2的服饰，按视频1的运镜方式，配合音频1的口播，生成一段产品种草短视频"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://example.com/pic1.jpg"
            },
            "role": "reference_image"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://example.com/pic2.jpg"
            },
            "role": "reference_image"
        },
        {
          "type": "video_url",
          "video_url": {
              "url": "https://example.com/video1.mp4"
          },
          "role": "reference_video"
        },
        {
          "type": "audio_url",
          "audio_url": {
              "url": "https://example.com/audio1.mp3"
          },
          "role": "reference_audio"
        }
    ],
    "generate_audio":true,
    "ratio": "16:9",
    "duration": 11,
    "watermark": false,
    "resolution": "1080p"
}'

说明
多模态参考下可通过参考词将参考图片作为首帧 / 尾帧以实现「首尾帧 + 多模态参考」效果；若需严格保证首尾帧与指定图片一致，请优先使用「图生视频（首尾帧）」并配置 role 为 first_frame / last_frame。

编辑视频

基于参考视频，结合文本提示词对视频进行主体替换、对象增删、局部画面重绘、修复等编辑。

curl -X POST 'https://kspmas.ksyun.com/{model}/v3/contents/generations/tasks' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $KSC_API_KEY" \
  -d '{
    "model": "seedance-2.0",
    "content": [
      { "type": "text", "text": "将视频1礼盒中的香水替换成图像1中的面霜，运镜不变" },
      { "type": "image_url", "image_url": { "url": "https://example.com/edit_pic1.jpg" }, "role": "reference_image" },
      { "type": "video_url", "video_url": { "url": "https://example.com/edit_video1.mp4" }, "role": "reference_video" }
    ],
    "generate_audio": true,
    "ratio": "16:9",
    "duration": 5
  }'

延长视频

向前 / 向后延长一段视频，或传入 2 ~ 3 段视频片段（最多 3 段）串联成一段连续视频，补全中间过渡部分。

curl -X POST 'https://kspmas.ksyun.com/{model}/v3/contents/generations/tasks' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $KSC_API_KEY" \
  -d '{
    "model": "seedance-2.0",
    "content": [
      { "type": "text", "text": "镜头依次推进三段画面，形成一镜到底的连贯运动" },
      { "type": "video_url", "video_url": { "url": "https://example.com/extend_video1.mp4" }, "role": "reference_video" },
      { "type": "video_url", "video_url": { "url": "https://example.com/extend_video2.mp4" }, "role": "reference_video" },
      { "type": "video_url", "video_url": { "url": "https://example.com/extend_video3.mp4" }, "role": "reference_video" }
    ],
    "generate_audio": true,
    "ratio": "16:9",
    "duration": 8
  }'

说明
向前 / 向后延长一段时，生成的视频一般只包含原视频的尾部 / 首部画面续接；传入 2 ~ 3 段视频补全中间过渡时，生成的视频会同时包含原视频内容与新生成内容。

输出 4k 视频

仅 Seedance 2.0 支持。设置 resolution 为 4k。

curl -X POST 'https://kspmas.ksyun.com/{model}/v3/contents/generations/tasks' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $KSC_API_KEY" \
  -d '{
    "model": "seedance-2.0",
    "content": [
      { "type": "text", "text": "儿童背向奔跑在草坪上，电影感人物特写，金色逆光，浅景深，细节锐利" }
    ],
    "generate_audio": true,
    "resolution": "4k",
    "ratio": "16:9",
    "duration": 15
  }'

注意
4k 视频采用 H.265（HEVC）10bit 编码格式输出，部分播放器 / 浏览器可能无法直接播放，详见「常见问题 - 4k 播放器兼容性」。

查询任务

请求参数

字段

类型

必填

默认值

描述

task_id

string

必填

无

创建任务时返回的任务 ID，作为请求路径参数填入

调用示例

curl -X GET 'https://kspmas.ksyun.com/{model}/v3/contents/generations/tasks/{task_id}' \
  -H "Authorization: Bearer $KSC_API_KEY"

响应体

{
    "id": "task_xxxxxx",
    "model": "seedance-2-0",
    "status": "succeeded",      // 任务状态：queued、running、succeeded、failed
    "content": {
        "video_url": "https://.../output.mp4" // 生成视频的下载地址，约 24 小时内有效，请及时转存
    },
    "resolution": "720p",
    "duration": 5,
    "ratio": "16:9",
    "usage": {
        "total_token": 0,
        "tool_usage": 0
    },
    "error": null,                    // 任务失败时返回错误信息
    "created_at": 1783420742,
    "updated_at": 1783420839
}

使用限制

项

限制

输入模态组合

不支持「文本 + 音频」「纯音频」输入

图片数量

0 ~ 9 张

视频数量

0 ~ 3 个

首帧数量

0 ~ 3 个

输出时长

4 ~ 15 秒

4k 输出

仅 Seedance 2.0 支持；4k 非企业用户最大 RPM 15、最大并发 1

产物有效期

视频预览 URL 约 24 小时，请及时转存

常见问题

4k 播放器兼容性

Seedance 2.0 生成的 4k 视频采用 H.265 / HEVC、10bit 编码，对播放环境有一定要求，实际效果可能因设备配置而异。

  • Windows：浏览器推荐 Edge、Chrome；播放器推荐 VLC、mpv。

  • macOS：浏览器推荐 Safari、Chrome；播放器推荐 VLC、mpv、QuickTime Player。

部分浏览器（如 Firefox、QQ、Opera 等）为「有条件支持」，依赖设备的硬件解码能力，建议以实际测试为准。

视频画面存在跳变

现象：首帧 / 首尾帧图生视频结果中，生成视频部分出现画面拉伸、压缩等跳变。

根因：输入图片与输出视频的分辨率宽高不一致，引发画面跳变。

解决方案：

  1. 裁剪输入图片：参考所支持的宽高像素值，将输入图片裁剪为目标宽高像素值。

  2. 将 ratio 字段设置为 adaptive。

  3. 使用 Seedance 2.0 系列模型重新发起首帧 / 首尾帧图生视频任务。

文档导读
上一篇：可灵AI
下一篇：图片生成模型
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈