Seedance 视频生成

基于 Doubao Seedance 2.0 系列的文本 / 图片 / 多模态生成视频服务，并配套素材库管理。服务地址：https://api.3hei.com

欢迎使用 Seedance 视频生成 服务文档！

本服务集成了 Doubao Seedance 2.0 系列模型，用于 AI 驱动的视频生成。基于传入的图片、视频、音频及文本提示词，可以生成全新视频、编辑视频或延长视频。

支持模型

加载模型列表中...

功能特性

视频生成提供以下场景：

多模态参考生视频：参考图片（0~9）+ 参考视频（0~3）+ 参考音频（0~3）+ 文本提示词（可选）生成视频。不可单独输入音频，应至少包含 1 个参考视频或图片。支持生成全新视频、编辑视频、延长视频。
图生视频-首尾帧：首帧图片 + 尾帧图片 + 文本提示词（可选）。
图生视频-首帧：首帧图片 + 文本提示词（可选）。
文生视频：文本提示词。

Seedance 2.0 系列不支持直接上传含有真人人脸的参考图/视频。文本提示词：中文不超过 500 字，英文不超过 1000 词。

素材库提供自有素材管理：

上传图片 / 视频 / 音频素材，获取 asset_id，在视频生成时用 asset://asset_id 引用。
查询素材处理状态、列出素材、获取公共虚拟人像素材组。

如何使用 Seedance 视频

创建生成任务：调用创建视频任务，传入模型、content 及生成参数。
获取任务 ID：响应中返回用于跟踪的任务 id。
轮询任务状态：使用查询任务检查进度。
下载结果：任务状态变为 completed 后，从 metadata.url 获取生成的视频。

快速开始

Base URL： https://api.3hei.com

鉴权： Authorization: Bearer <你的 API 密钥>

文生视频示例

curl https://api.3hei.com/v1/videos \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-fast",
    "content": [
      { "type": "text", "text": "一只橘猫在阳光下的窗台上伸懒腰，镜头缓慢推进，电影质感" }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5
  }'

图生视频（首帧）示例

curl https://api.3hei.com/v1/videos \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0",
    "content": [
      { "type": "text", "text": "镜头缓缓拉远，画面中的人物转身微笑" },
      { "type": "image_url", "image_url": { "url": "https://example.com/first_frame.jpg" }, "role": "first_frame" }
    ],
    "resolution": "720p",
    "ratio": "adaptive"
  }'

返回任务 id 后，调用查询任务获取生成结果。

请求参数

参数	类型	必填	说明
`model`	string	是	`doubao-seedance-2-0` 或 `doubao-seedance-2-0-fast`
`content`	object[]	是	输入信息数组，支持文本/图片/视频/音频
`resolution`	string	否	视频分辨率：`480p`、`720p`、`1080p`（fast 不支持 1080p），默认 `720p`
`ratio`	string	否	宽高比：`16:9` `4:3` `1:1` `3:4` `9:16` `21:9` `adaptive`，默认 `adaptive`
`duration`	integer	否	时长（秒）`[4,15]` 或 `-1`（模型自选），默认 `5`
`generate_audio`	boolean	否	是否生成与画面同步的声音，默认 `true`
`seed`	integer	否	随机种子 `[-1, 2^32-1]`，默认 `-1`
`watermark`	boolean	否	是否添加水印，默认 `false`
`callback_url`	string	否	任务状态变化回调地址
`return_last_frame`	boolean	否	是否返回尾帧图像，默认 `false`
`priority`	integer	否	执行优先级 `0~9`，默认 `0`
`tools`	object[]	否	工具配置，如联网搜索 `{"type":"web_search"}`（仅文生视频）

content 项类型与 role 速查

类型	字段	role 取值
文本	`type:text`, `text`	-
图片	`type:image_url`, `image_url.url`	首帧 `first_frame`（或不填）/ 尾帧 `last_frame` / 参考图 `reference_image`
视频	`type:video_url`, `video_url.url`	`reference_video`
音频	`type:audio_url`, `audio_url.url`	`reference_audio`（需至少含 1 个视频或图片）

图生视频-首帧、图生视频-首尾帧、多模态参考生视频为 3 种互斥场景，不可混用。

输入素材约束

素材	格式	主要限制
图片	jpeg/png/webp/bmp/tiff/gif/heic/heif	宽高比 (0.4, 2.5)；宽高 (300, 6000)px；单图 < 30 MB
视频	mp4/mov	480p/720p/1080p；单个 `[2,15]s`、总时长 ≤ 15s、最多 3 个；< 50 MB；FPS [24,60]
音频	wav/mp3	单段 `[2,15]s`、总时长 ≤ 15s、最多 3 段；< 15 MB

图片和音频也支持 Base64（如 data:image/png;base64,...）；大文件建议使用 URL 或素材库 asset:// 引用，不要用 Base64。

高级用法：多模态 / 首尾帧

需要参考图、参考视频、参考音频、首尾帧等带用途（role）的复杂输入时，在 content 数组中组合不同类型的输入项。素材可用公网 URL，也可用素材库的 asset:// 引用。

curl https://api.3hei.com/v1/videos \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0",
    "content": [
      { "type": "text", "text": "这个人在唱歌，口型与音频同步" },
      { "type": "image_url", "image_url": { "url": "asset://asset-xxxx" }, "role": "reference_image" },
      { "type": "audio_url", "audio_url": { "url": "https://.../a1.mp3" }, "role": "reference_audio" }
    ],
    "ratio": "16:9",
    "generate_audio": true
  }'

素材库

将自有图片/视频/音频上传为素材，获取 asset_id，在视频生成时用 asset://asset_id 引用。

创建素材：调用创建素材传入公网 URL，获取 asset_id。
轮询状态：调用查询素材，等待 Status 变为 Active（通常 10~60 秒）。
引用素材：在视频生成的 content 中用 asset:// 前缀引用。
管理素材：调用素材列表查看已上传素材，或公共素材组获取平台预置虚拟人像。

任务状态

查询视频生成任务时会返回以下状态值：

状态	含义	处理方式
`queued`	排队中	继续轮询
`in_progress`	生成中	继续轮询
`completed`	已完成	从 `metadata.url` 取视频地址
`failed`	失败	读取 `error.message`

错误处理

现象	原因	处理
`401 Unauthorized`	API 密钥无效或缺失	检查 `Authorization` 头
任务 `failed` + 分辨率相关	分辨率取值不支持	`resolution` 仅支持 `480p`、`720p`、`1080p`（fast 不支持 1080p）
任务 `failed` + 提示词/素材相关	提示词违规或素材不符合约束	调整提示词或参考输入素材约束
`429 Too Many Requests`	请求频率过高	降低查询频率（间隔 ≥ 3s）

API 参考

视频生成

接口	方法	路径	说明
创建视频任务	POST	`/v1/videos`	创建视频生成任务
查询任务	GET	`/v1/videos/{task_id}`	查询任务状态和结果

素材库

接口	方法	路径	说明
创建素材	POST	`/api/v1/open/CreateAsset`	上传素材，获取素材 ID
查询素材	POST	`/api/v1/open/GetAsset`	查询素材详情与状态
素材列表	POST	`/api/v1/open/ListAssets`	查询已上传的素材列表
公共素材组	POST	`/api/v1/open/ListMediaAssetGroup`	查询公共虚拟人像素材库

Seedance 视频生成概览