视频生成总览

大约 8 分钟

视频生成总览

先看这一页，再决定用哪个视频模型。当前重点推荐 Seedance 2.0：模型多、可文生视频、图生视频、参考视频、参考音频，还能做 1080P 高清成片。这一页讲怎么填 URL、Key、模型名和价格怎么看；具体参数再进各自教程页。

接口结论（所有视频模型通用）

平台地址 / 工具 URL：https://www.yuzhixiaolongxia.com
代码调用 Base URL：https://www.yuzhixiaolongxia.com/v1
创建任务：POST /video/generations（单数 video，注意不是复数 videos）
查询任务：GET /video/generations/{task_id}（平台查询路由，无需配置回调）
下载视频：GET /videos/{task_id}/content（这一段是下载文件流，路径是复数）
认证方式：HTTP Header Authorization: Bearer <你的 API 令牌>
任务模式：异步（先提交、再轮询、再下载，不要配置任何外部 callback，调用上面查询接口取结果即可）
模型 ID 与价格：以模型广场实际显示为准

还没拿 API 令牌？

先去快速开始注册账号、充值。
在创建 API 令牌页面，按你要用的模型挑对应分组创建一个令牌。
把令牌当作密码保存好，不要贴到前端代码或公开仓库。

小白照填三项

要填什么	填在哪里	怎么填
URL / Base URL	工具接口地址、API Host、Base URL	普通工具填 `https://www.yuzhixiaolongxia.com`；代码请求用 `https://www.yuzhixiaolongxia.com/v1`
API Key	Key、Token、Authorization	控制台创建 API 令牌，Header 写 `Authorization: Bearer <你的 API 令牌>`
模型名称	`model` 字段	从下面模型表复制，例如 `seedance-2.0-vision`

令牌和余额

创建令牌时要选择支持视频生成的分组。分组名以控制台实际显示为准。
如果调用返回 401，通常是 Key 错、令牌没权限或模型分组不匹配。
如果返回余额不足，先充值再试；视频任务成功后才扣费，失败或取消不扣。

首推：Seedance 2.0 六个模型

Seedance 2.0 是当前视频生成的重点模型。不会选时先按这条规则来：

先试稿：选 seedance-2.0-fast；如果有参考视频，选 seedance-2.0-fast-vision。
正式出片：选 seedance-2.0；如果有参考视频，选 seedance-2.0-vision。
要 1080P：无参考视频选 seedance-2.0-1080；有参考视频选 seedance-2.0-vision-1080。
时长：Seedance 2.0 只支持 4 到 15 秒；3 秒不支持，程序应直接拦截或改成 4 秒。
480P：要生成 480P 必须设置 metadata.resolution: "480p"；不传分辨率时默认按 720P 处理。
本地/人物素材：先调用 POST /v1/api/assets 上传，再把返回的 asset_uri 放进 metadata.reference_images、metadata.reference_videos 或 metadata.reference_audios；不要把本地路径、临时 URL 或需要登录的链接直接传给生成接口。

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

详细看：

Seedance 2.0 视频生成教程：给小白看，讲怎么选模型、怎么填参数。
Seedance 2.0 程序接入文档：给工程师、Codex、Claude Code 看，讲怎么接入项目。

其他视频模型

Seedance 2.0 优先看完后，再按特殊需求考虑下面这些模型：

模型	一句话定位	时长档位	分辨率档位	详细教程
Sora-2 / Sora-2-Pro	叙事感强，适合短镜头试稿	4s / 8s / 12s	720p 横版 / 竖版（pro 多一档 large）	Sora-2 教程
Veo3.1-Fast / Pro	画质细腻，适合需要 4K 的场景	8s 固定	720p / 1080p / 4k	Veo 3.1 教程
Grok-Video	时长更自由，适合 15 秒以上社媒短片	6/10/15/20/25/30s	720p	Grok-Video 教程

异步工作流（三步走）

所有视频模型都是异步任务：你提交完不会立刻拿到视频，要再来取。

第 1 步：POST /video/generations          → 拿到 task_id
第 2 步：GET  /video/generations/{task_id} → 轮询，等 status=completed
第 3 步：GET  /videos/{task_id}/content   → 下载 mp4 文件

实操建议：

提交任务后先睡 10 秒再开始查询，太早查只会看到 queued。
之后每 8–15 秒查一次；总等待 3–5 分钟基本能覆盖大多数任务。
不要看到没完成就重新提交一次，那样会重复扣费。

通用请求体字段

每个模型的可选参数不同，但以下字段是大家共有的：

字段	类型	必填	说明
`model`	string	是	模型 ID，如 `seedance-2.0`、`seedance-2.0-vision`、`sora-2`
`prompt`	string	是	视频描述，主体 + 动作 + 镜头 + 风格
`metadata.reference_images`	string[]	否	Seedance 参考图。先传素材接口，再使用返回的 `asset_uri`
`metadata.reference_videos`	string[]	否	Seedance 参考视频；传这个时要选 `vision` 模型。先传素材接口，再使用返回的 `asset_uri`
`image_urls`	string[]	否	部分其他视频模型使用的图生视频参考图字段
`metadata.duration` / `duration`	int/秒	否	视频时长。Seedance 必须是 4 到 15 秒；3 秒不支持；其他模型看各自教程
`metadata.resolution` / `size` / `quality`	string	否	分辨率档位。Seedance 支持 `480p`、`720p`、`1080p`；不传默认 720P；生成 480P 必须传 `metadata.resolution: "480p"`；只有 1080P 模型可传 `1080p`

通用注意

平台不对外暴露任何 callback_url / webhook_url 参数。结果一律通过查询接口 GET /video/generations/{task_id} 取，老老实实轮询即可。
其他视频模型如使用 image_urls，必须传平台服务器可读取的地址；本地路径、内网地址、需要登录的链接都不行。
Seedance 参考素材必须使用 POST /v1/api/assets 返回的 asset_uri，不要传公网 URL、本地路径、临时 URL 或素材上传响应里的下载 URL。
轮询时不要死循环每秒查一次，否则可能被限速；建议 8–15 秒查一次。
含真人人脸的素材请先确认你有授权，平台对人物素材有合规审查。

通用响应状态码

状态	含义	建议动作
`queued` / `pending`	已收到，排队中	继续等
`in_progress` / `processing`	正在生成	继续等
`completed` / `success`	完成	取视频地址 / 调 content 接口下载
`failed`	生成失败	看 `error` 字段，改 prompt 后重试
`cancelled`	已取消	同上

怎么测试（最小示例）

# 第 1 步：提交任务（本地图片先上传素材接口，拿到 asset_uri 后填入 reference_images）
curl -X POST "https://www.yuzhixiaolongxia.com/v1/video/generations" \
  -H "Authorization: Bearer <YOUR_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 details.",
    "metadata": {
      "reference_images": [
        "asset://dbsd_asset_xxx"
      ],
      "duration": 4,
      "ratio": "16:9",
      "resolution": "480p",
      "generate_audio": false,
      "watermark": false
    }
  }'

# 响应里会有 task_id，假设是 task_abc123

# 第 2 步：查询状态（平台查询接口）
curl "https://www.yuzhixiaolongxia.com/v1/video/generations/task_abc123" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

# 等 status=completed 后

# 第 3 步：下载视频
curl -L "https://www.yuzhixiaolongxia.com/v1/videos/task_abc123/content" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  --output result.mp4

在 Postman 里测

新建 POST 请求，URL 填上面第 1 步的地址（替换好你的域名）。
Headers 加 Authorization: Bearer <你的令牌> 和 Content-Type: application/json。
Body 选 raw → JSON，粘贴上面 -d 里的 JSON。
拿到 task_id 后改成 GET 请求继续查询，直到 status=completed。

常见错误码

HTTP 状态	常见原因	处理方式
`400`	参数非法（分辨率 / 时长不在该模型的允许档位）	对照模型教程的参数表改
`401`	令牌错误 / 令牌分组没开视频权限	检查令牌、换对应的视频分组
`402`	余额不足	充值
`404`	`task_id` 不存在 / 已过期	重新提交任务
`429`	限速	退避 30 秒后重试
`5xx`	服务临时异常	退避后重试，仍失败联系客服

余额查询和计费规则

余额查询：登录控制台，左侧"额度记录"看实时余额和扣费明细。
计费规则一句话：任务生成成功才扣费；失败、取消不扣。Seedance 2.0 按实际 tokens 扣费，文档中用“元/秒”和“15 秒估价”帮你提前估预算；Sora 按秒扣，Veo3.1 按次扣，Grok 按时长段扣。

具体价格以模型广场为准。本平台对客户呈现的售价已是最终价，无需再换算。

接入方式

方式	适合谁	入口
Cherry Studio（图形界面）	小白，想点鼠标就出视频	Cherry Studio 教程
n8n 工作流	想做自动化（提示词 → 生图 → 生视频）的进阶玩家	n8n 教程
直接 API 调用	工程师 / Codex / Claude Code	看下面每个模型的 curl 示例

只有本地图片怎么办

Seedance 先调用 POST /v1/api/assets 上传本地图片，拿到 asset://... 后放进 metadata.reference_images。

下一步

挑你要用的模型，进对应教程：

上一步：绘图模型总览