Muse Video

使用提示词或最多 9 张参考图生成带声音的 10 秒 720p Muse Video 视频，支持七种宽高比，按段计费，通过任务交付。

Muse Video 是 Meta Superintelligence Labs 的视频模型。每次请求根据提示词，或提示词加最多 9 张参考图，生成一段约 10 秒、720p 且带声音的视频，可选七种宽高比。发送请求后，保留返回的任务 ID，再从任务中读取完成的视频。参考图以 URL 形式传入。

模型 ID

模型 ID	输入	分辨率	时长
`muse-video`	文本、0–9 张图片	`720p`	约 10 秒，带声音

当前价格见模型页面。

快速示例

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "muse-video",
    "prompt": "Waves rolling onto a sandy beach at sunset, slow camera pan, natural ocean sound. No text.",
    "aspect_ratio": "16:9"
  }'

端点

POST https://api.seedrouter.ai/v1/videos/generations

请求头	值
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

响应返回的是任务（{"id": "task_...", "status": "processing"}），而非完成的视频。轮询 GET /v1/tasks/{task_id} 获取结果。请将 API Key 保存在服务端代码中。

参数

字段	类型	默认值	说明
`model`	字符串	必填	`muse-video`
`prompt`	字符串	必填	去除首尾空白后不能为空。使用参考图时也必填。
`image_urls`	URL 列表	无	0–9 个公开的图片 URL，总大小 11 MB。不传时为文生视频。
`aspect_ratio`	枚举	auto	`1:1`、`16:9`、`9:16`、`4:3`、`3:4`、`3:2` 或 `2:3`。省略时自动选择：有参考图时沿用其画幅；纯文本时为 `16:9`。不要传入 `"auto"`。
`size`	枚举	无	`aspect_ratio` 的兼容别名：接受上述比例之一或 `auto`。两者均有效时，以 `aspect_ratio` 为准。
`duration`	整数或字符串	`10`	仅限 `10`、`"10"` 或 `"10s"`。视频时长约 10 秒。
`resolution`	枚举	`720p`	仅限 `720p`。
`audio`	布尔值	`true`	仅限 `true`；每段视频均带声音。不接受 `false`。
`n`	整数	`1`	仅限 `1`。每次请求返回一段视频。

此列表之外的字段会在转发请求前被丢弃，不会导致错误，也不会改变输出。不提供首帧、尾帧、参考视频、参考音频、视频延长、种子或负面提示词设置。不支持 callback_url，请改为轮询任务。

参考图

通过 image_urls 传入最多 9 张图片，并在 prompt 中描述动作。Muse Video 将其作为参考：视频会接近参考图，但首帧并非逐像素复制。省略 aspect_ratio 时，视频沿用参考图的画幅。

{
  "model": "muse-video",
  "prompt": "The fox slowly lifts its head, wind moving through its fur, the camera pushing in gently, soft forest ambience.",
  "image_urls": ["https://example.com/fox.png"]
}

媒体输入

每张参考图均使用公开的 HTTP(S) URL。不接受 Base64 data URI：请将文件上传到自己的存储空间，并传入其 URL。使用 PNG、JPEG 或 WebP 图片；所有参考图的原始文件总大小不得超过 11 MB。超过此限制的任务会在受理后失败，不收费。

计费维度

当前费率见模型价格区块。Muse Video 按段统一定价：

cost = price per clip × 1

价格不乘以秒数。纯文本请求、参考图请求以及所有宽高比的价格相同。任务受理时预留的金额即为扣费金额。最终费用可在账户用量记录中查看。失败的任务不收费。

输出结构

提交后返回任务：

{"id": "task_...", "model": "muse-video", "status": "processing", "created_at": 1789689600}

查询任务

GET https://api.seedrouter.ai/v1/tasks/{task_id}

每隔 10–20 秒轮询一次，直到 status 为 completed 或 failed。轮询时发生网络超时并不表示生成失败：保留任务 ID，继续查询。不要为了查看进度而创建新任务。

已完成的任务

{
  "id": "task_...",
  "model": "muse-video",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689790,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

我们的测试中，返回的视频均为 10.0 秒的 MP4（H.264）文件，并带有 AAC 音轨：16:9 为 1280 × 720，9:16 为 720 × 1280，使用 16:9 画幅参考图时为 1248 × 704，提交后约 100–200 秒完成。

错误

任务创建前被拒绝的请求会返回带有 error 对象的 HTTP 错误，不收费。任务受理后若失败，查询时仍返回 HTTP 200，并包含 status: "failed" 和 error 对象。

错误码、HTTP 状态及重试建议见公共错误目录。

{
  "id": "task_...",
  "model": "muse-video",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

如果提交本身超时，请先查询任务，再决定是否重新提交：第一次请求可能已经受理。

使用提示

描述主体、动作、镜头运动和光线，并写明需要的声音；音频会与画面一同生成。
先用 Muse Image 生成静态图片，再将其 URL 传到这里，让图片动起来。
生成竖屏视频时，传入 aspect_ratio: "9:16"，或使用竖向参考图。
加入 no text，避免生成虚构字幕。