Microsoft AI: MAI-Image-2.5 Pro
Microsoft AI MAI-Image-2.5 Pro genereert en bewerkt gedetailleerde afbeeldingen voor hoofdbeelden, productcomposities en precieze tekst in afbeeldingen. De Pro-editie legt de nadruk op consistente objecten, personages, materialen en ruimtelijke relaties in drukke scènes en gebruikt tekst en visuele referenties om een PNG-afbeelding te produceren.
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 Pro is de op getrouwheid gerichte editie binnen de 2.5-afbeeldingsserie. Het genereert afbeeldingen vanuit briefings in natuurlijke taal en voert gerichte bewerkingen uit op bestaand beeldmateriaal. Microsoft noemt hoofdbeelden, gedetailleerde bewerking en precieze tekst in afbeeldingen als centrale toepassingen en benadrukt in de modelvergelijking consistentie van objecten, personages, materialen en ruimtelijke relaties in complexe composities. Het uiteindelijke resultaat is een afbeelding voor een ontwerp- of productieprocedure, zoals een belangrijk productbeeld of een zorgvuldig ingedeelde redactionele scène.
Beschrijf voor generatie de compositie via relaties in plaats van een lijst ongerelateerde objecten. Benoem het hoofdonderwerp, de schaal ten opzichte van nabijgelegen voorwerpen, de materialen en de lichtrichting. Het gedocumenteerde visuele redeneervermogen van Pro is bruikbaar wanneer die relaties bepalen of een drukke scène geloofwaardig is. Plaats voor een productcompositie een keramische kan, heldere glazen en een gevouwen doek op een houten tafel, met consistente reflecties en één lichtbron vanuit een raam. Beoordeel contactpunten, schaduwen en zichtbare materiaaleigenschappen in de resulterende afbeelding.
Lever voor product- en personagewerk de visuele identiteit aan die de bewerking moet doorstaan. Microsoft beschrijft objectconsistentie in complexe scènes en personageconsistentie tussen standpunten en momenten als sterke punten van Pro. Geef aan welke kenmerken het artikel of de persoon identificeren en welk deel van de scène moet veranderen. Behoud bijvoorbeeld het silhouet en de sluitingsdetails van een jas terwijl het personage in een andere achtergrond wordt geplaatst. Een bruikbare beoordeling vergelijkt die behouden details met de bronreferentie; een visueel aantrekkelijk resultaat bewijst op zichzelf geen exacte overeenkomst.
De afbeeldingsbewerkingsinterface van de fabrikant accepteert maximaal vijf JPEG- of PNG-referenties. Scheid hun rollen in de briefing: product, persoon, omgeving of visuele behandeling. Bewerkingstaken omvatten verwijderen en vervangen van objecten, eigenschapswijzigingen, inpainting, lay-outaanpassing, tekstupdates en artefactopruiming. Beschrijf voor een lokale bewerking het doel en de te behouden omringende elementen. Leg bij een ingrijpendere herindeling uit hoe de compositie na de wijziging moet werken, zodat het model een samenhangend ruimtelijk doel heeft.
Tekstweergave is vooral relevant voor een hoofdcompositie of verpakkingsconcept. Lever de exacte zin, positie en relatie met het object of beeld aan. Houd terugkerende namen en etikettekst tussen briefing en referenties consistent. Controleer elk weergegeven teken op het gewenste weergaveformaat en vergelijk het met de aangeleverde tekst. Een latere bewerking kan zich richten op tekst of plaatsing terwijl de geslaagde productcompositie behouden blijft. De PNG-uitvoer kan daarna worden opgenomen in de lay-out waarvan de uiteindelijke typografische en uitsnede-eisen bekend zijn.
De huidige Microsoft-afbeeldingsgids past op de 2.5-modellen een maximale uitvoeroppervlakte van 1048576 pixels toe, gelijk aan 1024×1024. Beide afmetingen moeten in die interface minimaal 768 pixels zijn en een langere zijde is toegestaan wanneer de totale oppervlakte binnen de limiet blijft. Zo zijn rechthoekige composities zoals 1344×768 mogelijk, samen 1032192 pixels. Die oppervlaktebeperking verschilt van maximaal 1024 per zijde. Bereid de doelvorm voor de compositie voor in plaats van te verwachten dat een algemeen beeldverhoudingslabel de uitsnede correct bepaalt.
De servinggids specificeert een maximale promptcontext van 32000 tokens en retourneert PNG-afbeeldingsdata voor zowel generatie als bewerking. De specifieke Pro-cataloguspagina vermeldt afzonderlijk een contextvenster van 131,072K en 4096 uitvoertokens. Dit zijn gepubliceerde tokenhoeveelheden met hun eigen catalogus- of servingbereik; praktische voorbereiding van afbeeldingsaanvragen volgt de prompt- en pixellimieten van serving. Bewaar afbeelding, bronreferenties en briefing als één revisieregistratie. Controleer het visuele resultaat zelf op de gedetailleerde eisen voor identiteit, materiaal en geometrie die de keuze voor Pro motiveerden.
De versie moet bij de compositie passen. Standaard MAI-Image-2.5 dekt algemene generatie en lokale bewerking; Pro voegt de nadruk van de serie op getrouwheid en consistente relaties in visueel drukke scènes toe. De 2.6-familie verhoogt de gedocumenteerde uitvoeroppervlaktelimiet en voegt optionele webgrounding en automatische verhoudingsselectie toe. Die latere instellingen horen specifiek bij 2.6 en bepalen niet de procedure van deze Pro-editie. Kies Pro wanneer de uitdaging in de briefing draait om stabiele objectidentiteit, materiaaluiterlijk of ruimtelijke structuur binnen een gedetailleerde afbeelding.
Beoordeel zowel de gevraagde wijziging als de behouden inhoud. Handen die objecten vasthouden, kruisingen, kleine lettertjes, gezichtsidentiteit en reflecties zijn nuttige controlepunten in een complexe compositie. Een aannemelijke afbeelding kan nog steeds een misleidende markering of verkeerde fysieke relatie bevatten. Maak de volgende correctie concreet en behoud de delen van de briefing die de gewenste lay-out opleverden. Dit ondersteunt een gecontroleerde reeks ontwerprevisies in plaats van de hele scène telkens opnieuw te definiëren.
Ailoot Ultra · Afbeeldingen POST /v1/images/generations microsoft/mai-image-2.5-pro
microsoft/mai-image-2.5-proAan de slag
Microsoft AI MAI-Image-2.5 Pro genereert en bewerkt gedetailleerde afbeeldingen voor hoofdbeelden, productcomposities en precieze tekst in afbeeldingen. De Pro-editie legt de nadruk op consistente objecten, personages, materialen en ruimtelijke relaties in drukke scènes en gebruikt tekst en visuele referenties om een PNG-afbeelding te produceren.
- 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-pro | 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.884736 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-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
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-pro
Aliasnamen voor methodepaden
/v1/images
Gerelateerde aanroeper-ID’s
FAQ · Microsoft AI: MAI-Image-2.5 Pro
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/images/generations·microsoft/mai-image-2.5-pro:text,image→image- Welke velden gebruikt het verzoek?
POST /v1/images/generations·microsoft/mai-image-2.5-pro:model,prompt,aspect_ratio,n,input_references,provider- Welke limieten gelden?
POST /v1/images/generations·microsoft/mai-image-2.5-pro:n.minimum:1;n.maximum:1