Microsoft AI: MAI-Image-2.5
Microsoft AI MAI-Image-2.5 erstellt Bilder aus Text und bearbeitet bereitgestellte Fotos oder Designs gezielt. Es unterstützt Objekt- und Textänderungen, Artefaktbereinigung und Überarbeitungen unter Bewahrung des Gesichts, mit PNG-Ausgabe und bis zu fünf visuellen Referenzen. Seine Modellkarte nennt einen Kontext von 32K und 1.048.576 Ausgabepixel.
Ü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 ist die Ausgabe der Bildfamilie 2.5 für allgemeine Generierung und kontrollierte Bearbeitung. Seine Modellkarte beschreibt ein Diffusionsmodell mit Flow Matching, 20 Milliarden Parametern ohne Embeddings, Text- und Bildeingabe und einem Kontext von 32K Tokens. Es erzeugt Bildausgaben für Konzepte, Porträts, Produktbilder, Illustrationen und Überarbeitungen bestehender Designs. Die hilfreiche erste Entscheidung ist, ob die Aufgabe eine neue Komposition oder eine konkrete Änderung an einem Asset benötigt, das das gewünschte Motiv bereits enthält.
Beschreiben Sie für die Generierung Hauptmotiv, Bildstil, Licht, Blickwinkel und Anordnung. Der Hersteller hebt detailreiche, stimmige Bilder, Textdarstellung, Produktbilder und Prompt-Treue hervor. Ein praktisches Briefing für eine Präsentationsillustration kann die Rolle des Motivs, den gewünschten Bildschwerpunkt und den Umfang des umgebenden Freiraums angeben. Ein Produktkonzept kann Material, Maßstab und Oberflächenfinish enthalten. Halten Sie die Beschreibung schlüssig, damit Objekte eine gemeinsame Szene und einen Beleuchtungsplan teilen, statt mehrere unvereinbare visuelle Gestaltungen zu verbinden.
Visuelles Schlussfolgern betrifft in dieser Ausgabe Szenenstruktur, Beleuchtung, Maßstab und räumliche Beziehungen. Der Hersteller nennt das Hinzufügen eines Objekts mit passender Perspektive und Schatten als Bearbeitungsanwendung. Platzieren Sie bei einer Werkstattbearbeitung einen kleinen Hocker neben einer Werkbank und bewahren Sie vorhandenen Blickwinkel und Licht. Die Prüfung sollte Hockergröße, Bodenkontakt und Übereinstimmung seines Schattens mit den übrigen Objekten vergleichen. Auch ein lokal überzeugendes Objekt muss zur Geometrie des gesamten Quellbilds passen.
Gezielte Bearbeitungen umfassen Entfernen oder Austauschen von Objekten, Eigenschaftsänderungen, Inpainting, Layoutanpassung, Textaktualisierungen und Bereinigung, etwa das Reduzieren von Bewegungsunschärfeartefakten. Stellen Sie das Quellbild bereit und benennen Sie sowohl Korrektur als auch zu bewahrende Details. Eine fokussierte Fotobearbeitung könnte einen störenden Gegenstand im Hintergrund entfernen und dabei Person, Zuschnitt und Vordergrundanordnung erhalten. Eine Designüberarbeitung könnte eine kurze Textzeile aktualisieren und dabei die Komposition bewahren. Vergleichen Sie das vollständige Ergebnis mit der Quelle, statt nur den bearbeiteten Bereich zu bewerten.
Microsoft betont außerdem die Konsistenz der Gesichtsidentität über Bearbeitungen hinweg, einschließlich Änderungen von Pose, Ausdruck oder Blickwinkel. Verwenden Sie eine klare Referenz für die Ähnlichkeit und beschreiben Sie die gewünschte Änderung so, dass identifizierende Merkmale erhalten bleiben. Der aktuelle Bearbeitungsleitfaden des Herstellers akzeptiert bis zu fünf JPEG- oder PNG-Bilder. Verschiedene Referenzen können dadurch Person, Objekt, Szene oder Stil festlegen. Benennen Sie diese Rollen im Prompt. Prüfen Sie bei einer Porträtüberarbeitung das Gesicht ebenso wie geänderte Kleidung oder Hintergrund, bevor Sie das Bild als fertig behandeln.
Die konkrete Modellkarte begrenzt die Ausgabe auf insgesamt 1.048.576 Pixel, entsprechend einem Quadrat von 1024×1024, und erlaubt einer Seite, 1024 zu überschreiten, wenn die Gesamtfläche innerhalb dieser Grenze bleibt. Der Serving-Leitfaden verlangt zusätzlich beide Abmessungen von mindestens 768 Pixeln. Ein rechteckiges Ziel wie 1344×768 hat 1.032.192 Pixel und erfüllt diese dokumentierten Flächen- und Mindestabmessungsregeln. Die maßgebliche Grenze ist das Produkt aus Breite und Höhe. Bereiten Sie deshalb das Zielformat vor, bevor Sie eine Quer- oder Hochformatkomposition anfordern.
Generierung und Bearbeitung geben in der Serving-Schnittstelle des Herstellers PNG-Bilddaten zurück. Die native Modellkarte nennt einen Kontext von 32K Tokens, während diese Schnittstelle maximal 32.000 Tokens Prompt-Kontext festlegt. Die separate Katalogangabe von 4.096 Ausgabetokens ist ein Tokenrahmen und keine Ausgabeabmessung. Bewahren Sie diese angegebenen Geltungsbereiche bei der Organisation eines detaillierten Prompts und des fertigen Bilds. Quell-Assets, erhaltene Merkmale, gewünschte Änderungen und Zielgröße bilden gemeinsam mit dem PNG einen hilfreichen Überarbeitungsnachweis.
Der kreative Bereich des Modells umfasst fotorealistische und filmische Bilder, Porträts, Produkt- oder Markenkonzepte, texttragende Designs und andere Bildstile. Geben Sie für ein Etikett oder Schild den genauen Wortlaut an und prüfen Sie seine Schreibweise in der endgültigen Darstellungsgröße. Eine erkennbare fotografische Oberfläche kann dennoch erfundene Details, eine inkonsistente Reflexion oder ungenaue Schrift enthalten. Eine praktische Prüfung folgt den Designanforderungen: Objektidentität, Lesbarkeit, räumliche Beziehungen und erhaltene Szene sind gleichermaßen wichtig. Halten Sie eine konkrete Korrektur von bereits gelungenen Änderungen getrennt.
Innerhalb der Familie 2.5 betont Pro höhere Wiedergabetreue und stabile Beziehungen in dichten Szenen, während Flash einer reaktionsschnelleren Produktion dient. Die Familie 2.6 führt eine größere dokumentierte Pixelfläche, optionale Webfundierung und modellgesteuerte Seitenverhältniswahl ein. Standard-2.5 behält seinen eigenen Generierungs- und Bearbeitungsablauf ohne diese späteren Steuerungen. Wählen Sie die Ausgabe anhand der Schwierigkeit der tatsächlichen Bildaufgabe und prüfen Sie das fertige Ergebnis anhand dieses Briefings.
Ailoot Ultra · Bilder POST /v1/images/generations microsoft/mai-image-2.5
microsoft/mai-image-2.5Start
Microsoft AI MAI-Image-2.5 erstellt Bilder aus Text und bearbeitet bereitgestellte Fotos oder Designs gezielt. Es unterstützt Objekt- und Textänderungen, Artefaktbereinigung und Überarbeitungen unter Bewahrung des Gesichts, mit PNG-Ausgabe und bis zu fünf visuellen Referenzen. Seine Modellkarte nennt einen Kontext von 32K und 1.048.576 Ausgabepixel.
- Zulässige Eingaben
- Text · Bilder
- Ergebnisse
- Bilder
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Bilder POST /v1/images/generations
- Eingabetypen
text,image- Ausgabetypen
image
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits microsoft/mai-image-2.5 | 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 Token | TarifstaffelGrundtarif | Prognostizierte Menge— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Token Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Lesen · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Token |
| KonfigurationGeschätzte Generierungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.385024 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', '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
Aliasnamen für Methodenpfade
/v1/images
Zugehörige Aufrufer-IDs
FAQ · Microsoft AI: MAI-Image-2.5
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/images/generations·microsoft/mai-image-2.5:text,image→image- Welche Felder verwendet die Anfrage?
POST /v1/images/generations·microsoft/mai-image-2.5:model,prompt,aspect_ratio,n,input_references,provider- Welche Grenzen gelten?
POST /v1/images/generations·microsoft/mai-image-2.5:n.minimum:1;n.maximum:1