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 金鑰保存在伺服器端程式碼中。

參數

欄位	類型	預設值	說明
`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 秒、附 AAC 音軌的 MP4（H.264）檔案：16:9 為 1280 × 720，9:16 為 720 × 1280，使用 16:9 寬高比的參考圖時為 1248 × 704，從提交到完成約 100–200 秒。

錯誤

在任務建立之前就被拒絕的請求，會回傳 HTTP 錯誤狀態碼和一個 error 物件，且不收費。受理之後才失敗的任務，在查詢時回傳 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，避免出現憑空編造的字幕。