Microsoft AI: MAI-Image-2.5 Pro

Microsoft AI MAI-Image-2.5 Pro genererar och redigerar detaljerade bilder för huvudbilder, produktkompositioner och exakt text i bilden. Pro-utgåvan betonar konsekventa föremål, karaktärer, material och rumsliga relationer i täta scener och använder text och visuella referenser för att producera en PNG-bild.

Ailoot Ultra · Bilder POST /v1/images/generations microsoft/mai-image-2.5-pro

Om modellen

Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.

Microsoft AI MAI-Image-2.5 Pro är utgåvan med fokus på återgivningstrohet inom bildserien 2.5. Den genererar bilder från instruktioner på naturligt språk och utför riktade redigeringar av befintligt material. Microsoft identifierar huvudbilder, detaljerad redigering och exakt text i bilden som centrala användningar, och modelljämförelsen framhäver konsekventa föremål, karaktärer, material och rumsliga relationer i komplexa kompositioner. Slutleveransen är en bild för ett design- eller produktionsflöde, till exempel en central produktbild eller en noggrant arrangerad redaktionell scen.

För generering beskriver du kompositionen genom relationer i stället för en lista av orelaterade föremål. Ange huvudmotiv, dess skala i relation till närliggande föremål, berörda material och ljusriktning. Pro-utgåvans dokumenterade visuella resonemang är användbart där dessa relationer avgör om en tät scen är trovärdig. En produktkomposition kan placera en keramikkanna, klara glas och en vikt duk på ett träbord, med konsekventa reflexer och ljus från ett enda fönster. Granska kontakter, skuggor och synliga materialegenskaper i resultatbilden.

För produkt- och karaktärsarbete skickar du in den visuella identitet som måste överleva redigeringen. Microsoft beskriver objektkonsekvens i komplexa scener och karaktärskonsekvens mellan vyer och ögonblick som styrkor hos Pro. Ange vilka egenskaper som identifierar föremålet eller personen och vilken aspekt av scenen som ska ändras. Behåll exempelvis en jackas silhuett och fästdetaljer medan karaktären placeras mot en annan bakgrund. En användbar granskning jämför de bevarade detaljerna med källreferensen; ett visuellt attraktivt resultat bevisar inte i sig en exakt matchning.

Tillverkarens bildredigeringsgränssnitt tar emot upp till fem JPEG- eller PNG-referenser. Skilj deras roller åt i instruktionen: produkten, personen, miljön eller den visuella behandlingen. Redigeringsuppgifter omfattar borttagning och utbyte av föremål, egenskapsändringar, inpainting, layoutanpassning, textuppdateringar och artefaktstädning. För en lokal redigering beskriver du målet och omgivande element som ska bevaras. För en mer omfattande ommöblering förklarar du hur kompositionen ska fungera efter ändringen så att modellen får ett sammanhängande rumsligt mål.

Textrendering är särskilt relevant för en huvudkomposition eller ett förpackningskoncept. Ange den exakta frasen, dess position och relation till föremålet eller bilden. Håll återkommande namn och etiketttext konsekventa mellan instruktion och referenser. Granska varje renderat tecken i avsedd visningsstorlek och jämför det med angiven ordalydelse. En senare redigering kan fokusera på ordalydelse eller placering och samtidigt behålla den lyckade produktkompositionen. PNG-bilden kan sedan föras in i layouten vars slutliga krav på typografi och beskärning är kända.

Nuvarande Microsoft-bildguide tillämpar en maximal utdataarea på 1 048 576 pixlar för modellerna i 2.5, motsvarande 1024×1024. Båda dimensionerna måste vara minst 768 pixlar i det gränssnittet och en längre sida tillåts när totalarean håller sig inom gränsen. Detta möjliggör rektangulära kompositioner som 1344×768, totalt 1 032 192 pixlar. Areabegränsningen skiljer sig från ett maximum på 1024 per sida. Förbered målformen för kompositionen i stället för att förvänta dig att en allmän bildförhållandeetikett ska avgöra beskärningen rätt.

Tjänstguiden anger högst 32 000 token i promptkontext och returnerar PNG-bilddata för både generering och redigering. Den specifika katalogsidan för Pro listar separat ett kontextfönster på 131.072K och 4 096 utdatatoken. Dessa är publicerade tokenmängder med eget katalog- eller tjänstomfång; den praktiska förberedelsen av en bildförfrågan följer tjänstens prompt- och pixelgränser. Behåll bild, källreferenser och instruktion som ett revideringsunderlag. Kontrollera själva bildresultatet mot de detaljerade identitets-, material- och geometrikrav som motiverade valet av Pro.

Versionsvalet bör följa kompositionen. Vanliga MAI-Image-2.5 täcker allmän generering och lokala redigeringar; Pro lägger till seriens fokus på återgivningstrohet och konsekventa relationer i visuellt täta scener. Familjen 2.6 höjer den dokumenterade areagränsen för utdata och lägger till valfri webbförankring och automatiskt bildförhållande. Dessa senare kontroller hör specifikt till 2.6 och definierar inte arbetsflödet för denna Pro-utgåva. Välj Pro när instruktionens svåra del gäller stabil objektidentitet, materialutseende eller rumslig struktur i en detaljerad bild.

Granska både begärd ändring och bevarat innehåll. Händer som håller föremål, korsningar, finstilt text, ansiktslikhet och reflexer är bra granskningspunkter i en komplex komposition. En rimlig bild kan fortfarande innehålla vilseledande märkning eller en felaktig fysisk relation. Gör nästa korrigering konkret och behåll instruktionens delar som gav avsedd layout. Detta stöder en kontrollerad följd av designrevideringar i stället för att hela scenen definieras om varje gång.

Ailoot Ultra · Bilder POST /v1/images/generations microsoft/mai-image-2.5-pro

microsoft/mai-image-2.5-pro

Microsoft AI /microsoft/mai-image-2.5-pro

Start

Godkända indata: Text · Bilder
Resultat: Bilder

Tillgängligt i Ailoot · indata & metoder

Ailoot Ultra · Bilder POST /v1/images/generations

Indatatyper: text, image
Utdatatyper: image

Fält	Typ	Krav	Värden & gränser	Standard
Fält`model`	Typ`string`	KravObligatoriskt	Värden & gränser microsoft/mai-image-2.5-pro	Standard—
Fält`prompt`	Typ`string`	KravObligatoriskt	Värden & gränser Minsta längd: 1	Standard—
Fält`aspect_ratio`	Typ`string`	KravValfritt	Värden & gränser 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto	Standard—
Fält`n`	Typ`integer`	KravValfritt	Värden & gränser Minimum: 1 Maximum: 1	Standard—
Fält`input_references`	Typ`array`	KravValfritt	Värden & gränser Minsta antal objekt: 0 Maximalt antal objekt: 1	Standard—
Fält`provider`	Typ`object`	KravValfritt	Värden & gränser	Standard—

Metodparametrar och livscykel

Parameter	Avtal
Parameter`content_type`	Avtalapplication/json
Parameter`required`	Avtalmodel, prompt
Parameter`material_types`	Avtaltext, image

Livscykel: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Det task_id som faktiskt returnerades eller en post i mediebiblioteket

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Priser

Så beräknas slutavgiften

De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.

Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.

Snabbt läge: Ej angivet När snabbt läge är valt
Flex-läge: Ej angivet När läget flex är valt
Högsta resonemangsnivå: Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)

Uppskattade priser för jämförelse

Priser efter konfiguration

Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.

Konfiguration	Prislista	Prognostiserad mängd	Avgift
KonfigurationGrundpriser för token	PrislistaGrundpris	Prognostiserad mängd—	Avgift Indata · Indatatoken · Uppskattning endast för jämförelse — / 1K token Utdata · Utdatatoken · Uppskattning endast för jämförelse — / 1K token Indata · Cacheläsning · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache, 1 tim · Uppskattning endast för jämförelse — / 1K token
KonfigurationUppskattad genereringskostnad	Prislista—	Prognostiserad mängduppskattning för en generering	Avgift Utdata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $0.884736 uppskattning före generering Denna uppskattning är varken en extra avgift eller ett fast pris för den slutförda genereringen.

Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →

Exempelbegäranden

Ailoot Ultra · Bilder

curl

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

Ta emot och spara resultat

Ailoot Ultra · Bilder

Ladda ned varje returnerad bild eller spara dess Base64-innehåll

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Andra innehållsläsningar

Läs befintliga resurser som tillhör dig

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.

Behåll alla färdiga resultat

Spara varje färdig bild; hämta varje returnerad URL eller avkoda dess Base64-innehåll.

Spara hela svaret med headers, samtliga faktiska resultat, de ursprungliga returnerade identifierarna och alla användningsfält. Hämta den ursprungliga operationen utan att skicka skapandeförfrågan igen.

Om det ursprungliga svaret behöver kontrolleras

Behåll det returnerade värdet för X-Client-Request-ID för avstämning. Läs endast av resultat via de task_id/asset_id-värden som faktiskt returnerades eller via det mediebibliotek som tillhör dig. Bygg aldrig en uppgifts-URL från operations-ID:t och skicka aldrig skapandeförfrågan igen.

Svarsfält

Fält	Typ
Fält`created`	Typ
Fält`data[].url`	Typ
Fält`data[].b64_json`	Typ
Fält`usage`	Typ

Alias

Modellalias

Ailoot Ultra microsoft/mai-image-2.5-pro

Alias för metodsökvägar

/v1/images

Relaterade anropar-ID:n

microsoft/mai-image-2.5-pro

FAQ · Microsoft AI: MAI-Image-2.5 Pro

Vilka indata och resultat finns?: POST /v1/images/generations · microsoft/mai-image-2.5-pro: text, image → image
Vilka fält använder begäran?: POST /v1/images/generations · microsoft/mai-image-2.5-pro: model, prompt, aspect_ratio, n, input_references, provider
Vilka gränser gäller?: POST /v1/images/generations · microsoft/mai-image-2.5-pro: n.minimum: 1; n.maximum: 1

Microsoft AI: MAI-Image-2.5 Pro