Seedance 2.0 视频生成模型接入指南

Seedance 2.0 是火山引擎（Volcengine）提供的视频生成模型系列，支持文生视频、图生视频、首尾帧生视频、多模态参考生视频等多种模式。

接口基地址: https://api.numspirit.com/v1

模型列表

模型ID	功能	说明
`seedance-2-0`	文生视频 / 图生视频 / 参考生视频	标准版，支持多种生成模式
`seedance-2-0-fast`	文生视频（快速版）	生成速度更快，质量略低
`seedance-2-0-mini`	文生视频（轻量版）	仅支持 480p/720p，不支持参考视频/音频

接口概览

功能	接口路径	方法	说明
视频生成	`/v1/videos/generations`	POST	提交视频生成任务
任务查询	`/v1/videos/generations/{task_id}`	GET	查询任务状态

⚠️ 素材引用方式（重要）：下文所有涉及参考素材的参数（inputAssetId / inputAssetIdEnd / referenceImages / referenceVideos / referenceAudios），推荐统一使用 asset://<assetID> 格式（素材需先通过素材管理接口入库，见《seedance视频接入素材接口.md》）。直接传素材的 HTTP 地址大概率会被模型拒绝或报错，尤其含人物形象的人脸/真人素材必须走素材库通道。

1. 文生视频 - seedance-2-0

根据文本描述生成视频。

请求参数

参数	类型	必填	说明
`model`	string	是	模型ID：`seedance-2-0`
`prompt`	string	是	视频描述文本
`resolution`	string	是	分辨率：`480p`、`720p`、`1080p`、`4k`
`ratio`	string	是	宽高比：`16:9`、`9:16`、`1:1`、`4:3`、`3:4`、`4:5`、`5:4`、`9:21`、`21:9`
`duration`	integer	是	时长（秒）：4-15，默认 5
`generate_audio`	boolean	否	是否生成音频，默认 `true`

cURL 示例

响应示例

{
  "success": true,
  "data": {
    "task_id": "cgt-20260726200402-b6z9x",
    "model": "seedance-2-0",
    "status": "PENDING"
  }
}

2. 图生视频 - seedance-2-0

基于首帧图片生成视频。

请求参数

参数	类型	必填	说明
`model`	string	是	模型ID：`seedance-2-0`
`prompt`	string	是	视频描述文本
`resolution`	string	是	分辨率：`480p`、`720p`、`1080p`、`4k`
`ratio`	string	是	宽高比
`duration`	integer	是	时长（秒）：4-15
`inputAssetId`	string	是	首帧图片，推荐使用 `asset://<assetID>` 格式

cURL 示例

3. 首尾帧生视频 - seedance-2-0

根据首帧和尾帧图片生成视频，视频内容从首帧过渡到尾帧。

请求参数

参数	类型	必填	说明
`model`	string	是	模型ID：`seedance-2-0`
`prompt`	string	是	视频描述文本
`resolution`	string	是	分辨率
`ratio`	string	是	宽高比
`duration`	integer	是	时长（秒）：4-15
`inputAssetId`	string	是	首帧图片，推荐使用 `asset://<assetID>` 格式
`inputAssetIdEnd`	string	是	尾帧图片，推荐使用 `asset://<assetID>` 格式

cURL 示例

4. 多模态参考生视频 - seedance-2-0

根据多张参考图片（3~9张）生成视频，支持多主体一致性。

请求参数

参数	类型	必填	说明
`model`	string	是	模型ID：`seedance-2-0`
`prompt`	string	是	视频描述文本
`resolution`	string	是	分辨率
`ratio`	string	是	宽高比
`duration`	integer	是	时长（秒）：4-15
`referenceImages`	array	是	参考图片列表，推荐使用 `asset://<assetID>` 格式，3~9张

cURL 示例

5. 参考视频生视频 - seedance-2-0

根据参考视频生成风格一致的新视频（最多3个参考视频）。

请求参数

参数	类型	必填	说明
`model`	string	是	模型ID：`seedance-2-0`
`prompt`	string	是	视频描述文本
`resolution`	string	是	分辨率
`ratio`	string	是	宽高比
`duration`	integer	是	时长（秒）：4-15
`referenceVideos`	array	是	参考视频列表，推荐使用 `asset://<assetID>` 格式，最多3个

⚠️ 注意：seedance-2-0-mini 模型不支持参考视频。

cURL 示例

6. 参考音频生视频 - seedance-2-0

根据参考音频生成视频，音频驱动视频内容（最多3个参考音频）。

请求参数

参数	类型	必填	说明
`model`	string	是	模型ID：`seedance-2-0`
`prompt`	string	是	视频描述文本
`resolution`	string	是	分辨率
`ratio`	string	是	宽高比
`duration`	integer	是	时长（秒）：4-15
`referenceAudios`	array	是	参考音频列表，推荐使用 `asset://<assetID>` 格式，最多3个

⚠️ 注意：seedance-2-0-mini 模型不支持参考音频。

cURL 示例

7. 查询任务状态

接口

GET https://api.numspirit.com/v1/videos/generations/{task_id}?model={model_id}

说明

task_id: 创建任务时返回的任务ID

model: 创建任务时使用的模型ID（用于确定查询渠道）

cURL 示例

响应示例（进行中）

{
  "success": true,
  "data": {
    "task_id": "cgt-20260726200402-b6z9x",
    "status": "running",
    "output_urls": [],
    "error": null
  }
}

响应示例（成功）

{
  "success": true,
  "data": {
    "task_id": "cgt-20260726200402-b6z9x",
    "status": "succeeded",
    "output_urls": [
      "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0/xxx.mp4?X-Tos-Algorithm=..."
    ],
    "error": null
  }
}

Seedance 原始响应示例

{
  "id": "cgt-20260726200402-b6z9x",
  "model": "doubao-seedance-2-0-260128",
  "status": "succeeded",
  "content": {
    "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/..."
  },
  "usage": {
    "completion_tokens": 108900,
    "total_tokens": 108900
  },
  "created_at": 1785067444,
  "updated_at": 1785067676,
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "framespersecond": 24,
  "generate_audio": true
}

通用参数说明

resolution（分辨率）

值	说明	Mini模型支持
`480p`	标清	✅
`720p`	高清	✅
`1080p`	全高清	❌（Mini强制降级为720p）
`4k`	超高清	❌（Mini强制降级为720p）

ratio（宽高比）

值	说明
`16:9`	横屏（默认）
`9:16`	竖屏
`1:1`	正方形
`4:3`	标准屏
`3:4`	竖屏
`4:5`	竖屏
`5:4`	横屏
`9:21`	竖屏（手机长屏）
`21:9`	横屏（电影宽屏）

duration（时长）

范围：4-15 秒

默认：5 秒

计费说明

预扣费（提交时）

按秒预扣费用，不同分辨率价格不同：

分辨率	价格（元/秒）
`480p`	0.5
`720p`	1.0
`1080p`	2.5
`4k`	5.0

预扣费公式：价格 × 秒数 × priceMarkup

实际计费（任务完成时）

Seedance 按实际消耗的 completion_tokens 计费，不同分辨率价格不同：

分辨率	输入不含视频（元/百万tokens）	输入包含视频（元/百万tokens）
`480p` / `720p`	46.00	28.00
`1080p`	51.00	31.00
`4k`	26.00	16.00

实际计费公式：(completion_tokens / 1,000,000) × 单价 × priceMarkup

输入包含视频指：图生视频、首尾帧生视频、参考视频生视频等模式。

附录：文件上传接口

Seedance 模型的图生视频、参考生视频等功能需要图片、视频或音频文件。你可以通过以下接口上传文件到阿里云 OSS，获取临时签名 URL。

单文件上传

接口: POST https://api.numspirit.com/v1/uploads

请求 Header:

Authorization: Bearer sk-silievo-xxxxxxxx
Content-Type: multipart/form-data

请求参数:

参数	类型	必填	说明
`file`	File	是	要上传的文件（图片/音频/视频）

支持的文件类型:

图片：image/png, image/jpeg, image/webp, image/gif

音频：audio/mpeg, audio/wav, audio/mp3, audio/aac, audio/ogg, audio/flac

视频：video/mp4, video/webm, video/quicktime

cURL 示例:

响应示例:

{
  "success": true,
  "data": {
    "url": "https://numspirit-media.oss-cn-shenzhen.aliyuncs.com/users/123/uploads/2026-07/xxx.jpg?Expires=...",
    "oss_key": "users/123/uploads/2026-07/xxx.jpg",
    "mime": "image/jpeg",
    "size": 102400
  }
}

批量文件上传

接口: POST https://api.numspirit.com/v1/uploads/batch

请求参数:

参数	类型	必填	说明
`files`	File[]	是	要上传的文件列表（最多 5 个）

cURL 示例:

响应示例:

{
  "success": true,
  "data": [
    {
      "url": "https://numspirit-media.oss-cn-shenzhen.aliyuncs.com/users/123/uploads/2026-07/xxx1.jpg?Expires=...",
      "oss_key": "users/123/uploads/2026-07/xxx1.jpg",
      "mime": "image/jpeg",
      "size": 102400
    },
    {
      "url": "https://numspirit-media.oss-cn-shenzhen.aliyuncs.com/users/123/uploads/2026-07/xxx2.png?Expires=...",
      "oss_key": "users/123/uploads/2026-07/xxx2.png",
      "mime": "image/png",
      "size": 204800
    }
  ]
}

使用上传后的素材

⚠️ 推荐用 asset://<assetID> 引用素材，直接传上传接口返回的 HTTP url 大概率会被模型拒绝或报错。素材需先通过素材管理接口入库（POST /v1/materials/upload，见《seedance视频接入素材接口.md》），拿到素材 id 后拼 asset://<assetID> 再用于生成：

seedance视频接入

Seedance 2.0 视频生成模型接入指南#

模型列表#

接口概览#

1. 文生视频 - seedance-2-0#

请求参数#

cURL 示例#

响应示例#

2. 图生视频 - seedance-2-0#

请求参数#

cURL 示例#

3. 首尾帧生视频 - seedance-2-0#

请求参数#

cURL 示例#

4. 多模态参考生视频 - seedance-2-0#

请求参数#

cURL 示例#

5. 参考视频生视频 - seedance-2-0#

请求参数#

cURL 示例#

6. 参考音频生视频 - seedance-2-0#

请求参数#

cURL 示例#

7. 查询任务状态#

接口#

说明#

cURL 示例#

响应示例（进行中）#

响应示例（成功）#

Seedance 原始响应示例#

通用参数说明#

resolution（分辨率）#

ratio（宽高比）#

duration（时长）#

计费说明#

预扣费（提交时）#

实际计费（任务完成时）#

附录：文件上传接口#

单文件上传#

批量文件上传#

使用上传后的素材#

Seedance 2.0 视频生成模型接入指南

模型列表

接口概览

1. 文生视频 - seedance-2-0

请求参数

cURL 示例

响应示例

2. 图生视频 - seedance-2-0

请求参数

cURL 示例

3. 首尾帧生视频 - seedance-2-0

请求参数

cURL 示例

4. 多模态参考生视频 - seedance-2-0

请求参数

cURL 示例

5. 参考视频生视频 - seedance-2-0

请求参数

cURL 示例

6. 参考音频生视频 - seedance-2-0

请求参数

cURL 示例

7. 查询任务状态

接口

说明

cURL 示例

响应示例（进行中）

响应示例（成功）

Seedance 原始响应示例

通用参数说明

resolution（分辨率）

ratio（宽高比）

duration（时长）

计费说明

预扣费（提交时）

实际计费（任务完成时）

附录：文件上传接口

单文件上传

批量文件上传

使用上传后的素材