Muse Video

Muse Video は Meta Superintelligence Labs の動画モデルです。1 回のリクエストで、プロンプトから、またはプロンプトと最大 9 枚の参照画像から、7 種類のアスペクト比のいずれかで約 10 秒・720p の音声付きクリップを生成します。リクエストを送信し、返されたタスク ID を保持して、完成した動画をタスクから読み取ってください。参照画像は URL で渡します。

モデル ID

現在の料金はモデルページをご覧ください。

クイックサンプル

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

レスポンスはタスク（{"id": "task_...", "status": "processing"}）であり、完成した動画ではありません。結果は GET /v1/tasks/{task_id} をポーリングして取得してください。API キーはサーバー側のコードで保持してください。

パラメータ

この一覧にないフィールドはリクエスト転送前に削除され、エラーの原因にも出力の変更にもなりません。開始・終了フレーム、参照動画、参照音声、延長、シード、ネガティブプロンプトの設定はありません。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 はクリップ 1 本あたりの定額料金です：

cost = price per clip × 1

料金に秒数を掛けることはありません。テキストのみのリクエスト、参照画像を使うリクエスト、すべてのアスペクト比で同じ料金です。タスク受理時に確保される金額がそのまま課金額になります。最終的な課金額はアカウントの利用履歴で確認できます。失敗したタスクは課金されません。

出力スキーマ

送信するとタスクが返されます:

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

タスクを取得する

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

status が completed または failed になるまで、10〜20 秒ごとにポーリングしてください。ポーリング中のネットワークタイムアウトは生成の失敗を意味しません。タスク 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"
  }
}

私たちのテストでは、クリップは AAC 音声トラック付きの 10.0 秒の 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 を加えてください。

関連情報

• Muse Video の Playground と料金
• Muse Image API リファレンス
• OpenAPI をダウンロード
• コピー可能な Markdown