Skip to content

视频 · 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-260801Seedance 2.04–15 秒480p
artsdance-2-0-fast-260801Seedance 2.0 Fast4–15 秒480p / 720p
artsdance-2-0-mini-260801Seedance 2.0 Mini4–15 秒480p / 720p
artsdance-2-5-pro-260801Seedance 2.54–30 秒720p / 1080p

本表由中台 /api/doc-contracts 在文档构建时下发,真源 shared/upstream-catalog.js—— 不是手抄的,中台改了下次构建自动跟上。

时长超出范围会在提交时就被拒

不会让你白等上游。每档的上下限不一样 —— 2.0 系列封顶 15 秒,2.5 能到 30 秒。

拿不准就别传 model,让系统按你的 duration 和分辨率自动挑一档能满足的。

参考素材

都传公网直链(走 /api/upload-ref 拿),可以组合:

字段传几张效果
images1 张当首帧
images2 张首帧 + 尾帧
images多张(最多 9)外观参考
videos控制镜头运动 / 运镜轨迹
audios对齐节奏 / 口型 / 配乐氛围
generate_audiotrue让模型自己生成声音

audiosgenerate_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,字段标准见模板字段标准

相关