Microsoft AI: MAI-Image-2.5

Microsoft AI MAI-Image-2.5 luo kuvia tekstistä ja tekee kohdennettuja muutoksia annettuihin valokuviin tai suunnitelmiin. Se tukee esine- ja tekstimuutoksia, virheiden siistimistä sekä kasvot säilyttäviä muokkauksia, PNG-tulosta ja enintään viittä visuaalista viitettä. Mallikortti määrittelee 32K-kontekstin ja 1 048 576 tulospikseliä.

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

Tietoa mallista

Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.

Microsoft AI MAI-Image-2.5 on 2.5-kuvaperheen yleiseen generointiin ja hallittuun muokkaukseen tarkoitettu versio. Mallikortti kuvaa flow matching -menetelmää käyttävän diffuusiomallin, jossa on 20 miljardia muuta kuin upotusparametria, teksti- ja kuvasyöte sekä 32K tokenin konteksti. Se tuottaa kuvia konsepteihin, muotokuviin, tuotekuvastoon, kuvituksiin ja olemassa olevien suunnitelmien muutoksiin. Hyödyllinen lähtövalinta on, tarvitseeko tehtävä uuden sommitelman vai tietyn muutoksen aineistoon, jossa haluttu kohde jo on.

Kuvaile generointia varten pääkohde, visuaalinen tyyli, valo, näkökulma ja järjestely. Valmistaja painottaa yksityiskohtaisia, yhtenäisiä kuvia, tekstin muodostamista, tuotekuvastoa ja kehotteen noudattamista. Käytännön esityskuvituksen ohje voi määritellä kohteen roolin, halutun visuaalisen painotuksen ja ympäröivän tilan määrän. Tuotekonsepti voi sisältää materiaalin, mittakaavan ja pintaviimeistelyn. Pidä kuvaus yhtenäisenä, jotta esineillä on yksi kohtaus ja valaistussuunnitelma usean yhteensopimattoman visuaalisen käsittelyn yhdistämisen sijaan.

Tämän version visuaalinen päättely koskee kohtauksen rakennetta, valaistusta, mittakaavaa ja tilallisia suhteita. Valmistaja antaa muokkauskäyttönä esineen lisäämisen sopivalla perspektiivillä ja varjoilla. Työpajamuokkauksessa sijoita pieni jakkara työpöydän viereen ja säilytä olemassa oleva näkökulma ja valo. Arvioinnin tulee verrata jakkaran kokoa, sen lattiaan koskevaa kohtaa sekä varjon yhdenmukaisuutta muiden esineiden kanssa. Paikallisesti vakuuttavankin esineen tulee sopia koko lähdekuvan geometriaan.

Ohjattuihin muokkauksiin kuuluvat esineen poistaminen tai korvaaminen, ominaisuusmuutokset, inpainting, asettelun mukauttaminen, tekstipäivitykset ja siistiminen, kuten liike-epäterävyyden virheiden vähentäminen. Anna lähdekuva ja nimeä sekä korjaus että säilytettävät yksityiskohdat. Rajattu valokuvamuokkaus voi poistaa häiritsevän taustaesineen mutta säilyttää henkilön, rajauksen ja etualan järjestelyn. Suunnittelumuutos voi päivittää lyhyen tekstirivin sommittelun säilyessä. Vertaa koko tulosta lähteeseen pelkän muokatun alueen arvioinnin sijaan.

Microsoft painottaa myös kasvojen identiteetin yhtenäisyyttä muokkauksissa, mukaan lukien asennon, ilmeen tai näkökulman muutokset. Käytä selkeää yhdennäköisyysviitettä ja määrittele haluttu muutos tunnistavat piirteet säilyttävällä tavalla. Valmistajan nykyinen muokkausopas hyväksyy enintään viisi JPEG- tai PNG-kuvaa, jolloin eri viitteet voivat yksilöidä henkilön, esineen, kohtauksen tai tyylin. Nimeä nämä roolit kehotteessa. Tarkasta muotokuvamuutoksessa kasvot muuttuneen vaatetuksen tai taustan lisäksi ennen kuvan pitämistä valmiina.

Nimenomainen mallikortti rajaa tuloksen yhteensä 1 048 576 pikseliin, mikä vastaa 1024×1024-neliötä, ja sallii yhden sivun ylittää 1024 kokonaismäärän pysyessä pinta-alan sisällä. Palveluopas vaatii lisäksi molemmilta mitoilta vähintään 768 pikseliä. Esimerkiksi 1344×768-suorakulmiossa on 1 032 192 pikseliä, ja se täyttää dokumentoidut pinta-ala- ja vähimmäismittasäännöt. Hyödyllinen raja on leveyden ja korkeuden tulo, joten valmistele käyttökohteen muoto ennen vaaka- tai pystysommitelman pyytämistä.

Generointi ja muokkaus palauttavat PNG-kuvadataa valmistajan palvelurajapinnassa. Alkuperäinen mallikortti ilmoittaa 32K tokenin kontekstin, kun taas rajapinta määrittelee kehotekontekstin enimmäiskooksi 32 000 tokenia. Katalogin erillinen 4 096 tulostokenin luku on tokenimääräraja, ei tulosmitta. Säilytä nämä ilmoitetut soveltamisalat yksityiskohtaista kehotetta ja valmista kuvaa järjestäessäsi. Lähdeaineistot, säilytetyt piirteet, pyydetyt muokkaukset ja kohdekoko muodostavat hyödyllisen muutostietueen PNG:n rinnalle.

Mallin luova alue kattaa fotorealistisen ja elokuvallisen kuvaston, muotokuvat, tuote- tai brändikonseptit, tekstiä sisältävät suunnitelmat ja muut visuaaliset tyylit. Anna etikettiin tai kylttiin tarkka sanamuoto ja tarkasta oikeinkirjoitus lopullisessa näyttökoossa. Tunnistettava valokuvamainen pinta voi silti sisältää keksittyjä yksityiskohtia, epäjohdonmukaisen heijastuksen tai epätarkkaa tekstiä. Käytännön tarkistus seuraa suunnittelun vaatimuksia: esineen identiteetti, luettavuus, tilalliset suhteet ja säilytettävä kohtaus ovat tärkeitä. Pidä tietty korjaus erillään jo onnistuneista muutoksista.

2.5-perheessä Pro painottaa suurempaa uskollisuutta ja vakaita suhteita tiheissä kohtauksissa, Flash taas ripeämpää tuotantoa. 2.6-perhe tuo suuremman dokumentoidun pikselipinta-alarajan, valinnaisen verkkotietoon perustamisen ja mallin ohjaaman kuvasuhteen valinnan. Tavallinen 2.5 säilyttää oman generointi- ja muokkaustyönkulkunsa ilman näitä myöhempiä asetuksia. Valitse versio varsinaisen kuvatehtävän vaikean osan perusteella ja arvioi valmis tulos kyseistä ohjetta vasten.

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

microsoft/mai-image-2.5

Microsoft AI /microsoft/mai-image-2.5

Aloitus

Hyväksytyt syötteet: Teksti · Kuvat
Tulokset: Kuvat

Saatavilla Ailootissa · syötteet & menetelmät

Ailoot Ultra · Kuvat POST /v1/images/generations

Syötetyypit: text, image
Tulostyypit: image

Kenttä	Tyyppi	Vaatimus	Arvot & rajat	Oletus
Kenttä`model`	Tyyppi`string`	VaatimusPakollinen	Arvot & rajat microsoft/mai-image-2.5	Oletus—
Kenttä`prompt`	Tyyppi`string`	VaatimusPakollinen	Arvot & rajat Vähimmäispituus: 1	Oletus—
Kenttä`aspect_ratio`	Tyyppi`string`	VaatimusValinnainen	Arvot & rajat 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto	Oletus—
Kenttä`n`	Tyyppi`integer`	VaatimusValinnainen	Arvot & rajat Vähimmäismäärä: 1 Enimmäismäärä: 1	Oletus—
Kenttä`input_references`	Tyyppi`array`	VaatimusValinnainen	Arvot & rajat Kohteiden vähimmäismäärä: 0 Kohteiden enimmäismäärä: 1	Oletus—
Kenttä`provider`	Tyyppi`object`	VaatimusValinnainen	Arvot & rajat	Oletus—

Menetelmän parametrit ja elinkaari

Parametri	Sopimus
Parametri`content_type`	Sopimusapplication/json
Parametri`required`	Sopimusmodel, prompt
Parametri`material_types`	Sopimustext, image

Elinkaari: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · todellisuudessa palautettu task_id tai mediakirjaston tietue

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Hinnoittelu

Lopullisen veloituksen laskenta

Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä.

Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.

Nopea tila: Ei määritetty Kun nopea tila on valittu
Flex-tila: Ei määritetty Kun flex-tila on valittu
Päättelyn enimmäisteho: Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä

Arvioidut vertailuhinnat

Hinnat asetusten mukaan

Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.

Asetukset	Hinnasto	Ennustettu määrä	Veloitus
AsetuksetTokenien perushinnat	HinnastoPerushinta	Ennustettu määrä—	Veloitus Syöte · Syötetokenit · Arvio vain vertailua varten — / 1K tokenia Tuloste · Tulostokenit · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistin luku · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti · Arvio vain vertailua varten — / 1K tokenia
AsetuksetArvioitu luontikustannus	Hinnasto—	Ennustettu määräyhden generoinnin arvio	Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $0.385024 arvio ennen generointia Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta.

Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →

Esimerkkipyynnöt

Ailoot Ultra · Kuvat

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', '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

Vastaanota ja tallenna tulokset

Ailoot Ultra · Kuvat

Lataa jokainen palautettu kuva tai tallenna sen Base64-sisältö

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

Muut sisällön lukukerrat

Lue olemassa olevat omistamasi aineistot

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.

Säilytä kaikki valmistuneet tulokset

Tallenna jokainen valmistunut kuva; nouda jokainen palautettu URL tai pura sen Base64-sisältö.

Säilytä koko vastaus ja otsakkeet, jokainen todellinen tuloste, alkuperäiset palautetut tunnisteet ja kaikki käyttötietokentät. Selvitä alkuperäisen operaation tila lähettämättä luontipyyntöä uudelleen.

Jos alkuperäinen vastaus on tarkistettava

Säilytä palautettu X-Client-Request-ID täsmäytystä varten. Tee lukukyselyt vain todellisuudessa palautetuilla task_id/asset_id-arvoilla tai käytä omistamaasi mediakirjastoa; älä koskaan rakenna tehtävän URL-osoitetta operaation ID:n perusteella äläkä lähetä luontipyyntöä uudelleen.

Vastauksen kentät

Kenttä	Tyyppi
Kenttä`created`	Tyyppi
Kenttä`data[].url`	Tyyppi
Kenttä`data[].b64_json`	Tyyppi
Kenttä`usage`	Tyyppi

Aliakset

Mallin aliakset

Ailoot Ultra microsoft/mai-image-2.5

Menetelmäpolkujen aliakset

/v1/images

Liittyvät kutsujan ID:t

microsoft/mai-image-2.5

FAQ · Microsoft AI: MAI-Image-2.5

Mitä syötteitä ja tuloksia on saatavilla?: POST /v1/images/generations · microsoft/mai-image-2.5: text, image → image
Mitä kenttiä pyyntö käyttää?: POST /v1/images/generations · microsoft/mai-image-2.5: model, prompt, aspect_ratio, n, input_references, provider
Mitä rajoja sovelletaan?: POST /v1/images/generations · microsoft/mai-image-2.5: n.minimum: 1; n.maximum: 1

Microsoft AI: MAI-Image-2.5