Source: https://ailoot.ai/models/nl-be/microsoft-mai-image-2-5/
Canonical: https://ailoot.ai/models/nl-be/microsoft-mai-image-2-5/
Language: nl-be

# Microsoft AI: MAI-Image-2.5

[Markdown](https://ailoot.ai/models/nl-be/microsoft-mai-image-2-5/index.md) · [JSON](https://ailoot.ai/models/nl-be/microsoft-mai-image-2-5/facts.json)

## [Microsoft AI: MAI-Image-2.5](https://ailoot.ai/models/nl-be/microsoft-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, het wegwerken van artefacten en herzieningen met behoud van het gezicht, met PNG-uitvoer en maximaal vijf visuele referenties. De modelkaart specificeert een context van 32K en 1.048.576 uitvoerpixels.

- [**Ailoot Ultra · Afbeeldingen** `POST /v1/images/generations` `microsoft/mai-image-2.5`](https://ailoot.ai/models/nl-be/microsoft-mai-image-2-5/#method-0)

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 van de 2.5-beeldfamilie. De modelkaart beschrijft een diffusiemodel met flow matching, met 20 miljard parameters buiten de embeddings, tekst- en beeldinvoer en een context van 32K tokens. Het levert beelduitvoer voor concepten, portretten, productbeelden, illustraties en herzieningen van bestaande ontwerpen. De nuttige eerste keuze is of de taak een nieuwe compositie vraagt of een specifieke wijziging aan materiaal dat het bedoelde onderwerp al bevat.

Beschrijf voor generatie hoofdonderwerp, visuele stijl, licht, standpunt en opstelling. 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 omliggende ruimte vastleggen. Een productconcept kan materiaal, schaal en oppervlakteafwerking opnemen. Hou de beschrijving samenhangend, zodat objecten één scène en één lichtplan delen in plaats van meerdere onverenigbare visuele uitwerkingen te combineren.

Visueel redeneren in deze editie betreft 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 klein krukje naast een werkbank met behoud van bestaand standpunt en licht. Vergelijk bij de beoordeling de grootte van het krukje, waar het de vloer raakt en of de schaduw die van andere objecten volgt. Een lokaal overtuigend object moet ook passen in de geometrie van de volledige bronafbeelding.

Gerichte bewerkingen omvatten objecten verwijderen of vervangen, kenmerken wijzigen, inpainting, lay-outaanpassing, tekstupdates en opschoning zoals vermindering van bewegingsonscherpte-artefacten. Lever de bronafbeelding aan en benoem zowel de correctie als de te behouden details. Een gerichte fotobewerking kan een storend object uit de achtergrond verwijderen met behoud van persoon, uitsnede en voorgrondopstelling. Een ontwerpherziening kan een korte tekstregel bijwerken met behoud van de compositie. Vergelijk het volledige resultaat met de bron in plaats van alleen het bewerkte gebied te beoordelen.

Microsoft benadrukt ook consistentie van gezichtsidentiteit tussen bewerkingen, inclusief veranderingen van 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 portretherziening het gezicht én de gewijzigde kleding of achtergrond voordat je het beeld als afgewerkt beschouwt.

De specifieke modelkaart beperkt de uitvoer tot 1.048.576 pixels in totaal, gelijk aan een vierkant van 1024×1024, en staat toe dat één zijde groter is dan 1024 als het totaal binnen die oppervlakte blijft. De servinggids vereist bovendien dat beide afmetingen minstens 768 pixels zijn. Een rechthoekig doel zoals 1344×768 telt 1.032.192 pixels en voldoet aan die gedocumenteerde regels voor oppervlakte en minimumafmetingen. De bruikbare limiet is het product van breedte en hoogte, dus bereid de doelvorm voor voordat je een liggende of staande compositie vraagt.

Generatie en bewerking geven PNG-afbeeldingsdata terug in de servinginterface van de fabrikant. De native modelkaart meldt een context van 32K tokens, terwijl die interface maximaal 32.000 tokens promptcontext specificeert. Het afzonderlijke getal van 4.096 uitvoertokens in de catalogus is een tokenruimte, geen uitvoerafmeting. Behoud die opgegeven reikwijdtes bij het ordenen van een gedetailleerde prompt en het afgewerkte beeld. Bronmateriaal, behouden kenmerken, gevraagde bewerkingen en doelformaat vormen samen een nuttig herzieningsrecord bij de PNG.

Het creatieve bereik van het model omvat fotorealistische en filmische beelden, portretten, product- of merkconcepten, ontwerpen met tekst en andere visuele stijlen. Geef voor een etiket of bord de exacte tekst op en controleer de spelling op de uiteindelijke weergavegrootte. Een herkenbaar fotografisch oppervlak kan toch verzonnen details, een inconsistente reflectie of onjuiste letters bevatten. Een praktische controle volgt de ontwerpvereisten: objectidentiteit, leesbaarheid, ruimtelijke relaties en de behouden scène tellen allemaal. Hou een specifieke correctie gescheiden van wijzigingen die al geslaagd zijn.

Binnen de 2.5-familie benadrukt Pro hogere getrouwheid en stabiele relaties in drukke scènes, terwijl Flash vlottere productie dient. De 2.6-familie introduceert een grotere gedocumenteerde pixeloppervlakte, optionele webonderbouwing en modelgestuurde verhoudingsselectie. Standaard 2.5 behoudt zijn eigen generatie- en bewerkingsworkflow zonder die latere instellingen. Kies de editie op basis van het moeilijke deel van de daadwerkelijke beeldtaak en vergelijk het voltooide resultaat met die briefing.

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

[`microsoft/mai-image-2.5`](https://ailoot.ai/models/nl-be/#m=microsoft%2Fmai-image-2.5&route=Ultra&caller=microsoft%2Fmai-image-2.5&fmt=images)

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

### Aan 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, het wegwerken van artefacten en herzieningen met behoud van het gezicht, met PNG-uitvoer en maximaal vijf visuele referenties. De modelkaart specificeert een context van 32K en 1.048.576 uitvoerpixels.

Toegestane invoer

Tekst · Afbeeldingen

Resultaten

Afbeeldingen

### Beschikbaar in Ailoot · invoer en methoden

**Ailoot Ultra · Afbeeldingen** `POST /v1/images/generations`

Invoer

`text`, `image`

Uitvoer

`image`

| Veld | Type | Vereiste | Waarden en limieten | Standaard |
| --- | --- | --- | --- | --- |
| Veld`model` | Type`string` | VereisteVereist | Waarden en limieten microsoft/mai-image-2.5 | Standaard— |
| Veld`prompt` | Type`string` | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
| Veld`aspect_ratio` | Type`string` | VereisteOptioneel | Waarden en limieten 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto | Standaard— |
| Veld`n` | Type`integer` | VereisteOptioneel | Waarden en limieten Minimum: 1 Maximum: 1 | Standaard— |
| Veld`input_references` | Type`array` | VereisteOptioneel | Waarden en limieten Minimumaantal items: 0 Maximumaantal items: 1 | Standaard— |
| Veld`provider` | Type`object` | VereisteOptioneel | Waarden en limieten | Standaard— |

Methodeparameters en levenscyclus

| Parameter | Contract |
| --- | --- |
| Parameter`content_type` | Contractapplication/json |
| Parameter`required` | Contractmodel, prompt |
| Parameter`material_types` | Contracttext, 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.

| 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 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 →](https://ailoot.ai/docs/nl-be/billing/reserve/)

### Voorbeeldverzoeken

#### Ailoot Ultra · Afbeeldingen

curl

```bash
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}/content`
- `GET /v1/media/assets`
- `GET /v1/media/assets/{asset_id}`

Lezen van andere inhoud

Bestaande eigen bestanden ophalen

```bash
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

| Veld | Type |
| --- | --- |
| Veld`created` | Type |
| Veld`data[].url` | Type |
| Veld`data[].b64_json` | Type |
| Veld`usage` | Type |

### Aliasnamen

#### Modelaliasnamen

**Ailoot Ultra** [`microsoft/mai-image-2.5`](https://ailoot.ai/models/nl-be/#m=microsoft%2Fmai-image-2.5&route=Ultra&caller=microsoft%2Fmai-image-2.5&fmt=images)

#### Aliasnamen voor methodepaden

`/v1/images`

#### Gerelateerde aanroeper-ID’s

[`microsoft/mai-image-2.5`](https://ailoot.ai/models/nl-be/#m=microsoft%2Fmai-image-2.5&route=Ultra&caller=microsoft%2Fmai-image-2.5&fmt=images)

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`

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](https://ailoot.ai/docs/nl-be/billing/subscriptions/) · [Bekijk modelprijzen](https://ailoot.ai/models/nl-be/)

## 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](mailto:support@ailoot.ai) · [Aanbodvoorwaarden en licentieovereenkomst](https://ailoot.ai/legal/offer?lang=nl-be)

## Ailoot · Het bedrijf en zijn projectenportefeuille





Ailoot bouwt op opgebouwde operationele ervaring, een groot klantenbestand, een stabiele dienst en doorlopende KPI-controle.





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





Ailoot gebruikt die operationele ervaring voor API-toegang tot AI-functies in klantproducten, agents, applicaties en automatiseringen.
