Image API

Bilder generieren und bearbeiten

Führen Sie GPT Image 2, GPT Image 2.5 Flare, GPT Image 2.5 Sunburst, Nano Banana, Nano Banana 2, Nano Banana 2 Lite, Nano Banana 2.1, Nano Banana Pro, Seedream 4.0, Seedream 4.5, Seedream 5.0, Seedream 5 Pro mit einem einheitlichen Anfrageformat aus.

Endpunkte

Verwenden Sie /v1/images/generations, um Bilder aus einem Prompt zu erstellen. Akzeptiert JSON.

POSThttps://api.mlmux.com/v1/images/generations

Verwenden Sie /v1/images/edits, um Bilder zu bearbeiten oder zu kombinieren. Senden Sie Bild-URLs in JSON oder laden Sie Dateien über die Multipart-Felder image und mask hoch. Es werden bis zu 16 Bilder mit jeweils maximal 50 MB akzeptiert.

POSThttps://api.mlmux.com/v1/images/edits

Anfragebeispiel

curl https://api.mlmux.com/v1/images/generations \
  -H "Authorization: Bearer $MLMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "nano-banana-2",
  "prompt": "Editorial product photo of a ceramic mug on linen, soft window light",
  "aspect_ratio": "4:3",
  "resolution": "2K",
  "output_format": "png",
  "route_mode": "official-cheap"
}'

Anfragen sind standardmäßig synchron und geben die Bilder in der Antwort zurück. Fügen Sie "async": true hinzu, um stattdessen eine Aufgabe zu erhalten.

Parameter

Feld	Typ	Erforderlich	Beschreibung
`model`	string	Ja	Eine Modell-ID aus der folgenden Tabelle. Das Anbieterpräfix kann weggelassen werden, wenn der Kurzname eindeutig ist, z. B. `gpt-image-2`.
`prompt`	string	Ja	Was generiert oder geändert werden soll, bis zu 20.000 Zeichen.
`image_urls`nur Bearbeitungen	string[]	Ja	Öffentliche http(s)-URLs der Eingabebilder in der richtigen Reihenfolge. `image_url` wird für ein einzelnes Bild ebenfalls akzeptiert.
`mask_url`nur Bearbeitungen	string	Nein	URL eines Maskenbilds für Modelle, die maskierte Bearbeitungen unterstützen.
`route_mode`	string	Nein	`official` oder `official-cheap`. Standardmäßig der Route-Modus des Schlüssels, ansonsten `official-cheap`.
`resolution`	string	Nein	`1K`, `2K` oder `4K` bei Gemini-Modellen, die dies unterstützen. Nano Banana und Nano Banana 2 Lite haben keine Auflösungseinstellung.
`size`	string	Nein	Ausgabegröße für GPT Image und Seedream, wie etwa `1024x1024`, `2K` oder `auto`.
`aspect_ratio`	string	Nein	Beispielsweise `1:1`, `16:9` oder `match_input_image`. Zulässige Werte hängen vom Modell ab.
`output_format`	string	Nein	`png`, `jpg`, `jpeg` oder `webp`, sofern vom Modell unterstützt.
`n`	integer	Nein	Anzahl der Bilder, 1 bis 4. Standardwert ist 1.
`async`	boolean	Nein	`true` gibt eine Aufgabe (HTTP 202) zum Abfragen (Polling) zurück, anstatt auf die Bilder zu warten.

Modell-IDs

Verwenden Sie diese Werte in model. GET /v1/models gibt die für Ihr Konto verfügbaren IDs zurück.

Modell	Modell-ID
GPT Image 2	`openai/gpt-image-2`
GPT Image 2.5 Flare	`weavy/gpt-image-2.5-flare`
GPT Image 2.5 Sunburst	`weavy/gpt-image-2.5-sunburst`
Nano Banana	`nano-banana`
Nano Banana 2	`nano-banana-2`
Nano Banana 2 Lite	`nano-banana-2-lite`
Nano Banana 2.1	`google/gemini-nano-banana-2.1`
Nano Banana Pro	`nano-banana-pro`
Seedream 4.0	`weavy/doubao-seedream-4-0-250828`
Seedream 4.5	`weavy/doubao-seedream-4-5-251128`
Seedream 5.0	`weavy/doubao-seedream-5-0-260128`
Seedream 5 Pro	`weavy/doubao-seedream-5-0-pro-260628`

GPT Image 2, GPT Image 2.5 Flare und GPT Image 2.5 Sunburst laufen derzeit nur auf official. Senden Sie bei diesen Modellen "route_mode": "official" mit; andernfalls verwendet die Anfrage den Standardwert official-cheap und schlägt fehl.

Antwort

Eine synchrone Anfrage gibt HTTP 200 mit einer URL pro Bild in data und den Token-Zahlen in usage zurück. Ausgabe-URLs werden von MLMux gehostet; laden Sie die Dateien herunter, die Sie behalten möchten.

200 OK

{
  "created": 1767225600,
  "data": [
    { "url": "https://.../generated/9f2c....png" }
  ],
  "usage": {
    "input_tokens": 18,
    "output_tokens": 1120,
    "total_tokens": 1138,
    "input_tokens_details": { "text_tokens": 18, "image_tokens": 0 }
  }
}

Asynchrone Anfragen

Mit "async": true gibt die Anfrage HTTP 202 und eine Aufgabe zurück. Fragen Sie deren poll_url ab, bis status den Wert succeeded hat; die Bilder werden dann in data aufgeführt.

GEThttps://api.mlmux.com/v1/images/generations/{task_id}

202 Accepted

{
  "id": "task_7c1e...",
  "object": "image.generation.task",
  "status": "queued",
  "created": 1767225600,
  "model": "nano-banana-2",
  "api_method": "images.generations.create",
  "poll_url": "/v1/images/generations/task_7c1e...",
  "progress": 0,
  "message": "queued",
  "estimated_charge_credits": 0.067
}

Erfolgreich

{
  "id": "task_7c1e...",
  "object": "image.generation.task",
  "status": "succeeded",
  "progress": 100,
  "message": "completed",
  "estimated_charge_credits": 0.067,
  "data": [
    { "url": "https://.../generated/7c1e....png" }
  ]
}

Bildbearbeitungsaufgaben werden unter /v1/images/edits/{task_id} abgefragt. GET /v1/tasks/{task_id} funktioniert für jede Aufgabe.