21:9 高调光晕宽幅：左侧留白，右侧悬浮半透明玻璃渲染面板与光带轨道，冷蓝、珊瑚粉与暖金渐变，模型名以玻璃蚀刻发光立体字呈现。

Muse Image 1.0

muse-image-1.0/image-to-image

Metas räsonierendes Modell zur Bildgenerierung und -bearbeitung: Es zerlegt komplexe Prompts vor dem Rendern, kann mehrere Referenzbilder zusammenführen und mithilfe von Websuche die sachliche Richtigkeit sicherstellen

muse-image-1.0/image-to-image muse-image-1.0/text-to-image

muse-image-1.0/image-to-image ausprobieren

Eingabe

Galerie

Alle Arbeiten ansehen

Ausgabe

image

Fülle die Parameter aus und generiere – die Ergebnisse erscheinen hier.

Preise

muse-image-1.0/image-to-image per task

Einzelpreis	$0.015

Positionsübersicht

muse-image-1.0/image-to-image ist ein von Meta eingeführtes, referenzbildgesteuertes Modell zur Bilderzeugung und -bearbeitung, das über die einheitliche Schnittstelle von HiAPI.ai aufgerufen wird. Es nimmt ein oder mehrere Referenzbilder als Eingabe und erzeugt zusammen mit einer Textaufforderung Bilder, ersetzt Elemente und schreibt Stile um; mehrteilige komplexe Anweisungen werden dabei zunächst zerlegt und layoutgeplant und anschließend gerendert. Es eignet sich für Entwickler, die vorhandenes Material als Basisbild verwenden und Wert auf Prompt-Treue sowie Effizienz bei der Massenproduktion legen, etwa für Materialvarianten, Produktszenenbilder und personalisierte Kompositionen.

Kernhighlights

Generierungsprozess mit erstem Reasoning, dann Rendering – vor dem Rendern werden mehrteilige Prompts zerlegt und das Layout geplant, wodurch die Wahrscheinlichkeit sinkt, dass komplexe Anweisungen bei einem einzelnen Vorwärtsdurchlauf verworfen werden.
Generierung und Bearbeitung in einem Modell – Referenzbildfusion und anweisungsbasierte Umformulierung benötigen keine zusätzliche Bearbeitungstoolchain, was die Anzahl der Aufrufschritte reduziert.
Mehrere Referenzbilder pro Anfrage möglich – akzeptiert bis zu 10 Referenzbilder; im Prompt kann für jedes Bild eine Rolle als Motiv, Stil oder Kompositionselement festgelegt werden.
Ausgabespezifikationen direkt über Parameter steuerbar – Seitenverhältnis sowie Ausgabeformat (jpeg, png, webp) lassen sich angeben, was die Anbindung an nachgelagerte Materialprozesse erleichtert.

Funktionsbeschreibung

Referenzbildgesteuerte Bildbearbeitung: Nimmt Referenzbilder plus Textaufforderung als Eingabe und ändert oder bewahrt Bildinhalte gemäß der Aufforderung – geeignet für gezielte Anpassungen an vorhandenem Material statt für die Generierung von Grund auf.

Multibild-Fusion: Eine einzelne Anfrage kann 1 bis 10 Referenzbilder enthalten, wobei im Prompt für jedes Bild eine Rolle als Motiv, Stil oder Kompositionselement angegeben wird – für Kompositionsaufgaben.

Zerlegte Ausführung komplexer Prompts: Mehrteilige Beschreibungen werden erst geplant und dann gerendert, sodass Prompts mit mehreren Motiven und Layoutanforderungen eher vollständig umgesetzt werden.

Steuerung der Ausgabespezifikationen: Unterstützt neun Seitenverhältnisse von 1:1 bis 21:9 sowie die Formate jpeg, png und webp; die Ausgabe erfolgt direkt gemäß Verbreitungs- oder Speicheranforderungen.

Anwendungsszenarien

Werbe- und Kampagnenteams: Varianten in Serie aus vorhandenem Material erzeugen – Markenbasisbilder hochladen und gemäß Kanal-Prompt Bildinhalt und Seitenverhältnis umformulieren, um mehrere Materialsets für A/B-Tests und die Verteilung über mehrere Kanäle zu erzeugen.
E-Commerce-Betrieb: szenische Umgestaltung von Produktbildern – Produktfotos als Referenz verwenden, per Prompt Hintergrund und Szene austauschen und Katalog- oder Szenenbilder für Produktdetailseiten ausgeben.
Personalisierte Komposition: Nutzerfotos in neue Bilder einbetten – vom Nutzer hochgeladene Fotos als Referenzbilder für thematische Kompositionen verwenden und maßgeschneiderte Bilder für Aktionsseiten oder Social-Media-Sharing erzeugen.

Einschränkungen und Auswahlhinweise

Öffentlich zugängliche Materialien enthalten keine technischen Details zu Modellarchitektur und Ausgabauflösung; die Ergebnisse sind anhand der tatsächlichen Effekte zu bewerten. Mehrstufiges Reasoning verursacht zusätzliche Latenz und ist für Szenarien mit äußerst empfindlicher Antwortzeit nicht geeignet; die Ausgabe beschränkt sich auf Bilder, ohne Video oder Audio. Wenn die Aufgabe lediglich eine reine Text-zu-Bild-Generierung ohne Referenzbild erfordert, kann die Text-zu-Bild-Variante derselben Familie gewählt werden; wenn Videogenerierung oder geringere Latenz benötigt wird, sollten andere Modelle in Betracht gezogen werden.

Häufige Fragen

Alle Fragen ansehen →

Wie wählt man zwischen Text-zu-Bild und Bildbearbeitung?

Wenn nur Text vorliegt und man von Null anfängt, wählt man Text-zu-Bild; wenn ein vorhandenes Motiv oder Layout beibehalten werden soll, wählt man die Bildbearbeitung und stellt ein Referenzbild bereit.
Wie viele Bilder erhalte ich pro Vorgang?

Jeder Auftrag liefert ein Bild; es gibt keine Auswahl der Bildanzahl. Wenn Sie eine andere Bildkomposition vergleichen möchten, passen Sie den Prompt an und reichen Sie einen neuen Auftrag ein.
Kann man 1K, 2K oder 4K wählen?

Dieser Einstiegspunkt bietet keine Auflösungsstufen. Das Bildformat wählst du, die Pixelabmessungen bestimmen das Modell, üblicherweise etwa 2,5 MP; maßgeblich sind die tatsächlichen Abmessungen der heruntergeladenen Datei.
Welche Dateiformate kann ich auswählen?

Sie können JPEG, PNG oder WebP auswählen; wenn keine Auswahl getroffen wird, wird WebP verwendet. Wählen Sie das Format je nach Bedarf für spätere Webbenutzeroberflächen-Assets oder Design-Tools.

Generierungsaufgabe erstellen

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringPflicht

Account-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen

Content-TypestringOptional

Der Anfragekörper wird immer als JSON geparst; beim Senden ist nur application/json (optional mit charset) zulässig — andere Werte liefern 415. Beispiel: application/json.

Idempotency-KeystringOptional

Idempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.

Idempotenz-Schlüssel

Bei Netzwerk-Timeouts oder Client-Wiederholungen erstellt derselbe Schlüssel die Aufgabe nur einmal — keine doppelte Abbuchung (Geltungsbereich = das Konto des API-Schlüssels). Empfohlen: geschäftsseitig eindeutige Kennung (z. B. "order-42"); Replays liefern die ursprüngliche taskId, Schlüssel laufen 24 Stunden nach der ersten Anfrage ab. Die vollständige Szenariomatrix steht in der Übersicht der Unified Async API.

Body

modelstringPflicht

Aktueller Festwert: muse-image-1.0/image-to-image

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

Geschäftsparameter für muse-image-1.0/image-to-image und Route default — siehe Parametertabelle unten.

promptstringPflichtminLength 1maxLength 5000

Text-Prompt zur Beschreibung des gewünschten Bildes oder zur Angabe, welche Inhalte in den Referenzbildern geändert und welche beibehalten werden sollen; bei Verwendung von Referenzbildern sollte darin angegeben werden, welche Rolle Subjekt, Stil oder Komposition der einzelnen Bilder spielen.

image_urlsarrayPflichtminItems 1maxItems 10

Array von Referenzbildern, dessen Elemente Bildadressen sind, die als Referenzbilder für die Bild-zu-Bild-Generierung dienen; es wird empfohlen, im Prompt anzugeben, welche Rolle Subjekt, Stil oder Komposition der einzelnen Bilder spielen.

Array [ string ]

aspect_ratiostringOptional

Seitenverhältnis des Ausgabebildes; bestimmt nur das Verhältnis, nicht die exakte Pixelgröße.

Optionen:1:14:33:416:99:163:22:321:9

Alle anzeigen (1)

9:21

output_formatstringOptionalStandard: "webp"

Dateiformat des heruntergeladenen Bildes, standardmäßig webp.

Optionen:jpegpngwebp

callbackobjectOptional

Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.

Callbacks (Webhook)

Beim Erstellen callback.url angeben, dann POSTet HiAPI im Endzustand an Ihren Service — kein Polling nötig. Der Callback-Body entspricht der Aufgaben-Detailstruktur; Signaturprüfung, Wiederholungen und Idempotenz sind in der Übersicht der Unified Async API beschrieben.

urlstringPflicht

Pflicht, wenn callback angegeben ist. Nach dem Endzustand wird an diese URL gepostet; muss eine gültige http(s)-URL sein.

whenstringOptionalStandard: "final"

Derzeit wird nur final unterstützt — Benachrichtigung bei success und fail.

Optionen:final

storagestringOptionalStandard: "temp"

Speicherstufe für Artefakte: temp (Standard, ca. 7 Tage) oder persistent (langfristig, nach Größe abgerechnet). Bei unzureichendem Guthaben oder Überschreitung des Speicherlimits erfolgt ein stiller Downgrade auf temp; die wirksame Stufe steht in der Aufgaben-Detailantwort.

Optionen:temppersistent

Anfragebeispiele

# Asynchrone Aufgabe senden; gibt sofort eine taskId zurück (wartet nicht auf die Generierung)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "muse-image-1.0/image-to-image",
  "input": {
    "prompt": "…",
    "image_urls": "…",
    "output_format": "webp"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "muse-image-1.0/image-to-image",
    input: {
      "prompt": "…",
      "image_urls": "…",
      "output_format": "webp"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "muse-image-1.0/image-to-image",
        "input": {
          "prompt": "…",
          "image_urls": "…",
          "output_format": "webp"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Aufgabendetails abrufen

GET https://api.hiapi.ai/v1/tasks/:id

Antwortfelder

taskIdstringPflicht

Aufgaben-ID, stets mit Präfix tk-hiapi-.

modelstringPflicht

Aufgelöster vollständiger Modellname. Mit route-Parameter eingereichte Aufgaben geben base@route zurück (z. B. gpt-image-2/text-to-image@ext); sonst identisch mit dem übermittelten Namen.

routestringOptional

Erscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.

statusstringPflicht

Aufgabenstatus.

Statuswerte

queued Eingereiht, noch nicht gestartet. handling In Verarbeitung. archiving Verarbeitung abgeschlossen, Artefakte werden vorbereitet. success Endzustand: abgeschlossen, Artefakte verfügbar (output wird zurückgegeben). fail Endzustand: fehlgeschlagen (error wird zurückgegeben). Nach dem Senden den status prüfen: success und fail sind Endzustände, alles andere nicht. Alle 1–3 Sekunden bis zum Endzustand pollen. Nach Erfolg Artefakte aus output[].url laden und vor expireAt übertragen; für Langzeitaufbewahrung storage: "persistent" beim Erstellen angeben.

creatednumberPflicht

Zeitpunkt der Aufgabenerstellung (Unix-Sekunden).

completednumberPflicht

Unix-Sekunden des Endzustands; vor Abschluss stets 0.

outputarrayOptional

Nur bei status == success. Artefaktliste — immer ein Array; eine Aufgabe kann mehrere Typen gleichzeitig liefern (z. B. video + first_frame).

Array [ object ]

Array-Elemente

urlstringPflicht

Artefakt-URL, direkt herunterladbar.

typestringPflicht

Aktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.

expireAtnumberPflicht

Unix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.

errorobjectOptional

Nur bei status == fail.

codestringPflicht

Business-Fehlercode.

messagestringPflicht

Fehlerbeschreibung.

Antwortbeispiele

Erfolg

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

In Bearbeitung (nicht final)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fehlgeschlagen

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}