Muse Image

Generuj obrazy Muse Image z promptu lub do 9 obrazów referencyjnych w siedmiu proporcjach, po jednym na żądanie, rozliczane za obraz i dostarczane przez zadanie.

Muse Image to model obrazów od Meta Superintelligence Labs. Jedno żądanie tworzy jeden obraz 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 gotowy obraz z tego zadania. Obrazy referencyjne przekazujesz jako adresy URL.

ID modeli

ID modelu	Dane wejściowe	Proporcje obrazu	Obrazy na żądanie
`muse-image`	tekst, 0–9 obrazów	`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`	1

Aktualne ceny znajdziesz na stronie modelu.

Krótki przykład

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "muse-image",
    "prompt": "A red ceramic mug on a white table, soft studio light, product photography. No text, no logos.",
    "aspect_ratio": "1:1"
  }'

Punkt końcowy

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

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

Odpowiedź to zadanie ({"id": "task_...", "status": "processing"}), a nie gotowy obraz. Wynik odczytasz, odpytując GET /v1/tasks/{task_id}. Klucze API trzymaj w kodzie po stronie serwera. Obrazy referencyjne przekazujesz w tym samym żądaniu przez image_urls; /v1/images/edits nie jest używane dla tego modelu.

Parametry

Pole	Typ	Domyślnie	Uwagi
`model`	string	wymagane	`muse-image`
`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 obraz.
`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 `1:1`. Nie wysyłaj `"auto"`.
`size`	enum	brak	Alias zgodności dla `aspect_ratio`: jedne z powyższych proporcji lub `auto`. Rozmiary w pikselach, takie jak `1024x1024`, są odrzucane. Gdy oba pola są poprawne, pierwszeństwo ma `aspect_ratio`.
`n`	integer	`1`	Tylko `1`. Każde żądanie zwraca jeden obraz.

Pola spoza tej listy są usuwane przed przekazaniem żądania dalej; nigdy nie powodują błędu ani nie zmieniają wyniku. Nie ma ustawień rozdzielczości, ziarna losowego, negatywnego promptu, maski ani formatu wyjściowego. callback_url nie jest dostępne; zamiast tego odpytuj zadanie.

Obrazy referencyjne

Przekaż do 9 obrazów w image_urls i napisz w prompt, co zachować, a co zmienić. Muse Image używa ich jako obrazów referencyjnych dla nowego obrazu; po pominięciu aspect_ratio wynik przejmuje ich format.

{
  "model": "muse-image",
  "prompt": "Keep this exact jacket; show it folded in a flat lay of hiking gear on pine boards, soft morning light.",
  "image_urls": ["https://example.com/jacket.png"],
  "aspect_ratio": "9:16"
}

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 Image ma jedną cenę za obraz:

cost = price per image × 1

Żą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-image", "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-image",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689680,
  "output": {
    "created": 0,
    "data": [
      { "url": "https://static.seedrouter.ai/media/tasks/task_example/0.webp" }
    ]
  }
}

Obraz jest dostarczany jako WebP, własny format modelu; nie ma ustawienia formatu wyjściowego. Model ustala rozmiar w pikselach. W naszych testach żądanie z samym tekstem zwróciło 1600 × 1600, 16:9 — 2048 × 1152, 3:4 — 1344 × 1792, a 9:16 — 1152 × 2048, około 50–180 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-image",
  "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

Wymień obiekt, otoczenie, światło i kadrowanie; Muse Image dokładnie trzyma się konkretnego opisu.
Przy obrazach referencyjnych wskaż dokładnie, co ma zostać bez zmian, na przykład kolor lub kształt produktu.
Pomiń aspect_ratio, aby dopasować format do obrazu referencyjnego; ustaw je, aby dopasować kadr do kanału.
Dodaj no text, no logos, aby w kadrze nie pojawiały się wymyślone oznaczenia.