Seedance 2.0 视频生成教程

大约 12 分钟

Seedance 2.0 视频生成教程

Seedance 2.0 是平台当前重点推荐的视频生成模型系列。你可以用一句话直接生成视频，也可以上传图片、视频或音频做参考，再生成广告短片、商品展示、社媒短视频或 1080P 高清成片。

它不是“点一下马上返回 mp4”的同步接口，而是异步任务：先创建任务拿到 task_id，再隔几秒查询一次状态，完成后下载视频。

合规素材说明

本地图片、人物素材、客户上传素材都必须先走本站素材上传接口，生成任务里只引用上传后返回的 asset_uri。不要把本地路径、临时图床、需要登录的链接或未授权真人肖像直接传给生成接口。

接入结论

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

小白先填这三项

不管你用 Cherry Studio、n8n、自己的程序，还是把需求交给 Codex / Claude Code，先准备好这三项：

要填什么	填在哪里	直接填这个 / 这样填
URL / Base URL	工具的接口地址、API Host、Base URL	普通工具默认填 `https://www.yuzhixiaolongxia.com`；代码示例用 `https://www.yuzhixiaolongxia.com/v1`
API Key	工具的 Key、Token、Authorization	去控制台创建 API 令牌，填完整令牌；代码里写成 `Authorization: Bearer <你的 API 令牌>`
模型名称	`model` 字段	从下方表格复制，例如 `seedance-2.0-vision`、`seedance-2.0-fast`

如果你是写代码，最稳的环境变量写法是：

YZX_API_BASE_URL=https://www.yuzhixiaolongxia.com/v1
YZX_API_KEY=替换成你的平台 API 令牌
SEEDANCE_MODEL=seedance-2.0

六个模型怎么选

下表价格来自当前模型广场展示口径。代理价 适合累计自充 5000 以上加赠充值额度的用户查看；零售价 适合普通零售用户按阶梯充值加赠口径查看。实际扣费按任务真实 tokens 计算，下面的元/秒和 15 秒估价用于下单前预估预算。

怎么选	API 模型 ID	参考视频输入	分辨率	代理价格	零售价格	15 秒典型估价（代理 / 零售）
有参考视频，正式质量	`seedance-2.0-vision`	支持	480P / 720P	¥31.29 / 1M tokens 480P 0.52 元/秒 720P 1.13 元/秒	¥38.00 / 1M tokens 480P 0.64 元/秒 720P 1.37 元/秒	480P ¥7.87 / ¥9.56 720P ¥16.92 / ¥20.55
无参考视频，正式质量	`seedance-2.0`	不支持	480P / 720P	¥51.41 / 1M tokens 480P 0.52 元/秒 720P 1.12 元/秒	¥62.43 / 1M tokens 480P 0.63 元/秒 720P 1.36 元/秒	480P ¥7.83 / ¥9.50 720P ¥16.83 / ¥20.44
有参考视频，快速试稿	`seedance-2.0-fast-vision`	支持	480P / 720P	¥24.59 / 1M tokens 480P 0.43 元/秒 720P 0.94 元/秒	¥29.86 / 1M tokens 480P 0.53 元/秒 720P 1.14 元/秒	480P ¥6.52 / ¥7.92 720P ¥14.03 / ¥17.03
无参考视频，快速试稿	`seedance-2.0-fast`	不支持	480P / 720P	¥41.35 / 1M tokens 480P 0.42 元/秒 720P 0.90 元/秒	¥50.21 / 1M tokens 480P 0.51 元/秒 720P 1.10 元/秒	480P ¥6.29 / ¥7.64 720P ¥13.54 / ¥16.44
有参考视频，1080P 高清	`seedance-2.0-vision-1080`	支持	1080P	¥34.65 / 1M tokens 1080P 2.96 元/秒	¥42.07 / 1M tokens 1080P 3.60 元/秒	1080P ¥44.47 / ¥53.99
无参考视频，1080P 高清	`seedance-2.0-1080`	不支持	1080P	¥57.00 / 1M tokens 1080P 2.80 元/秒	¥69.21 / 1M tokens 1080P 3.40 元/秒	1080P ¥41.99 / ¥50.98

推荐选择规则：

只有提示词或图片：正式出片用 seedance-2.0，先试稿用 seedance-2.0-fast。
有参考视频：正式出片用 seedance-2.0-vision，先试稿用 seedance-2.0-fast-vision。
需要 1080P 成片：无参考视频用 seedance-2.0-1080；有参考视频用 seedance-2.0-vision-1080，并在 metadata.resolution 传 "1080p"。
有图片参考、没有参考视频：本地图片先上传到素材接口，再把返回的 asset_uri 放入 metadata.reference_images。
平台支持 3 个 vision 模型在没有 reference_videos、只有图片和提示词时直接提交。
fast 模型只支持 480P / 720P，不支持 1080P。

人物素材怎么处理

如果你的素材涉及人物，不要随手把真实人脸照片当参考图上传。更稳的做法是：

使用已经获得授权的虚拟角色、商品模特图或品牌自有人物素材。
先调用本站 POST /v1/api/assets 上传素材，拿到 asset_uri。
用返回的 asset_uri 创建视频任务，不要把本地文件路径或临时 URL 直接放进生成请求。
如果创建任务返回“素材未就绪”或“素材注册失败”，等待几秒后用同一个 asset_uri 重试；不要改成直接传图片 URL。
在 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[]	参考图 `asset_uri` 列表，1 到 9 张。全部 6 个模型都可使用。
`reference_videos`	string[]	参考视频 `asset_uri` 列表。需要传参考视频时，建议使用带 `vision` 的模型。
`reference_audios`	string[]	参考音频 `asset_uri` 列表，支持 wav、mp3。
`generate_audio`	boolean	是否生成同步音频。
`ratio`	string	`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`adaptive`。
`duration`	number	视频时长，必须是 4 到 15 秒；不传默认 5 秒。3 秒不支持。
`resolution`	string	`480p`、`720p`、`1080p`。不传默认 720p；要生成 480P 必须传 `"480p"`；只有 1080P 模型可传 `"1080p"`。
`seed`	integer	可选随机种子，范围 `-1` 到 `4294967295`。
`watermark`	boolean	是否加水印。

素材约束：

图片：1 到 9 张，支持 jpeg、png、webp、bmp、tiff、gif；宽高比在 0.4 到 2.5 之间；宽和高都在 300 到 6000 px 之间。
参考视频：支持 480p、720p；单个 2 到 15 秒，最多 3 个，总时长不超过 15 秒；宽高比 0.4 到 2.5，宽和高都在 300 到 6000 px 之间。
参考音频：wav、mp3；单个 2 到 15 秒，最多 3 段，总时长不超过 15 秒；单个不超过 15 MB。

使用建议

如果只使用图片生成视频，请先上传图片素材，再把返回的 asset_uri 放在 metadata.reference_images。
如果同时有参考视频，请先上传视频素材，再把返回的 asset_uri 放在 metadata.reference_videos，并使用带 vision 的模型。
如果没有参考视频，但你明确想用 vision 模型，也可以只传已上传素材的 reference_images。
不要传本地路径、内网地址或需要登录才能访问的素材地址。
duration 小于 4 秒会返回参数错误；程序应在本地直接拦截。

上传本地素材

如果素材在本地电脑或业务服务器上，先调用素材上传接口。上传成功后，把返回的 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
}

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

上传成功后，优先直接用返回的 asset_uri 创建任务。若立即创建任务时返回素材未就绪，等待 2 到 5 秒后用同一个 asset_uri 重试；不要改用响应里的临时下载 URL。

上传限制

单个文件最大 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
    }
  }'

图片生成视频

如果要用 seedance-2.0-vision 做 480P 图生视频，最小请求如下。注意本地图片先上传素材接口，生成请求里只放返回的 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-vision",
    "prompt": "Use image 1 as the character and scene reference. Create a 4-second cinematic shot with a slow camera push-in, natural motion, realistic lighting, and stable facial details.",
    "metadata": {
      "reference_images": [
        "asset://dbsd_asset_xxx"
      ],
      "generate_audio": false,
      "ratio": "16:9",
      "duration": 4,
      "resolution": "480p",
      "watermark": false
    }
  }'

如果只是快速试稿，也可以用非 vision 快速模型：

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,
      "resolution": "480p",
      "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,
      "resolution": "720p",
      "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` 模型

为什么 3 秒任务失败

有参考视频但提交失败

人物图片被隐私或真人检测拒绝

1080p 没生效

素材无法读取

任务一直排队

返回 unknown 但没有视频地址

下载失败

401 / 429 / 5xx