Microsoft AI: MAI-Image-2.5 Pro
Microsoft AI MAI-Image-2.5 Pro generiert und bearbeitet detailreiche Bilder für Hauptmotive, Produktkompositionen und präzisen Text im Bild. Die Pro-Ausgabe betont konsistente Gegenstände, Figuren, Materialien und räumliche Beziehungen in dichten Szenen und erzeugt mit Text und visuellen Referenzen ein PNG-Bild.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
Microsoft AI MAI-Image-2.5 Pro ist die auf Wiedergabetreue ausgerichtete Ausgabe der 2.5-Bildserie. Es generiert Bilder aus natürlichsprachlichen Briefings und bearbeitet vorhandene Dateien gezielt. Microsoft nennt Hauptmotive, detaillierte Bearbeitung und präzisen Text im Bild als zentrale Anwendungen; der Modellvergleich betont Konsistenz von Gegenständen, Figuren, Materialien und räumlichen Beziehungen in komplexen Kompositionen. Das fertige Ergebnis ist ein Bild für Design oder Produktion, etwa ein zentrales Produktmotiv oder eine sorgfältig angeordnete redaktionelle Szene.
Beschreiben Sie die Komposition über Beziehungen statt als Liste unabhängiger Gegenstände. Benennen Sie Hauptmotiv, Größenverhältnis zu benachbarten Dingen, Materialien und Lichtrichtung. Das dokumentierte visuelle Schlussfolgern der Pro-Ausgabe hilft, wenn diese Beziehungen über die Glaubwürdigkeit einer dichten Szene entscheiden. Setzen Sie für eine Produktkomposition einen Keramikkrug, klare Gläser und ein gefaltetes Tuch auf einen Holztisch, mit konsistenten Reflexionen und einem einzelnen Fensterlicht. Prüfen Sie Berührungspunkte, Schatten und sichtbare Materialeigenschaften im Ergebnis.
Liefern Sie für Produkte und Figuren die visuelle Identität, die die Bearbeitung überstehen muss. Microsoft beschreibt Objektkonsistenz in komplexen Szenen und Figurenkonsistenz über Ansichten und Momente hinweg als Pro-Stärken. Nennen Sie identifizierende Merkmale von Gegenstand oder Person und den zu ändernden Szenenaspekt. Behalten Sie beispielsweise Jackensilhouette und Verschlussdetails bei und setzen Sie die Figur in einen anderen Hintergrund. Eine nützliche Prüfung vergleicht erhaltene Details mit der Quellreferenz; ein attraktives Ergebnis allein belegt keine exakte Übereinstimmung.
Die Bildbearbeitungsschnittstelle des Herstellers akzeptiert bis zu fünf JPEG- oder PNG-Referenzen. Trennen Sie ihre Rollen im Briefing: Produkt, Person, Umgebung oder Bildgestaltung. Bearbeitungsaufgaben umfassen Objektentfernung und -austausch, Attributänderungen, Inpainting, Layoutanpassung, Textaktualisierung und Artefaktbereinigung. Beschreiben Sie bei lokalen Änderungen das Ziel und zu erhaltende Umgebungsdetails. Erklären Sie bei größeren Umstellungen die spätere Komposition, damit das Modell ein schlüssiges räumliches Ziel erhält.
Textdarstellung ist besonders bei Hauptmotiven oder Verpackungskonzepten relevant. Geben Sie den genauen Satz, seine Position und Beziehung zum Gegenstand oder Bild an. Halten Sie wiederkehrende Namen und Etiketttexte zwischen Briefing und Referenzen konsistent. Prüfen Sie jedes gerenderte Zeichen in der vorgesehenen Anzeigegröße und vergleichen Sie es mit dem gelieferten Wortlaut. Eine spätere Änderung kann Wortlaut oder Position betreffen und die gelungene Produktkomposition bewahren. Die PNG-Ausgabe lässt sich danach in ein Layout mit bekannten Anforderungen an Typografie und Zuschnitt einsetzen.
Der aktuelle Microsoft-Bildleitfaden begrenzt die 2.5-Modelle auf 1.048.576 Ausgabepixel, entsprechend 1024×1024. Beide Abmessungen müssen in dieser Schnittstelle mindestens 768 Pixel betragen; eine längere Seite ist bei Einhaltung der Gesamtfläche zulässig. Das erlaubt rechteckige Kompositionen wie 1344×768 mit insgesamt 1.032.192 Pixeln. Diese Flächengrenze unterscheidet sich von höchstens 1024 Pixeln pro Seite. Bereiten Sie das Zielformat vor, statt von einer allgemeinen Seitenverhältnisbezeichnung einen korrekten Zuschnitt zu erwarten.
Der Bereitstellungsleitfaden nennt maximal 32.000 Tokens Prompt-Kontext und liefert PNG-Bilddaten für Generierung und Bearbeitung. Die genaue Pro-Katalogseite führt separat ein Kontextfenster von 131.072K und 4.096 Ausgabetokens auf. Dies sind veröffentlichte Tokenmengen mit eigenem Katalog- oder Bereitstellungsbereich; die praktische Bildanfrage folgt den Prompt- und Pixelgrenzen der Bereitstellung. Bewahren Sie Bild, Quellenreferenzen und Briefing als gemeinsamen Überarbeitungsnachweis auf. Prüfen Sie am Bild selbst die detaillierten Identitäts-, Material- und Geometrievorgaben, die die Pro-Wahl begründet haben.
Die Versionswahl sollte der Komposition folgen. Standard-MAI-Image-2.5 deckt allgemeine Generierung und lokale Änderungen ab; Pro ergänzt den Serienschwerpunkt auf Wiedergabetreue und konsistente Beziehungen in visuell dichten Szenen. Die 2.6-Familie erhöht die dokumentierte Ausgabefläche und ergänzt optionalen Web-Quellenbezug und automatische Formatwahl. Diese späteren Steuerungen gehören spezifisch zu 2.6 und definieren nicht den Ablauf dieser Pro-Ausgabe. Wählen Sie Pro, wenn stabile Objektidentität, Materialaussehen oder räumliche Struktur in einem detaillierten Bild die Schwierigkeit bilden.
Prüfen Sie gewünschte Änderung und erhaltenen Inhalt. Hände mit Gegenständen, Überschneidungen, Kleingedrucktes, Gesichtsähnlichkeit und Reflexionen sind sinnvolle Prüfpunkte komplexer Kompositionen. Ein plausibles Bild kann dennoch eine irreführende Kennzeichnung oder falsche physische Beziehung enthalten. Machen Sie die nächste Korrektur konkret und bewahren Sie die Briefingteile, die das gewünschte Layout erzeugt haben. Das ermöglicht kontrollierte Designüberarbeitungen, statt die gesamte Szene immer neu zu definieren.
Ailoot Ultra · Bilder POST /v1/images/generations microsoft/mai-image-2.5-pro
microsoft/mai-image-2.5-proEinstieg
Microsoft AI MAI-Image-2.5 Pro generiert und bearbeitet detailreiche Bilder für Hauptmotive, Produktkompositionen und präzisen Text im Bild. Die Pro-Ausgabe betont konsistente Gegenstände, Figuren, Materialien und räumliche Beziehungen in dichten Szenen und erzeugt mit Text und visuellen Referenzen ein PNG-Bild.
- Zulässige Eingaben
- Text · Bilder
- Ergebnisse
- Bilder
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Bilder POST /v1/images/generations
- Eingabe
text,image- Ausgabe
image
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits microsoft/mai-image-2.5-pro | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 | Standard— |
Feldaspect_ratio | Typstring | AnforderungOptional | Werte und Limits 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto | Standard— |
Feldn | Typinteger | AnforderungOptional | Werte und Limits Minimum: 1 Maximum: 1 | Standard— |
Feldinput_references | Typarray | AnforderungOptional | Werte und Limits Mindestanzahl Elemente: 0 Maximale Anzahl Elemente: 1 | Standard— |
Feldprovider | Typobject | AnforderungOptional | Werte und Limits | Standard— |
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt |
Parametermaterial_types | Vertragtext, image |
Lebenszyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · die tatsächlich zurückgegebene task_id oder ein Eintrag in der Medienbibliothek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarife
So wird die endgültige Gebühr berechnet
Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Geschätzte Tarife zum Vergleich
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Gebühr |
|---|---|---|---|
| KonfigurationBasistarife für Tokens | TarifstaffelGrundtarif | Prognostizierte Menge— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Tokens Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache lesen · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · In Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · In Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens |
| KonfigurationGeschätzte Generierungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.884736 Schätzung vor der Generierung Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung. |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot Ultra · Bilder
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'microsoft/mai-image-2.5-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin
def save_images(items):
if not items: raise SystemExit("No completed images; retain the full response")
for index, item in enumerate(items):
encoded=item.get("b64_json")
uri=item.get("url", "")
if not encoded and uri.startswith("data:image/"):
header, separator, encoded=uri.partition(",")
if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
if encoded:
raw=base64.b64decode(encoded,validate=True)
elif uri:
uri=urljoin("https://api.ailoot.ai",uri)
parsed=urlsplit(uri)
if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
raise SystemExit("Invalid returned image URL")
owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",uri]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
temporary=Path(f"image-{index}.bin")
subprocess.run(args+["-o",str(temporary)],check=True)
raw=temporary.read_bytes()
temporary.unlink()
else: raise SystemExit("Image has neither bytes nor URL")
if not raw: raise SystemExit("Empty image result")
ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
Ergebnisse abrufen und speichern
Ailoot Ultra · Bilder
Laden Sie jedes zurückgegebene Bild herunter oder speichern Sie seinen Base64-Inhalt
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Abrufe anderer Inhalte
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Alle fertiggestellten Ergebnisse aufbewahren
Speichern Sie jedes fertiggestellte Bild; rufen Sie jede zurückgegebene URL ab oder dekodieren Sie seinen Base64-Inhalt.
Die vollständige Antwort und ihre Header, jede tatsächliche Ausgabe, die ursprünglich zurückgegebenen Kennungen und alle Nutzungsfelder aufbewahren. Den ursprünglichen Vorgang wiederaufnehmen, ohne die Erstellung erneut anzufordern.
Wenn die ursprüngliche Antwort geprüft werden muss
Die zurückgegebene X-Client-Request-ID zum Abgleich aufbewahren. Nur tatsächlich zurückgegebene task_id-/asset_id-Werte oder die eigene Medienbibliothek abfragen; niemals eine Aufgaben-URL aus der Vorgangs-ID bilden und die Erstellung niemals erneut anfordern.
Antwortfelder
| Feld | Typ |
|---|---|
Feldcreated | Typ |
Felddata[].url | Typ |
Felddata[].b64_json | Typ |
Feldusage | Typ |
Aliasnamen
Modellaliasnamen
Ailoot Ultra microsoft/mai-image-2.5-pro
Aliasnamen für Methodenpfade
/v1/images
Zugehörige Aufrufer-IDs
FAQ · Microsoft AI: MAI-Image-2.5 Pro
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/images/generations·microsoft/mai-image-2.5-pro:text,image→image- Welche Felder verwendet die Anfrage?
POST /v1/images/generations·microsoft/mai-image-2.5-pro:model,prompt,aspect_ratio,n,input_references,provider- Welche Grenzen gelten?
POST /v1/images/generations·microsoft/mai-image-2.5-pro:n.minimum:1;n.maximum:1