Muse Video

Muse Video est le modèle vidéo de Meta Superintelligence Labs. Une requête crée un clip d’environ 10 secondes en 720p avec son, à partir d’un prompt ou d’un prompt et de 9 images de référence au maximum, dans l’un des sept formats d’image. Envoyez la requête, conservez l’identifiant de tâche renvoyé et récupérez la vidéo terminée dans la tâche. Les images de référence sont transmises sous forme d’URL.

ID de modèle

Consultez la page du modèle pour les prix actuels.

Exemple rapide

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"
  }'

Point de terminaison

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

La réponse est une tâche ({"id": "task_...", "status": "processing"}), pas la vidéo terminée. Interrogez GET /v1/tasks/{task_id} pour obtenir le résultat. Gardez les clés API dans le code côté serveur.

Paramètres

Les champs ne figurant pas dans cette liste sont supprimés avant la transmission de la requête ; ils ne provoquent jamais d’erreur et ne modifient jamais la sortie. Aucun réglage de première ou dernière image, de vidéo de référence, d’audio de référence, de prolongement, de seed ou de prompt négatif n’est proposé. callback_url n’est pas disponible ; interrogez plutôt la tâche.

Images de référence

Passez jusqu’à 9 images dans image_urls et décrivez le mouvement dans prompt. Muse Video les utilise comme références : le clip leur reste fidèle, mais sa première image n’est pas une copie pixel par pixel. Si aspect_ratio est omis, le clip reprend leur format.

{
  "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"]
}

Entrées média

Chaque référence est une URL HTTP(S) publique. Les data URI en base64 ne sont pas acceptées : téléversez le fichier sur votre propre stockage et transmettez son URL. Utilisez des images PNG, JPEG ou WebP ; les fichiers originaux de toutes les références doivent totaliser 11 Mo ou moins. Un ensemble dépassant cette limite échoue après acceptation et n’est pas facturé.

Facteurs de coût

Consultez la section tarifs du modèle pour les tarifs actuels. Muse Video a un prix unique par clip :

cost = price per clip × 1

Le prix n’est pas multiplié par le nombre de secondes. Les requêtes avec texte seul ou avec références et tous les formats d’image coûtent le même prix. Le montant réservé à l’acceptation de la tâche est le montant facturé. Consultez les frais définitifs dans l’historique d’utilisation de votre compte. Les tâches échouées ne sont pas facturées.

Schéma de sortie

L’envoi renvoie la tâche :

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

Récupérer la tâche

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

Interrogez toutes les 10 à 20 secondes jusqu’à ce que status vaille completed ou failed. Un dépassement de délai réseau pendant l’interrogation ne signifie pas que la génération a échoué : conservez l’identifiant de tâche et reprenez la vérification. Ne créez pas une autre tâche pour vérifier l’avancement.

Tâche terminée

{
  "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"
  }
}

Lors de nos tests, les clips sont revenus sous forme de fichiers MP4 (H.264) de 10,0 secondes avec une piste audio AAC : 1280 × 720 pour 16:9, 720 × 1280 pour 9:16 et 1248 × 704 pour une référence au format 16:9, environ 100 à 200 secondes après l’envoi.

Erreurs

Les requêtes rejetées avant la création d’une tâche renvoient une erreur HTTP avec un objet error et ne sont pas facturées. Une tâche qui échoue après acceptation renvoie HTTP 200 lorsqu’on l’interroge, avec status: "failed" et un objet error.

Voir le catalogue d’erreurs commun pour les codes, les statuts HTTP et les conseils de reprise.

{
  "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."
  }
}

Si l’envoi lui-même dépasse le délai, vérifiez vos tâches avant de renvoyer : la première requête a peut-être été acceptée.

Conseils

• Décrivez le sujet, l’action, le mouvement de caméra et la lumière, et précisez les sons souhaités ; le son est généré en même temps que l’image.
• Créez une image fixe avec Muse Image, puis transmettez son URL ici pour l’animer.
• Pour une vidéo verticale, envoyez aspect_ratio: "9:16" ou une référence en portrait.
• Ajoutez no text pour éviter les légendes inventées.

Ressources liées

• Playground et tarifs de Muse Video
• Référence de l’API Muse Image
• Télécharger l’OpenAPI
• Markdown copiable