Muse Image

Muse Image ist das Bildmodell von Meta Superintelligence Labs. Eine Anfrage erstellt ein Bild 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 Bild aus der Aufgabe aus. Referenzbilder werden als URLs übergeben.

Modell-IDs

Aktuelle Preise findest du auf der Modellseite.

Kurzbeispiel

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

Endpunkt

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

Die Antwort ist eine Aufgabe ({"id": "task_...", "status": "processing"}), nicht das fertige Bild. Frage GET /v1/tasks/{task_id} für das Ergebnis ab. Bewahre API-Schlüssel im serverseitigen Code auf. Referenzen werden in derselben Anfrage über image_urls übergeben; /v1/images/edits wird für dieses Modell nicht verwendet.

Parameter

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 Einstellung für Auflösung, Seed, negativen Prompt, Maske oder Ausgabeformat. callback_url ist nicht verfügbar; frage stattdessen die Aufgabe ab.

Referenzbilder

Übergib bis zu 9 Bilder in image_urls und sage in prompt, was bleiben und was sich ändern soll. Muse Image nutzt sie als Referenzen für ein neues Bild; ohne aspect_ratio folgt das Ergebnis ihrem 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"
}

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 Image hat einen Preis pro Bild:

cost = price per image × 1

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

Das Bild wird als WebP geliefert, dem eigenen Format des Modells; es gibt keine Einstellung für das Ausgabeformat. Das Modell legt die Pixelgröße fest. In unseren Tests kam eine reine Textanfrage mit 1600 × 1600 zurück, 16:9 mit 2048 × 1152, 3:4 mit 1344 × 1792 und 9:16 mit 1152 × 2048, etwa 50–180 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-image",
  "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

• Nenne Motiv, Umgebung, Licht und Bildausschnitt; Muse Image folgt einer konkreten Vorgabe genau.
• Sage bei Referenzen genau, was gleich bleiben muss, etwa die Farbe oder Form des Produkts.
• Lasse aspect_ratio weg, um dem Format einer Referenz zu folgen; setze es für den Zuschnitt auf einen Kanal.
• Füge no text, no logos hinzu, um erfundene Zeichen fernzuhalten.

Weiterführend

• Muse Image Playground und Preise
• Muse Video API-Referenz
• OpenAPI herunterladen
• Markdown zum Kopieren