视频接入（Seedance）

视频有两种用法：

网页直接做：登录控制台 → 左侧「视频生图工作台」，选型号、写提示词、上传参考素材就能出片，不用配置任何东西。新手推荐用这个，操作见本页末尾。
接口调用：视频是异步任务：先提交，拿到任务编号，再轮询，出片后下载。

生成失败不扣费

提交时会先预扣这一单的费用；生成失败、超时、保存失败都会全额退回，任务里会写明「预扣费用已退回」。

第一步：key 挂在对的视频分组上

一把 key 只能挂一个分组，视频分组有两个，按自己要的价格和功能选：

分组	型号（逐字复制）
【视频】字节 Seedance	`seedance-2.0`、`seedance-2.5`、`seedance-2.0-fast`、`seedance-2.0-mini`
【视频】字节 Seedance 特惠	`seedance-2.0`、`seedance-2.5`

两个分组能用的素材不一样：

功能	【视频】字节 Seedance	【视频】字节 Seedance 特惠
文生视频	支持	支持
参考图	支持	支持
参考音频	支持	支持
首尾帧	支持	支持
参考视频	支持	不支持
Fast / Mini 型号	支持	不支持

特惠分组更便宜。要用参考视频，请用「【视频】字节 Seedance」分组的 key；特惠分组带参考视频提交会提示「暂时不支持参考视频」，不扣费。两个分组都要用，就建两把 key，每个分组一把。哪些型号、哪类素材这把 key 现在能用，以 GET /v1/videos/models 的返回为准。

时长卡、订阅不能做视频

视频按余额计费，订阅类分组调视频会报「订阅分组暂不支持视频生成」。

价格

充值 ¥1 到账 1 余额，下表就是扣的余额。

型号	480p 每秒	720p 每秒	1080p 每秒
`seedance-2.0`	¥0.437	¥0.941	¥2.356
`seedance-2.5`	¥0.637	¥1.435	¥3.553
`seedance-2.0-fast`	¥0.352	¥0.751	不提供
`seedance-2.0-mini`	¥0.219	¥0.466	不提供

特惠分组（【视频】字节 Seedance 特惠）：

型号	480p 每秒	720p 每秒	1080p 每秒
`seedance-2.0`	¥0.37	¥0.69	¥1.38
`seedance-2.5`	¥0.54	¥0.92	¥1.42

举例：seedance-2.0、720p、5 秒 = 0.941 × 5 ≈ ¥4.71。

带参考视频时，计费秒数 = 参考视频总时长 + 输出时长，并且换用「带视频」单价。参考图片、参考音频、首尾帧都不增加计费秒数。
不确定扣多少，先调询价接口（下面第 2 步）。它返回的 hold_amount 就是这一单要扣的钱，不扣费、不建任务。
价格以控制台和询价接口为准。

型号参数

型号	时长（秒）	默认	清晰度	默认	比例	预计出片
`seedance-2.0`	4～15 整数	5	480p / 720p / 1080p	720p	16:9 / 9:16	约 3 分钟
`seedance-2.5`	4～15 整数	5	480p / 720p / 1080p	720p	16:9 / 9:16	约 3 分多钟
`seedance-2.0-fast`	4～15 整数	5	480p / 720p	720p	16:9 / 9:16	约 2 分钟
`seedance-2.0-mini`	4～15 整数	5	480p / 720p	720p	16:9 / 9:16	约 2 分钟

预计时间是平时的参考值，高峰期会更久。特惠分组的时长、清晰度和比例与上表相同，一般 3～7 分钟出片。

接口调用：五步

地址 https://api.jichuanai.com/v1，认证头 Authorization: Bearer sk-你的key。

下面的命令用 Mac / Linux 终端或 Git Bash 运行。Windows 用户请用 Git Bash，不要粘贴到「命令提示符」；不想写代码可以直接用网页工作台。

bash

# 1) 看这把 key 能用哪些型号、清晰度、价格
curl https://api.jichuanai.com/v1/videos/models \
  -H "Authorization: Bearer sk-你的key"

# 2)（可选）询价：不扣费、不建任务，返回 hold_amount
curl https://api.jichuanai.com/v1/videos/quote \
  -H "Authorization: Bearer sk-你的key" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedance-2.0","prompt":"一只橘猫在窗台上看雨","seconds":5,"resolution":"720p","ratio":"16:9"}'

# 3) 提交任务（先预扣），返回里的 id 形如 video_0123…
curl https://api.jichuanai.com/v1/videos \
  -H "Authorization: Bearer sk-你的key" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedance-2.0","prompt":"一只橘猫在窗台上看雨","seconds":5,"resolution":"720p","ratio":"16:9"}'

# 4) 查状态：queued / in_progress 时每 5 秒查一次
curl https://api.jichuanai.com/v1/videos/任务id \
  -H "Authorization: Bearer sk-你的key"

# 5) status 变成 completed 后下载（会跳转到视频文件，要加 -L）
curl -L -o result.mp4 https://api.jichuanai.com/v1/videos/任务id/content \
  -H "Authorization: Bearer sk-你的key"

请求字段

字段	说明
`model`	必填，上表型号
`prompt`	必填，不超过 2000 字
`seconds`	整数秒，4～15。写 `4.5` 会报错
`resolution`	`480p` / `720p` / `1080p`
`ratio`	`16:9` 或 `9:16`，不传默认 16:9
`references`	参考素材：`{"images": […], "videos": […], "audios": […]}`，每一项可以是链接、base64 或上传编号，见下一节
`first_frame` / `last_frame`	首帧 / 尾帧图片：链接、base64 或上传编号

提示词里写 --dur 12、--rs 1080p 这类参数不起作用，以请求字段为准。

状态和保存时间

`status`	意思
`queued`	排队中
`in_progress`	生成中，`progress` 是进度
`completed`	完成，`video_url` 是视频地址，`charged_amount` 是最终扣费（等于提交时预扣的金额）
`failed`	失败，`error` 写了原因，预扣已退回（`refunded: true`）。少数情况下会先显示「预扣费用将自动退回」，稍后到账

提交后 45 分钟还没出片，自动判失败并全额退回。
成片和任务记录只保留 3 天，完成后请及时下载。
任务只能用提交它的那把 key 查。
同一个账号同时进行中的视频任务上限 4 个，前面的完成了再提交。
GET /v1/videos?limit=20 列出这把 key 近 3 天的任务。

参考素材

参考素材有三种给法，效果一样，选顺手的：

给法	适合	怎么写
A. 直接放链接	素材已经在网上（图床、对象存储），或用 OpenClaw 这类 AI 助手调用	在提交里填 `https://…` 链接
B. 直接放 base64	文件在本地、不大（图片）	填 `data:image/png;base64,…`
C. 先上传拿编号	文件大（视频）、同一个素材要用很多次	先 `POST /v1/videos/uploads` 拿 `vref_…`，再填编号

提示词里用 @图片1、@视频1、@音频1 指代参考素材（按同类素材在请求里的顺序编号）。

A / B：直接放进提交请求

bash

curl https://api.jichuanai.com/v1/videos \
  -H "Authorization: Bearer sk-你的key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "prompt": "让 @图片1 里的小猫在 @图片2 的草地上奔跑",
    "seconds": 5,
    "resolution": "720p",
    "references": {
      "images": ["https://example.com/cat.png", "data:image/jpeg;base64,/9j/4AAQ…"]
    }
  }'

首尾帧（视频从 first_frame 这张图开始，停在 last_frame 这张图）：

json

{
  "model": "seedance-2.0",
  "prompt": "镜头慢慢推近",
  "seconds": 5,
  "resolution": "720p",
  "first_frame": "https://example.com/start.png",
  "last_frame": "https://example.com/end.png"
}

链接必须公开可访问：不用登录、不是内网地址、只用 80 / 443 端口（普通的 http://、https:// 链接都是）。一次提交里所有链接合计要在 25 秒内下载完。下载失败会提示是第几个素材、对方返回了什么，不扣费。
整个请求体不超过 32 MB，请求体不要用 gzip 压缩。base64 适合图片；视频超过 20 MB 请用链接或给法 C。
每次提交都会把素材重新存一份（保留 3 天），计入每天 300 个的上传次数。同一个素材要反复用，给法 C 更省事。
询价接口 /v1/videos/quote 也能写链接和 base64，只算价不存素材；带参考视频的询价要用给法 C 的编号（价格按视频时长算），直接提交则没有这个限制。
素材格式、大小、时长要求和给法 C 完全一样（见下方「文件要求」）。

C：先上传，拿编号

bash

curl https://api.jichuanai.com/v1/videos/uploads \
  -H "Authorization: Bearer sk-你的key" \
  -F kind=image -F file=@cat.png
# 返回 "id": "vref_…"

kind 填 image、video 或 audio，一次传一个文件。上传不收费。提交时把编号填进 references 或 first_frame / last_frame：

json

{
  "model": "seedance-2.5",
  "prompt": "让 @图片1 里的小猫跟着 @视频1 的动作跳舞",
  "seconds": 8,
  "resolution": "720p",
  "references": { "images": ["vref_…"], "videos": ["vref_…"] }
}

其它接口的写法也认

照着别家视频接口写的请求，常见字段可以直接用，网关会自动换算：

你写的字段	当作
`image` / `image_url` / `input_reference` / `input_image`（只放一张）	首帧
`first_frame_image` / `last_frame_image`	首帧 / 尾帧
`images` / `image_urls` / `reference_images` / `input_images`（数组）	参考图片
`video` / `videos` / `video_url` / `reference_videos`	参考视频
`audio` / `audios` / `audio_url` / `reference_audios`	参考音频
字节方舟 `content` 数组（`text` + `image_url` / `video_url` / `audio_url`，可带 `role`）	按 `role` 对应首帧、尾帧或参考素材；没写 `role` 且只有一张图时当首帧；`text` 当提示词
`multipart/form-data` 里上面这些字段名的文件	同上；多张参考图用 `images[]` 字段重复传

每一项可以是字符串（链接、data: base64、vref_ 编号），也可以是 {"url": "…"} 这样的对象。不认识的素材字段会直接报错并告诉你该用哪个字段，不会被悄悄忽略。同一类素材请只用一个字段写（比如图片都放进 references.images），@图片1、@图片2 就按这个数组的顺序对应。

在 OpenClaw 等 AI 助手里用

OpenClaw 自带的 video_generate 工具不能直接连我们的接口，请让助手自己发 HTTP 请求。把下面这段发给助手即可：

text

用济川视频接口生成视频：
- 提交：POST https://api.jichuanai.com/v1/videos ，请求头 Authorization: Bearer <我的key>、Content-Type: application/json
- 请求体：{"model":"seedance-2.0","prompt":"…","seconds":5,"resolution":"720p","ratio":"16:9",
  "references":{"images":["图片链接或 data:image/png;base64,…"]}}
  只要首帧时改用 "first_frame":"图片链接"，首尾帧再加 "last_frame"
- 返回的 id 形如 video_…；每 5 秒 GET https://api.jichuanai.com/v1/videos/<id> 查 status
- status 为 completed 后，GET https://api.jichuanai.com/v1/videos/<id>/content 下载（跟随跳转）
- 只有上面这几个地址，不要猜其他地址

数量上限

项	2.0 / 2.0-fast / 2.0-mini	2.5
参考图片	9 张	30 张
参考视频	3 段	10 段
参考音频	3 段	10 段
三类合计	12 个	50 个
每段视频 / 音频时长	2～15 秒	2～30 秒
参考视频合计	不超过 15 秒	不超过 30 秒
参考音频合计	不超过 15 秒	不超过 30 秒

特惠分组不支持参考视频，参考图、参考音频的上限同上。

文件要求

类别	格式	单个大小	其他
图片	JPG / PNG / WebP	10 MB 以内	宽高在 300～6000 像素之间
视频	MP4 / MOV（H.264 / H.265）	50 MB 以内	不超过 1080p
音频	WAV / MP3（M4A、AAC 先转格式）	15 MB 以内	—

首尾帧：first_frame 填图片编号，视频从这张图开始；last_frame 可选，必须和首帧一起用。首尾帧和 references 不能同时用。
真人照片暂不支持，AI 生成的写实人脸也会被当成真人拒绝，拒绝不扣费。卡通、动物、虚拟角色可以正常用。请只上传你有权使用的素材。
素材上传后保留 3 天，过期要重新上传。

常见报错

报错里看到	原因	怎么改
`这个分组不支持 …`	型号不在这把 key 的分组里	按「第一步」换对应分组的 key
`这个分组不支持视频生成` / `Videos API is not supported for this platform`	用了聊天分组的 key	换视频分组的 key
`This model is only available on the Videos endpoint (/v1/videos)`	视频型号放进了聊天接口	改用 `POST /v1/videos`
`秒数需在 4～15 之间` / `seconds 必须是整数`	时长不对	改成 4～15 的整数
`可选清晰度：…` / `这个分组不提供该清晰度`	清晰度不对	按提示改
`可选比例：16:9 / 9:16`	比例不对	改成 16:9 或 9:16
`余额不足，无法预扣本次视频费用`	余额不够这一单	充值后重试
`这把密钥的剩余额度不够预扣本次视频费用`	你给这把 key 设的额度上限不够	到「API 密钥」调高额度或换 key
`同时进行中的视频任务已达上限…`	已有 4 个在跑	等前面的完成再提交
`同时上传的文件太多，请稍等再传`	并发上传太多	等几秒再传，一个一个传
`订阅分组暂不支持视频生成`	用了时长卡 / 订阅分组	换视频分组的 key，用余额
`不认识的素材字段 …`	素材放在了不认识的字段里	按提示改成 `images` / `first_frame` / `last_frame` / `videos` / `audios`
`第 N 个素材（…）：下载失败…`	链接打不开、要登录、或是内网地址	换成能公开访问的链接，或改用 base64 / 先上传
`第 N 个素材（…）：下载超时…`	链接太慢或文件太大	先用 `/v1/videos/uploads` 上传，再填编号
`素材处理用时太长，本次未扣费`	下载素材加排队太久	直接重试；大文件先上传拿编号
`请求体太大：压缩上传的请求…`	请求体用了 gzip 压缩	去掉压缩再发
`这个分组的 … 暂时不支持参考视频`	用了特惠分组的 key（特惠不支持参考视频），或线路临时维护	换「【视频】字节 Seedance」分组的 key，或去掉参考视频
`… 格式不对：请填图片 / 视频 / 音频的 http(s) 链接…`	素材写成了文件名或其他内容	填链接、`data:…;base64,…` 或 `vref_` 编号
`参考素材里疑似有真人照片…本次未扣费`	素材被判为真人	换成卡通、动物或虚拟角色
`参考素材已过期或快过期（只保留 3 天）`	素材超过 3 天，或离过期不到 2 小时	重新上传
`参考素材没有通过审核…预扣费用已退回`	生成过程中素材被判为真人或敏感内容	换成卡通、动物或虚拟角色
`首尾帧和参考素材不能同时使用`	两种方式混用了	二选一
`找不到这个视频任务`	任务编号不对、换了 key 查，或已超过 3 天	用提交时那把 key 查
`视频还没生成好`	还没完成就去下载	等 `status` 变成 `completed`
任务 `failed`，写「预扣费用已退回」	这次没生成成功	已退款，可以直接重试

接口返回 4xx / 5xx 的提交都没有扣费（或预扣已退回）。

在网页上做：视频生图工作台

登录控制台，点左侧「视频生图工作台」。第一次进来会列出可开通的分组和价格，勾选后点「开通并开始作图」，会自动为每个分组建一把「作图专用」key。可以给 key 设一个额度上限，防止花超。
先充值，顶栏能看到可用余额。
在型号下拉框里选型号，再选比例、清晰度（按钮上写着每秒价）和时长。
需要参考素材时，在「参考素材」面板添加图片、视频或音频（也可以拖进去，或 Ctrl+V 粘贴），点缩略图下的「@图片1」把它插进提示词。也可以切到「首尾帧」模式。
点「生成视频 · 预扣 ¥x」。等待时可以先离开，回来会接着查。
出片后点「下载」保存。视频只保留 3 天，记得及时下载。

视频接入（Seedance） ​

第一步：key 挂在对的视频分组上 ​

价格 ​

型号参数 ​

接口调用：五步 ​

请求字段 ​

状态和保存时间 ​

参考素材 ​

A / B：直接放进提交请求 ​

C：先上传，拿编号 ​

其它接口的写法也认 ​

在 OpenClaw 等 AI 助手里用 ​

常见报错 ​

在网页上做：视频生图工作台 ​

视频接入（Seedance）

第一步：key 挂在对的视频分组上

价格

型号参数

接口调用：五步

请求字段

状态和保存时间

参考素材

A / B：直接放进提交请求

C：先上传，拿编号

其它接口的写法也认

在 OpenClaw 等 AI 助手里用

常见报错

在网页上做：视频生图工作台