Muse Video

Generuj klipy Muse Video z dźwiękiem, 10 sekund w 720p, z promptu lub do 9 obrazów referencyjnych w siedmiu proporcjach, rozliczane za klip i dostarczane przez zadanie.

Muse Video to model wideo od Meta Superintelligence Labs. Jedno żądanie tworzy klip o długości około 10 sekund w 720p z dźwiękiem, z promptu lub promptu z maksymalnie 9 obrazami referencyjnymi, w jednych z siedmiu proporcji obrazu. Wyślij żądanie, zachowaj zwrócony identyfikator zadania i odczytaj gotowe wideo z tego zadania. Obrazy referencyjne przekazujesz jako adresy URL.

ID modeli

ID modelu	Dane wejściowe	Rozdzielczość	Długość
`muse-video`	tekst, 0–9 obrazów	`720p`	około 10 sekund, z dźwiękiem

Aktualne ceny znajdziesz na stronie modelu.

Krótki przykład

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

Punkt końcowy

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

Nagłówek	Wartość
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

Odpowiedź to zadanie ({"id": "task_...", "status": "processing"}), a nie gotowe wideo. Wynik odczytasz, odpytując GET /v1/tasks/{task_id}. Klucze API trzymaj w kodzie po stronie serwera.

Parametry

Pole	Typ	Domyślnie	Uwagi
`model`	string	wymagane	`muse-video`
`prompt`	string	wymagane	Nie może być pusty po usunięciu białych znaków z początku i końca. Wymagany także z obrazami referencyjnymi.
`image_urls`	lista adresów URL	brak	0–9 publicznych adresów URL obrazów, łącznie 11 MB. Bez nich żądanie działa w trybie tekst na wideo.
`aspect_ratio`	enum	auto	`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2` lub `2:3`. Pomiń dla auto: obrazy referencyjne wyznaczają format; sam tekst daje `16:9`. Nie wysyłaj `"auto"`.
`size`	enum	brak	Alias zgodności dla `aspect_ratio`: jedne z powyższych proporcji lub `auto`. Gdy oba pola są poprawne, pierwszeństwo ma `aspect_ratio`.
`duration`	integer lub string	`10`	Tylko `10`, `"10"` lub `"10s"`. Klip trwa około 10 sekund.
`resolution`	enum	`720p`	Tylko `720p`.
`audio`	boolean	`true`	Tylko `true`; każdy klip ma dźwięk. `false` jest odrzucane.
`n`	integer	`1`	Tylko `1`. Każde żądanie zwraca jeden klip.

Pola spoza tej listy są usuwane przed przekazaniem żądania dalej; nigdy nie powodują błędu ani nie zmieniają wyniku. Nie ma ustawień pierwszej lub ostatniej klatki, referencyjnego wideo, referencyjnego dźwięku, wydłużania, ziarna losowego ani negatywnego promptu. callback_url nie jest dostępne; zamiast tego odpytuj zadanie.

Obrazy referencyjne

Przekaż do 9 obrazów w image_urls i opisz ruch w prompt. Muse Video używa ich jako obrazów referencyjnych: klip pozostaje do nich podobny, ale pierwsza klatka nie jest kopią piksel w piksel. Po pominięciu aspect_ratio klip przejmuje ich 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"]
}

Dane wejściowe multimediów

Każdy obraz referencyjny to publiczny adres URL HTTP(S). Dane base64 (data URI) nie są przyjmowane: prześlij plik do własnego magazynu i przekaż jego adres URL. Użyj obrazów PNG, JPEG lub WebP; oryginalne pliki wszystkich obrazów referencyjnych muszą mieć łącznie najwyżej 11 MB. Zestaw przekraczający limit kończy się niepowodzeniem po przyjęciu i nie jest naliczany.

Czynniki wpływające na koszt

Aktualne stawki znajdziesz w sekcji cen modelu. Muse Video ma jedną cenę za klip:

cost = price per clip × 1

Ceny nie mnoży się przez sekundy. Żądania z samym tekstem i z obrazami referencyjnymi oraz każde proporcje obrazu kosztują tyle samo. Kwota zarezerwowana przy przyjęciu zadania jest kwotą naliczoną. Ostateczne opłaty zobaczysz w historii zużycia swojego konta. Nieudane zadania nie są naliczane.

Schemat odpowiedzi

Wysłanie zwraca zadanie:

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

Pobieranie zadania

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

Odpytuj co 10–20 sekund, aż status przyjmie wartość completed lub failed. Przekroczenie limitu czasu sieci podczas odpytywania nie oznacza, że generowanie się nie powiodło: zachowaj identyfikator zadania i wznów sprawdzanie. Nie twórz kolejnego zadania, aby sprawdzić postęp.

Zadanie zakończone

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

W naszych testach klipy wracały jako 10,0-sekundowe pliki MP4 (H.264) ze ścieżką audio AAC: 1280 × 720 dla 16:9, 720 × 1280 dla 9:16 i 1248 × 704 dla obrazu referencyjnego o proporcjach 16:9, około 100–200 sekund po wysłaniu.

Błędy

Żądania odrzucone przed utworzeniem zadania zwracają błąd HTTP wraz z obiektem error i nie są naliczane. Zadanie, które zawiodło po przyjęciu, przy odpytaniu zwraca HTTP 200 z status: "failed" i obiektem error.

Kody, statusy HTTP i wskazówki dotyczące ponawiania znajdziesz we wspólnym katalogu błędów.

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

Jeśli limit czasu został przekroczony przy samym wysyłaniu, przed ponownym wysłaniem sprawdź swoje zadania: pierwsze żądanie mogło już zostać przyjęte.

Wskazówki

Opisz obiekt, akcję, ruch kamery i światło oraz wymień dźwięki, które chcesz uzyskać; dźwięk jest generowany razem z obrazem.
Stwórz nieruchomy obraz w Muse Image, a potem przekaż tutaj jego URL, żeby go ożywić.
Aby uzyskać pionowe wideo, wyślij aspect_ratio: "9:16" lub pionowy obraz referencyjny.
Dodaj no text, aby uniknąć wymyślonych napisów.