Muse Video

Muse Video Clips mit 10 Sekunden, 720p und Ton aus einem Prompt oder bis zu 9 Referenzbildern in sieben Seitenverhältnissen erzeugen, pro Clip bezahlt und als Aufgabe geliefert.

Muse Video ist das Videomodell von Meta Superintelligence Labs. Eine Anfrage erstellt einen etwa 10 Sekunden langen Clip in 720p mit Ton aus einem Prompt oder einem Prompt mit bis zu 9 Referenzbildern in einem von sieben Seitenverhältnissen. Sende die Anfrage, behalte die zurückgegebene Aufgaben-ID und lies das fertige Video aus der Aufgabe aus. Referenzbilder werden als URLs übergeben.

Modell-IDs

Modell-ID	Eingaben	Auflösung	Länge
`muse-video`	Text, 0–9 Bilder	`720p`	etwa 10 Sekunden, mit Ton

Aktuelle Preise findest du auf der Modellseite.

Kurzbeispiel

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

Endpunkt

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

Header	Wert
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

Die Antwort ist eine Aufgabe ({"id": "task_...", "status": "processing"}), nicht das fertige Video. Frage GET /v1/tasks/{task_id} für das Ergebnis ab. Bewahre API-Schlüssel im serverseitigen Code auf.

Parameter

Feld	Typ	Standard	Hinweise
`model`	String	erforderlich	`muse-video`
`prompt`	String	erforderlich	Darf nach Entfernen äußerer Leerzeichen nicht leer sein. Auch mit Referenzen erforderlich.
`image_urls`	URL-Liste	keine	0–9 öffentliche Bild-URLs, insgesamt 11 MB. Ohne sie ist die Anfrage Text zu Video.
`aspect_ratio`	Enum	auto	`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2` oder `2:3`. Für auto weglassen: Referenzen bestimmen das Format; reiner Text ergibt `16:9`. Sende nicht `"auto"`.
`size`	Enum	keine	Kompatibilitätsalias von `aspect_ratio`: eines der obigen Verhältnisse oder `auto`. Sind beide gültig, hat `aspect_ratio` Vorrang.
`duration`	Ganzzahl oder String	`10`	Nur `10`, `"10"` oder `"10s"`. Der Clip dauert etwa 10 Sekunden.
`resolution`	Enum	`720p`	Nur `720p`.
`audio`	Boolean	`true`	Nur `true`; jeder Clip hat Ton. `false` wird abgelehnt.
`n`	Ganzzahl	`1`	Nur `1`. Jede Anfrage liefert einen Clip.

Felder außerhalb dieser Liste werden vor dem Weiterleiten der Anfrage entfernt; sie verursachen nie einen Fehler und verändern die Ausgabe nicht. Es gibt keine Einstellungen für ersten oder letzten Frame, Referenzvideo, Referenzton, Verlängerung, Seed oder negativen Prompt. callback_url ist nicht verfügbar; frage stattdessen die Aufgabe ab.

Referenzbilder

Übergib bis zu 9 Bilder in image_urls und beschreibe die Bewegung in prompt. Muse Video nutzt sie als Referenzen: Der Clip bleibt nah daran, aber der erste Frame ist keine pixelgenaue Kopie. Ohne aspect_ratio folgt der Clip ihrem 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"]
}

Medieneingaben

Jede Referenz ist eine öffentliche HTTP(S)-URL. Base64-Daten-URIs werden nicht akzeptiert: Lade die Datei in deinen eigenen Speicher hoch und übergib ihre URL. Verwende PNG-, JPEG- oder WebP-Bilder; alle Originaldateien zusammen dürfen höchstens 11 MB groß sein. Eine größere Sammlung schlägt nach der Annahme fehl und wird nicht berechnet.

Preisdimensionen

Aktuelle Tarife findest du im Preisabschnitt des Modells. Muse Video hat einen Preis pro Clip:

cost = price per clip × 1

Der Preis wird nicht mit Sekunden multipliziert. Reine Textanfragen und Referenzanfragen sowie jedes Seitenverhältnis kosten gleich viel. Der bei Annahme der Aufgabe reservierte Betrag wird auch berechnet. Endgültige Kosten findest du im Nutzungsverlauf deines Kontos. Fehlgeschlagene Aufgaben werden nicht berechnet.

Ausgabeschema

Das Absenden liefert die Aufgabe:

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

Aufgabe abrufen

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

Frage alle 10–20 Sekunden ab, bis status den Wert completed oder failed hat. Eine Zeitüberschreitung des Netzwerks während der Abfrage bedeutet nicht, dass die Erzeugung fehlgeschlagen ist: Behalte die Aufgaben-ID und setze die Prüfung fort. Erstelle keine weitere Aufgabe, um den Fortschritt zu prüfen.

Abgeschlossene Aufgabe

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

In unseren Tests kamen die Clips als 10,0 Sekunden lange MP4-Dateien (H.264) mit AAC-Audiospur zurück: 1280 × 720 für 16:9, 720 × 1280 für 9:16 und 1248 × 704 für eine Referenz im Format 16:9, etwa 100–200 Sekunden nach dem Absenden.

Fehler

Anfragen, die vor der Erstellung einer Aufgabe abgelehnt werden, geben einen HTTP-Fehler mit einem error-Objekt zurück und werden nicht berechnet. Eine Aufgabe, die nach der Annahme fehlschlägt, gibt bei der Abfrage HTTP 200 zurück, zusammen mit status: "failed" und einem error-Objekt.

Codes, HTTP-Status und Hinweise zu Wiederholungen findest du im gemeinsamen Fehlerkatalog.

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

Kommt es beim Senden selbst zu einer Zeitüberschreitung, prüfe deine Aufgaben, bevor du erneut sendest: Die erste Anfrage wurde möglicherweise bereits angenommen.

Tipps

Beschreibe Motiv, Handlung, Kamerabewegung und Licht und nenne die gewünschten Geräusche; der Ton wird zusammen mit dem Bild erzeugt.
Erstelle ein Standbild mit Muse Image und übergib dann seine URL hier, um es in Bewegung zu setzen.
Sende für Videos im Hochformat aspect_ratio: "9:16" oder eine Referenz im Hochformat.
Füge no text hinzu, um erfundene Untertitel fernzuhalten.