models

Microsoft AI: MAI-Image-2.5 Pro

Markdown · JSON

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 het beeld. De Pro-editie benadrukt 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-beeldreeks. Het genereert afbeeldingen vanuit briefings in natuurlijke taal en voert gerichte bewerkingen uit op bestaand materiaal. Microsoft noemt hoofdbeelden, gedetailleerde bewerking en precieze tekst in beelden als centrale toepassingen; de modelvergelijking benadrukt consistentie van objecten, personages, materialen en ruimtelijke relaties in complexe composities. Het uiteindelijke resultaat is een afbeelding voor een ontwerp- of productieworkflow, zoals een belangrijk productbeeld of een zorgvuldig opgebouwde 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 nabije voorwerpen, de gebruikte materialen en de lichtrichting. Het gedocumenteerde visuele redeneervermogen van de Pro-editie is nuttig wanneer die relaties bepalen of een drukke scène geloofwaardig is. Plaats voor een productcompositie een keramische kan, heldere glazen en een geplooide doek op een houten tafel, met consistente reflecties en één raam als lichtbron. 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 aanzichten en momenten als sterke punten van Pro. Geef aan welke kenmerken het voorwerp of de persoon identificeren en welk aspect van de scène moet veranderen. Behoud bijvoorbeeld silhouet en sluitingsdetails van een jas terwijl je het personage in een andere achtergrond plaatst. De nuttige beoordeling vergelijkt die behouden details met de bronreferentie; een visueel aantrekkelijk resultaat bewijst op zichzelf geen exacte overeenkomst.

De beeldbewerkingsinterface van de fabrikant accepteert maximaal vijf JPEG- of PNG-referenties. Scheid hun rollen in de briefing: product, persoon, omgeving of visuele uitwerking. Bewerkingstaken omvatten objecten verwijderen en vervangen, kenmerken wijzigen, inpainting, lay-outaanpassing, tekstupdates en het wegwerken van artefacten. Beschrijf voor een lokale bewerking het doel en de omliggende elementen die moeten blijven. Leg voor een ingrijpendere herschikking uit hoe de compositie na de wijziging moet werken, zodat het model een samenhangend ruimtelijk doel heeft.

Tekstweergave is bijzonder relevant voor een hoofdcompositie of verpakkingsconcept. Geef de exacte zin, de positie en het verband met object of beeld op. Hou terugkerende namen en etikettekst gelijk tussen briefing en referenties. Controleer elk weergegeven teken op de bedoelde weergavegrootte en vergelijk het met de aangeleverde formulering. Een latere bewerking kan zich op tekst of plaatsing richten met behoud van de geslaagde productcompositie. De PNG-uitvoer kan daarna in de lay-out worden verwerkt waarvan de definitieve typografie- en uitsnedevereisten bekend zijn.

De huidige beeldgids van Microsoft past een maximale uitvoeroppervlakte van 1.048.576 pixels toe op de 2.5-modellen, gelijk aan 1024×1024. Beide afmetingen moeten in die interface minstens 768 pixels zijn en een langere zijde is toegestaan wanneer de totale oppervlakte binnen de limiet blijft. Dat laat rechthoekige composities toe, zoals 1344×768, goed voor 1.032.192 pixels. Die oppervlaktevoorwaarde verschilt van een maximum van 1024 per zijde. Bereid de doelvorm voor de compositie voor in plaats van te verwachten dat een algemeen beeldverhoudingslabel de uitsnede juist bepaalt.

De servinggids specificeert maximaal 32.000 tokens promptcontext en geeft PNG-afbeeldingsdata terug voor generatie én bewerking. De specifieke Pro-cataloguspagina vermeldt afzonderlijk een contextvenster van 131.072K en 4.096 uitvoertokens. Dit zijn gepubliceerde tokenhoeveelheden met een eigen catalogus- of servingreikwijdte; de praktische voorbereiding van beeldaanvragen volgt de servinglimieten voor prompts en pixels. Bewaar afbeelding, bronreferenties en briefing als één herzieningsrecord. Controleer het visuele resultaat zelf op de gedetailleerde vereisten voor identiteit, materiaal en geometrie die de keuze voor Pro motiveerden.

De versiekeuze moet de compositie volgen. Standaard MAI-Image-2.5 dekt algemene generatie en lokale bewerkingen; Pro voegt de nadruk van de reeks op getrouwheid en consistente relaties in visueel drukke scènes toe. De 2.6-familie verhoogt de gedocumenteerde uitvoeroppervlaktelimiet en voegt optionele webonderbouwing en automatische verhoudingsselectie toe. Die latere instellingen zijn specifiek voor 2.6 en bepalen niet de workflow van deze Pro-editie. Kies Pro wanneer het moeilijke deel van de briefing draait om stabiele objectidentiteit, materiaaluiterlijk of ruimtelijke structuur in een gedetailleerd beeld.

Beoordeel zowel de gevraagde wijziging als de behouden inhoud. Handen die objecten vasthouden, kruisingen, kleine tekst, gezichtsgelijkenis en reflecties zijn nuttige controlepunten in een complexe compositie. Een geloofwaardig beeld kan toch een misleidende markering of onjuiste fysieke relatie bevatten. Maak de volgende correctie concreet en behoud de briefingonderdelen die de bedoelde lay-out opleverden. Zo ontstaat een gecontroleerde reeks ontwerpherzieningen in plaats van steeds de volledige scène opnieuw te definiëren.

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

microsoft/mai-image-2.5-pro

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

Aan de slag

Microsoft AI MAI-Image-2.5 Pro genereert en bewerkt gedetailleerde afbeeldingen voor hoofdbeelden, productcomposities en precieze tekst in het beeld. De Pro-editie benadrukt 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
Invoer
text, image
Uitvoer
image
VeldTypeVereisteWaarden en limietenStandaard
VeldmodelTypestringVereisteVereistWaarden en limieten
microsoft/mai-image-2.5-pro
Standaard—
VeldpromptTypestringVereisteVereistWaarden en limieten
Minimumlengte: 1
Standaard—
Veldaspect_ratioTypestringVereisteOptioneelWaarden en limieten
1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto
Standaard—
VeldnTypeintegerVereisteOptioneelWaarden en limieten
Minimum: 1
Maximum: 1
Standaard—
Veldinput_referencesTypearrayVereisteOptioneelWaarden en limieten
Minimumaantal items: 0
Maximumaantal items: 1
Standaard—
VeldproviderTypeobjectVereisteOptioneelWaarden en limietenStandaard—
Methodeparameters en levenscyclus
ParameterContract
Parametercontent_typeContractapplication/json
ParameterrequiredContractmodel, prompt
Parametermaterial_typesContracttext, image

Levenscyclus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · daadwerkelijk teruggegeven task_id of 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 getoonde tarieven ramen de kosten vóór de generatie. De definitieve kosten worden berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van het gegenereerde resultaat en de geraamde hoeveelheden vormen 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 geselecteerd is
Flex-modus
Niet opgegeven Wanneer de flex-modus geselecteerd is
Maximale redeneerinspanning
Niet opgegeven Wanneer voor 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.

ConfiguratieTariefstaffelVerwachte hoeveelheidKosten
ConfiguratieBasistarieven voor tokensTariefstaffelBasistariefVerwachte 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 generatiekostenTariefstaffel—Verwachte hoeveelheidschatting voor één generatieKosten
Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.884736 schatting vóór generatie

Deze raming is geen extra kost 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

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

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}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Lezen van andere inhoud
Bestaande eigen bestanden ophalen
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 de volledige respons en headers, iedere daadwerkelijke uitvoer, de oorspronkelijk teruggegeven identificatoren en alle verbruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.

Als het oorspronkelijke antwoord moet worden gecontroleerd

Bewaar de teruggegeven X-Client-Request-ID voor de reconciliatie. Lees uitsluitend daadwerkelijk teruggegeven 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
VeldType
VeldcreatedType
Velddata[].urlType
Velddata[].b64_jsonType
VeldusageType

Aliasnamen

Modelaliasnamen

Ailoot Ultra microsoft/mai-image-2.5-pro

Aliasnamen voor methodepaden

/v1/images

Gerelateerde aanroeper-ID’s

microsoft/mai-image-2.5-pro

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

Meer details

Verbind Ailoot met Claude Code, OpenCode, Hermes of je eigen applicatie.

Het bedrijf en zijn projectenportefeuille

Het bedrijf en zijn projectenportefeuille: miljoenen klanten; maandelijkse verkopen in de miljarden.

Koop tokens met korting.

Abonnementsvoordeel voor regelmatig gebruik. Promotiecodes geven tot 50% korting op tokens.

Abonnement
Kies een abonnement met korting voor je terugkerende verzoeken.
Promotiecode tot 50%
Vul de code bij aankoop in. De prijs wordt volgens de lopende actie herberekend.
Kosten in de geschiedenis
Model, tokens en bedrag worden per verzoek bewaard.

Kies een abonnement · Bekijk modelprijzen

Verbind de API met het product dat je verkoopt.

SaaS, apps en bots volgens de openbare aanbodvoorwaarden en licentieovereenkomst van Ailoot. Vraag voor doorverkoop een resellerlicentie aan.

Commerciële applicatie
Voeg tekst-, beeld-, video- en geluidsgeneratie aan betaalde functies van je service toe.
Resellerlicentie
Stuur een projectbeschrijving en toegangsschema. Vraag schriftelijke voorwaarden voor gebruik en doorverkoop.
Documenten op de site
Aanbodvoorwaarden, licentieovereenkomst en gegevensbeleid zijn vóór het verbinden beschikbaar.

Vraag een resellerlicentie aan · Aanbodvoorwaarden en licentieovereenkomst