视频 · POST /api/videos
填入你的 API Key本站所有示例里的
$MUSEAV_API_KEY 会就地换成它只存在你自己浏览器的 localStorage 里,不会发给任何人——本站是纯静态页面,没有后端可发。 共用电脑上看完记得点「清除」。
提交一个视频任务
bash
curl -X POST https://manager.museav.top/api/videos \
-H "X-API-Key: $MUSEAV_API_KEY" -H "Content-Type: application/json" \
-d '{"prompt":"电影感横版镜头,产品缓慢推进","ratio":"16:9","duration":5}'其余操作:
| 做什么 | 怎么调 |
|---|---|
| 查单个 | GET /api/videos?id=<任务ID> |
| 查列表 | GET /api/videos?page_num=1&page_size=20&filter.status=running |
| 取消或删除 | DELETE /api/videos?id=<任务ID> |
选档次
model 可以不传,走当前默认档次。要指定就用下面这些值:
档次代号(model 传这个) | 名称 | 时长范围 | 分辨率 |
|---|---|---|---|
artsdance-2-0-pro-260801 | Seedance 2.0 | 4–15 秒 | 480p |
artsdance-2-0-fast-260801 | Seedance 2.0 Fast | 4–15 秒 | 480p / 720p |
artsdance-2-0-mini-260801 | Seedance 2.0 Mini | 4–15 秒 | 480p / 720p |
artsdance-2-5-pro-260801 | Seedance 2.5 | 4–30 秒 | 720p / 1080p |
本表由中台 /api/doc-contracts 在文档构建时下发,真源 shared/upstream-catalog.js—— 不是手抄的,中台改了下次构建自动跟上。
时长超出范围会在提交时就被拒
不会让你白等上游。每档的上下限不一样 —— 2.0 系列封顶 15 秒,2.5 能到 30 秒。
拿不准就别传 model,让系统按你的 duration 和分辨率自动挑一档能满足的。
参考素材
都传公网直链(走 /api/upload-ref 拿),可以组合:
| 字段 | 传几张 | 效果 |
|---|---|---|
images | 1 张 | 当首帧 |
images | 2 张 | 首帧 + 尾帧 |
images | 多张(最多 9) | 外观参考 |
videos | — | 控制镜头运动 / 运镜轨迹 |
audios | — | 对齐节奏 / 口型 / 配乐氛围 |
generate_audio | true | 让模型自己生成声音 |
audios 和 generate_audio 是两件事
audios 是「按我给的这段来」,generate_audio 是「你自己配一个」。
例:带首帧图和背景音乐
bash
curl -X POST https://manager.museav.top/api/videos \
-H "X-API-Key: $MUSEAV_API_KEY" -H "Content-Type: application/json" \
-d '{
"prompt": "…",
"images": ["https://.../first-frame.jpg"],
"audios": ["https://.../bgm.mp3"]
}'用视频模板
模板把 prompt 里的填空位留给你,见模板库:
bash
curl -X POST https://manager.museav.top/api/videos \
-H "X-API-Key: $MUSEAV_API_KEY" -H "Content-Type: application/json" \
-d '{"template_id":"<视频模板id>","input":{"subject":"猫砂包装袋"}}'视频模板在独立的表里(跟图片/文案模板不是同一张), 列表接口是 GET /api/video-templates,字段标准见模板字段标准。
相关
- 出图
/api/generate - 素材上传
/api/upload-ref—— 首帧图、BGM 怎么传 - 网页上出视频 —— 不想写代码的话