Microsoft AI: MAI-Image-2.5
Microsoft AI MAI-Image-2.5 maakt afbeeldingen vanuit tekst en voert gerichte bewerkingen uit op aangeleverde foto's of ontwerpen. Het ondersteunt object- en tekstwijzigingen, artefactopruiming en revisies met behoud van gezichten, met PNG-uitvoer en maximaal vijf visuele referenties. De modelkaart specificeert een 32K-context en 1048576 uitvoerpixels.
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Microsoft AI MAI-Image-2.5 is de editie voor algemene generatie en gecontroleerde bewerking binnen de 2.5-afbeeldingsfamilie. De modelkaart beschrijft een diffusiemodel met flow matching, 20 miljard parameters exclusief embeddings, tekst- en afbeeldingsinvoer en een context van 32K tokens. Het produceert afbeeldingen voor concepten, portretten, productbeelden, illustraties en revisies van bestaande ontwerpen. De bruikbare eerste keuze is of de taak een nieuwe compositie nodig heeft of een specifieke wijziging aan een beeld dat het gewenste onderwerp al bevat.
Beschrijf voor generatie het hoofdonderwerp, de visuele stijl, het licht, het standpunt en de indeling. De maker benadrukt gedetailleerde, samenhangende beelden, tekstweergave, productbeelden en het volgen van prompts. Een praktische briefing voor een presentatie-illustratie kan de rol van het onderwerp, de gewenste visuele nadruk en de hoeveelheid omringende ruimte specificeren. Een productconcept kan materiaal, schaal en oppervlakteafwerking bevatten. Houd de beschrijving samenhangend zodat objecten één scène en één belichtingsplan delen, in plaats van verschillende onverenigbare visuele behandelingen te combineren.
Visueel redeneren in deze editie gaat over scènestructuur, belichting, schaal en ruimtelijke relaties. De fabrikant noemt het toevoegen van een object met passend perspectief en schaduwen als bewerkingstoepassing. Plaats bij een werkplaatsbewerking een kleine kruk naast een werkbank en behoud het bestaande standpunt en licht. De beoordeling moet de grootte van de kruk, het contact met de vloer en de aansluiting van de schaduw op andere objecten vergelijken. Een lokaal overtuigend object moet nog steeds passen in de geometrie van de hele bronafbeelding.
Gerichte bewerkingen omvatten objectverwijdering of -vervanging, eigenschapswijzigingen, inpainting, lay-outaanpassing, tekstupdates en opruiming zoals het verminderen van bewegingsonscherpteartefacten. Lever de bronafbeelding aan en benoem zowel de correctie als de te behouden details. Een gerichte fotobewerking kan een afleidend achtergrondobject verwijderen met behoud van persoon, uitsnede en voorgrondindeling. Een ontwerprevisie kan een korte tekstregel aanpassen met behoud van de compositie. Vergelijk het volledige resultaat met de bron in plaats van alleen het bewerkte gebied te beoordelen.
Microsoft benadrukt ook consistente gezichtsidentiteit tussen bewerkingen, inclusief veranderingen in houding, expressie of standpunt. Gebruik een duidelijke referentie voor de gelijkenis en specificeer de gewenste wijziging met behoud van herkenningskenmerken. De huidige bewerkingsgids van de fabrikant accepteert maximaal vijf JPEG- of PNG-afbeeldingen, zodat verschillende referenties persoon, object, scène of stijl kunnen aangeven. Benoem die rollen in de prompt. Controleer bij een portretrevisie het gezicht én de gewijzigde kleding of achtergrond voordat je de afbeelding als voltooid beschouwt.
De specifieke modelkaart beperkt uitvoer tot 1048576 pixels in totaal, gelijk aan een vierkant van 1024×1024, en staat één zijde groter dan 1024 toe als het totaal binnen die oppervlakte blijft. De servinggids vereist daarnaast dat beide afmetingen minimaal 768 pixels zijn. Een rechthoekig doel zoals 1344×768 heeft 1032192 pixels en voldoet aan die gedocumenteerde regels voor oppervlakte en minimumafmeting. De bruikbare limiet is breedte maal hoogte; bereid daarom de doelvorm voor voordat je om een landschaps- of portretcompositie vraagt.
Generatie en bewerking retourneren PNG-afbeeldingsdata in de servinginterface van de fabrikant. De oorspronkelijke modelkaart meldt een context van 32K tokens, terwijl die interface een maximale promptcontext van 32000 tokens specificeert. De afzonderlijke 4096 uitvoertokens uit de catalogus vormen een tokenruimte en geen uitvoerafmeting. Behoud die vermelde toepassingsgebieden wanneer je een gedetailleerde prompt en de voltooide afbeelding ordent. Bronbeelden, behouden kenmerken, gevraagde bewerkingen en doelformaat vormen samen met de PNG een bruikbare revisieregistratie.
Het creatieve bereik van het model omvat fotorealistische en filmische beelden, portretten, product- of merkconcepten, ontwerpen met tekst en andere visuele stijlen. Lever voor een etiket of bord de exacte tekst aan en controleer de spelling op het uiteindelijke weergaveformaat. Een herkenbaar fotografisch oppervlak kan nog steeds verzonnen details, een inconsistente reflectie of onnauwkeurige letters bevatten. Een praktische controle volgt de ontwerpeisen: objectidentiteit, leesbaarheid, ruimtelijke relaties en de behouden scène tellen allemaal mee. Houd een specifieke correctie gescheiden van veranderingen die al geslaagd zijn.
Binnen de 2.5-familie benadrukt Pro hogere getrouwheid en stabiele relaties in drukke scènes, terwijl Flash responsievere productie dient. De 2.6-familie introduceert een groter gedocumenteerd pixeloppervlaktebudget, optionele webgrounding en modelgestuurde verhoudingsselectie. Standaard 2.5 behoudt zijn eigen generatie- en bewerkingsprocedure zonder die latere instellingen. Kies de editie op basis van de uitdaging in de daadwerkelijke afbeeldingstaak en beoordeel het voltooide resultaat aan de hand van die briefing.
Ailoot Ultra · Afbeeldingen POST /v1/images/generations microsoft/mai-image-2.5
microsoft/mai-image-2.5Aan de slag
Microsoft AI MAI-Image-2.5 maakt afbeeldingen vanuit tekst en voert gerichte bewerkingen uit op aangeleverde foto's of ontwerpen. Het ondersteunt object- en tekstwijzigingen, artefactopruiming en revisies met behoud van gezichten, met PNG-uitvoer en maximaal vijf visuele referenties. De modelkaart specificeert een 32K-context en 1048576 uitvoerpixels.
- Toegestane invoer
- Tekst · Afbeeldingen
- Resultaten
- Afbeeldingen
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Afbeeldingen POST /v1/images/generations
- Invoertypen
text,image- Uitvoertypen
image
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten microsoft/mai-image-2.5 | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldaspect_ratio | Typestring | VereisteOptioneel | Waarden en limieten 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Maximum: 1 | Standaard— |
Veldinput_references | Typearray | VereisteOptioneel | Waarden en limieten Minimumaantal items: 0 Maximumaantal items: 1 | Standaard— |
Veldprovider | Typeobject | VereisteOptioneel | Waarden en limieten | Standaard— |
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt |
Parametermaterial_types | Contracttext, image |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · de daadwerkelijk geretourneerde task_id of het record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarieven
Zo worden de uiteindelijke kosten berekend
De weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn niet de definitieve factureerbare hoeveelheid.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus is geselecteerd
- Flexmodus
- Niet opgegeven Wanneer de modus flex is geselecteerd
- Maximale redeneerinspanning
- Niet opgegeven Wanneer bij maximale redeneerinspanning de default-aanpassing wordt gebruikt
Geschatte tarieven ter vergelijking
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Kosten |
|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.385024 schatting vóór generatie Deze schatting is geen extra bedrag of vast tarief voor de voltooide generatie. |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
Ailoot Ultra · Afbeeldingen
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
Resultaten ophalen en opslaan
Ailoot Ultra · Afbeeldingen
Download elke teruggegeven afbeelding of sla de Base64-inhoud ervan op
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Lezen van andere inhoud
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 voltooide resultaten bewaren
Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Bewaar het volledige antwoord en de headers, alle daadwerkelijke uitvoer, de oorspronkelijk geretourneerde identificatoren en alle gebruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de geretourneerde X-Client-Request-ID voor reconciliatie. Lees alleen daadwerkelijk geretourneerde task_id/asset_id-waarden of de eigen mediabibliotheek uit; bouw nooit een taak-URL op basis van de bewerkings-ID en dien de aanmaakaanvraag nooit opnieuw in.
Antwoordvelden
| Veld | Type |
|---|---|
Veldcreated | Type |
Velddata[].url | Type |
Velddata[].b64_json | Type |
Veldusage | Type |
Aliasnamen
Modelaliasnamen
Ailoot Ultra microsoft/mai-image-2.5
Aliasnamen voor methodepaden
/v1/images
Gerelateerde aanroeper-ID’s
FAQ · Microsoft AI: MAI-Image-2.5
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/images/generations·microsoft/mai-image-2.5:text,image→image- Welke velden gebruikt het verzoek?
POST /v1/images/generations·microsoft/mai-image-2.5:model,prompt,aspect_ratio,n,input_references,provider- Welke limieten gelden?
POST /v1/images/generations·microsoft/mai-image-2.5:n.minimum:1;n.maximum:1