Seedance 2.0 视频生成教程

大约 9 分钟

Seedance 2.0 视频生成教程

Seedance 2.0 是平台提供的视频生成模型系列，支持文生视频、图生视频、参考视频生成、参考音频生成和 1080p 成片。它是异步任务接口：先创建任务拿到 task_id，再查询任务状态，完成后下载视频内容。

合规素材说明

Seedance 2.0 系列不支持直接上传含有真人人脸的参考图或参考视频。若你要做人物类视频，建议优先使用官方体验中心提供的虚拟人像库，或使用你已获得授权、且不涉及真人人脸滥用的自有虚拟角色素材。

接入结论

API Base URL：https://www.yuzhixiaolongxia.com/v1
创建任务：POST /video/generations
查询任务：GET /video/generations/{task_id}
下载视频：GET /videos/{task_id}/content
本地素材上传：POST /api/assets
认证方式：Authorization: Bearer <你的 API 令牌>
公开模型数量：6 个

六个模型怎么选

下表为平台售价。客户展示和接单时，优先使用 售价（元/秒）；售价（元/百万 tokens） 和 倍率 主要用于对账和价格梯度确认。

模型名称	API 模型 ID	参考视频输入	输出分辨率	售价（元/百万 tokens）	倍率	售价（元/秒）	推荐场景
Seedance 2.0 Vision（正式版，支持视频参考）	`seedance-2.0-vision`	支持	480P / 720P，默认 720P	53.05	1.91	1.09	需要视频参考，或只有图片但希望直接走 vision 路径
Seedance 2.0（正式版，无视频输入）	`seedance-2.0`	不支持	480P / 720P，默认 720P	87.42	1.91	1.80	无参考视频，质量优先
Seedance 2.0 Vision 1080P（正式版，支持视频参考）	`seedance-2.0-vision-1080`	支持	1080P	59.03	1.91	1.22	需要视频参考的高清成片，或只有图片但希望直接走 vision 1080p 路径
Seedance 2.0 1080P（正式版，无视频输入）	`seedance-2.0-1080`	不支持	1080P	97.13	1.91	2.00	无参考视频，需要高清成片
Seedance 2.0 Fast Vision（正式版，支持视频参考）	`seedance-2.0-fast-vision`	支持	480P / 720P，默认 720P	41.84	1.91	0.86	vision 路径的快速试稿，可带参考视频，也可只有图片
Seedance 2.0 Fast（正式版，无视频输入）	`seedance-2.0-fast`	不支持	480P / 720P，默认 720P	70.23	1.91	1.45	快速试稿、批量验证提示词

推荐选择规则：

只有提示词：优先 seedance-2.0。
只有提示词，先试稿：优先 seedance-2.0-fast。
需要 1080p 成片：使用 seedance-2.0-1080，并在 metadata.resolution 传 "1080p"。
有参考视频：选择对应的 vision 模型。
有图片参考、没有参考视频：图片直接放入 metadata.reference_images。
当前平台实现里，3 个 vision 模型在没有 reference_videos、只有图片和提示词时也可以直接提交；服务端会自动补齐内部兼容素材。
fast 模型只支持 480P / 720P，不支持 1080P。

虚拟人像库怎么用

如果你的素材需要人物，但又不适合直接用真人照片做参考，建议改用虚拟人像库：

打开火山方舟体验中心，进入虚拟人像库页签。
通过自然语言或条件筛选找到合适的虚拟人像。
在详情里复制对应的 asset ID 或 URI。
在生成任务里把虚拟人像作为参考素材传入，再配合 prompt 描述动作、镜头和场景。
如果需要模板化示例，可以直接查看体验中心模板库里的调用代码。

说明：

每个虚拟人像通常对应一个独立资产标识，便于在任务里复用。
官方说明中，模型生成的视频属于受信素材，可继续用于后续编辑、延长和二次创作。
如果素材里的人脸可识别为真实人物，仍应优先按授权和合规要求处理，不要直接作为普通参考图滥用。

图片生成视频推荐流程

上传图片到素材接口，获得 asset_uri。
创建视频任务，填写 prompt。
把图片 asset_uri 放入 metadata.reference_images。
保存返回的 task_id，轮询任务状态。
完成后下载视频结果。

客户只需要上传提示词和图片即可。只有在确实需要参考一段视频的动作、镜头或节奏时，才需要填写 metadata.reference_videos 并选择带 vision 的模型；如果没有参考视频，但业务上明确想走 vision 路径，当前也可以只传图片。

请求参数

创建任务请求体包含 model、prompt、metadata。

参数	类型	必填	说明
`model`	string	是	六个公开模型 ID 之一
`prompt`	string	是	视频内容描述，建议写清主体、动作、镜头、场景、风格和时长
`metadata`	object	是	视频参数对象

metadata 支持字段：

字段	类型	说明
`reference_images`	string[]	参考图 URL 列表，1 到 9 张。全部 6 个模型都可使用。
`reference_videos`	string[]	参考视频 URL 列表。只有带 `vision` 的 3 个模型支持；非 `vision` 模型不要传。
`reference_audios`	string[]	参考音频 URL 列表，支持 wav、mp3。
`generate_audio`	boolean	是否生成同步音频。
`ratio`	string	`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`adaptive`。
`duration`	number	视频时长，建议 4 到 15 秒。
`resolution`	string	1080p 模型建议传 `"1080p"`。
`seed`	integer	可选随机种子。
`watermark`	boolean	是否加水印。

使用建议

如果只使用图片生成视频，请把图片放在 metadata.reference_images。
如果同时有参考视频，请把视频放在 metadata.reference_videos，并使用带 vision 的模型。
如果没有参考视频，但你明确想用 vision 模型，也可以只传 reference_images；平台会在服务端自动补齐兼容素材。
不要传本地路径、内网地址或需要登录才能访问的素材地址。

上传本地素材

如果素材在本地电脑或业务服务器上，先调用素材上传接口。上传成功后，把返回的 asset_uri 填入 metadata.reference_images、metadata.reference_videos 或 metadata.reference_audios。

curl -X POST "https://www.yuzhixiaolongxia.com/v1/api/assets" \
  -H "Authorization: Bearer $YZX_API_KEY" \
  -F "asset_type=image" \
  -F "file=@./product.png"

响应示例：

{
  "asset_id": "dbsd_asset_xxx",
  "asset_uri": "asset://dbsd_asset_xxx",
  "url": "https://www.yuzhixiaolongxia.com/v1/api/assets/dbsd_asset_xxx/content?token=...",
  "expires_at": 1714007200,
  "file_name": "product.png",
  "asset_type": "image",
  "mime_type": "image/png",
  "size": 123456
}

素材接口适合临时生产素材。平台会在任务结束或素材过期后自动清理临时素材，不建议把它当长期网盘使用。

上传限制（与上游天翼云保持一致或更严）

单个文件最大 100 MB
同一账户当前可用素材总量上限 300 MB；同一令牌上限 200 MB（超额时上传会被拒绝）
上传后 2 小时内未绑定任务，会自动过期清理
已绑定任务的素材在任务结束 24 小时后清理
允许的 MIME 类型：
- 图片：image/jpeg、image/png、image/webp、image/bmp、image/tiff、image/gif
- 视频：video/mp4、video/quicktime、video/webm
- 音频：audio/mpeg、audio/mp3、audio/wav（含 audio/wave、audio/x-wav）
上传后请尽快用 asset_uri 绑定到任务，避免过期。

创建视频任务

只有提示词

curl -X POST "https://www.yuzhixiaolongxia.com/v1/video/generations" \
  -H "Authorization: Bearer $YZX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "prompt": "A cinematic product video of a glass orange soda bottle on a wet black table. Water droplets slide down the bottle, the camera slowly pushes in, soft studio light, realistic commercial style.",
    "metadata": {
      "generate_audio": true,
      "ratio": "16:9",
      "duration": 5,
      "watermark": false
    }
  }'

图片生成视频

curl -X POST "https://www.yuzhixiaolongxia.com/v1/video/generations" \
  -H "Authorization: Bearer $YZX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-fast",
    "prompt": "Use image 1 as the main product. The camera rotates slowly around the product, clean studio lighting, realistic shadows, premium advertising style.",
    "metadata": {
      "reference_images": [
        "asset://dbsd_asset_xxx"
      ],
      "generate_audio": false,
      "ratio": "1:1",
      "duration": 5,
      "watermark": false
    }
  }'

有参考视频

curl -X POST "https://www.yuzhixiaolongxia.com/v1/video/generations" \
  -H "Authorization: Bearer $YZX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-vision",
    "prompt": "Follow the camera movement of video 1. Use image 1 as the product appearance reference. Create a realistic short beverage ad with smooth cuts, close-up bubbles, and a final hero shot.",
    "metadata": {
      "reference_images": [
        "asset://dbsd_asset_img"
      ],
      "reference_videos": [
        "asset://dbsd_asset_video"
      ],
      "reference_audios": [
        "asset://dbsd_asset_audio"
      ],
      "generate_audio": true,
      "ratio": "16:9",
      "duration": 8,
      "watermark": false
    }
  }'

1080p

curl -X POST "https://www.yuzhixiaolongxia.com/v1/video/generations" \
  -H "Authorization: Bearer $YZX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-1080",
    "prompt": "A realistic cinematic city skyline at sunrise, slow aerial push forward, warm light, subtle haze, high detail.",
    "metadata": {
      "generate_audio": false,
      "ratio": "16:9",
      "duration": 5,
      "resolution": "1080p",
      "watermark": false
    }
  }'

创建成功后会返回任务 ID。实现时优先读取 id，没有 id 时再读取 task_id。

{
  "id": "task_abc123",
  "task_id": "task_abc123",
  "object": "video",
  "model": "seedance-2.0",
  "status": "queued",
  "progress": 0,
  "created_at": 1714000000
}

查询任务状态

curl "https://www.yuzhixiaolongxia.com/v1/video/generations/task_abc123" \
  -H "Authorization: Bearer $YZX_API_KEY"

状态	含义	建议动作
`queued` / `pending`	排队中	等待后继续查询
`in_progress` / `processing`	生成中	等待后继续查询
`completed` / `success`	已完成	优先从查询结果取回视频地址，再进入下载或入库
`unknown`	状态不确定	如果响应里带结果 URL，按已完成处理；否则继续轮询
`failed` / `cancelled`	失败或取消	展示错误原因，允许用户修改参数后重试

轮询建议：

创建任务后等待 8 到 10 秒再第一次查询。
后续每 8 到 15 秒查询一次。
总等待建议 3 到 5 分钟。
不要因为一次排队或生成中状态就重新提交，避免重复任务。

下载视频内容

任务状态为 completed 后，优先使用查询结果里的视频地址入库或下载。若结果地址是本站 /v1/videos/{task_id}/content，下载时继续带 Authorization；如果查询结果没有视频地址，再用同一个 task_id 请求内容接口。

curl -L "https://www.yuzhixiaolongxia.com/v1/videos/task_abc123/content" \
  -H "Authorization: Bearer $YZX_API_KEY" \
  --output seedance-result.mp4

结果地址建议按以下顺序取第一个非空值（平台实际返回时上游响应通常带 data 信封，所以信封下的路径排在前面）：

data.result_url
data.data.content.video_url
result_url
content.video_url
url
video_url
output_url
download_url
metadata.url

Seedance 2.0 视频生成教程

Seedance 2.0 视频生成教程

六个模型怎么选

虚拟人像库怎么用

请求参数

上传本地素材

创建视频任务

只有提示词

图片生成视频

有参考视频

1080p

查询任务状态

下载视频内容

常见问题

只有图片，怎么生成视频

没有参考视频，能不能直接用 `vision` 模型

有参考视频但提交失败

1080p 没生效

素材无法读取

任务一直排队

返回 unknown 但没有视频地址

下载失败

401 / 429 / 5xx