Microsoft AI: MAI-Image-2.5 Pro

Microsoft AI MAI-Image-2.5 Pro generoi ja muokkaa yksityiskohtaisia kuvia pääkuviin, tuotesommitelmiin ja tarkkaan kuvan sisäiseen tekstiin. Pro-versio painottaa esineiden, hahmojen, materiaalien ja tilallisten suhteiden yhtenäisyyttä tiheissä kohtauksissa ja tuottaa PNG-kuvan tekstin ja visuaalisten viitteiden avulla.

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

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 Pro on 2.5-kuvasarjan uskollisuuteen keskittyvä versio. Se generoi kuvia luonnollisen kielen ohjeista ja tekee ohjattuja muutoksia olemassa oleviin aineistoihin. Microsoft nimeää pääkuvat, yksityiskohtaisen muokkauksen ja tarkan kuvan sisäisen tekstin keskeisiksi käyttötarkoituksiksi, ja mallivertailu painottaa esineiden, hahmojen, materiaalien ja tilallisten suhteiden yhtenäisyyttä monimutkaisissa sommitelmissa. Lopullinen tulos on suunnittelu- tai tuotantotyönkulun kuva, kuten keskeinen tuotekuva tai huolellisesti järjestetty toimituksellinen kohtaus.

Kuvaile generointia varten sommittelu suhteiden kautta irrallisten esineiden luettelon sijaan. Yksilöi pääkohde, sen mittakaava suhteessa lähellä oleviin esineisiin, materiaalit ja valon suunta. Pro-version dokumentoitu visuaalinen päättely auttaa, kun nämä suhteet ratkaisevat tiheän kohtauksen uskottavuuden. Tuotesommitelmassa sijoita keraaminen kannu, kirkkaat lasit ja taiteltu liina puupöydälle yhtenäisillä heijastuksilla ja yhdellä ikkunavalolla. Arvioi syntyneestä kuvasta kosketukset, varjot ja näkyvät materiaaliominaisuudet.

Anna tuote- ja hahmotyöhön visuaalinen identiteetti, jonka on säilyttävä muokkauksessa. Microsoft kuvaa Pron vahvuuksiksi esineiden yhtenäisyyden monimutkaisissa kohtauksissa ja hahmojen yhtenäisyyden näkymien ja hetkien välillä. Kerro, mitkä piirteet yksilöivät esineen tai henkilön ja minkä kohtauksen osan tulee muuttua. Säilytä esimerkiksi takin siluetti ja kiinnitysyksityiskohdat ja sijoita hahmo eri taustaan. Hyödyllinen arviointi vertaa säilytettäviä yksityiskohtia lähdeviitteeseen; visuaalisesti houkutteleva tulos ei yksin todista tarkkaa vastaavuutta.

Valmistajan kuvanmuokkausrajapinta hyväksyy enintään viisi JPEG- tai PNG-viitettä. Erota niiden roolit ohjeessa: tuote, henkilö, ympäristö tai visuaalinen käsittely. Muokkaustehtäviin kuuluvat esineiden poistaminen ja korvaaminen, ominaisuusmuutokset, inpainting, asettelun mukauttaminen, tekstipäivitykset ja virheiden siistiminen. Kuvaile paikallista muokkausta varten kohde ja säilytettävät ympäröivät elementit. Selitä laajemmassa uudelleenjärjestelyssä, miten sommittelun tulee toimia muutoksen jälkeen, jotta mallilla on yhtenäinen tilallinen tavoite.

Tekstin muodostaminen on erityisen olennaista pääkuvasommitelmassa tai pakkauskonseptissa. Anna tarkka ilmaus, sen paikka ja suhde esineeseen tai kuvaan. Pidä toistuvat nimet ja etikettitekstit samoina ohjeessa ja viitteissä. Tarkasta jokainen muodostettu merkki tarkoitetussa näyttökoossa ja vertaa annettuun sanamuotoon. Myöhempi muokkaus voi keskittyä sanamuotoon tai sijoitteluun ja säilyttää onnistuneen tuotesommittelun. PNG-tulos voidaan sitten sisällyttää asetteluun, jonka lopulliset typografia- ja rajausvaatimukset tunnetaan.

Microsoftin nykyinen kuvaopas asettaa 2.5-malleille enimmäistulospinta-alaksi 1 048 576 pikseliä, mikä vastaa 1024×1024:ää. Rajapinnassa molempien mittojen on oltava vähintään 768 pikseliä, ja pidempi sivu sallitaan kokonaispinta-alan pysyessä rajan sisällä. Tämä sallii esimerkiksi 1344×768-suorakulmion, jossa on yhteensä 1 032 192 pikseliä. Pinta-alarajoite eroaa kummankin sivun 1024 pikselin enimmäisrajasta. Valmistele sommittelun kohdemuoto sen sijaan, että odottaisit yleisen kuvasuhdenimikkeen ratkaisevan rajauksen oikein.

Palveluopas määrittelee kehotekontekstin enimmäiskooksi 32 000 tokenia ja palauttaa PNG-kuvadataa sekä generoinnista että muokkauksesta. Nimenomainen Pro-katalogisivu luettelee erikseen 131.072K:n konteksti-ikkunan ja 4 096 tulostokenia. Nämä julkaistut tokenimäärät koskevat omaa katalogi- tai palvelukontekstiaan; käytännön kuvapyynnön valmistelu seuraa palvelun kehote- ja pikselirajoja. Säilytä kuva, lähdeviitteet ja ohje yhtenä muutostietueena. Tarkasta itse visuaalisesta tuloksesta yksityiskohtaiset identiteetti-, materiaali- ja geometriarajoitteet, joiden vuoksi Pro valittiin.

Versiovalinnan tulee seurata sommittelua. Tavallinen MAI-Image-2.5 kattaa yleisen generoinnin ja paikalliset muokkaukset; Pro lisää sarjan painotuksen uskollisuuteen ja yhtenäisiin suhteisiin visuaalisesti tiheissä kohtauksissa. 2.6-perhe nostaa dokumentoitua tulospinta-alarajaa ja lisää valinnaisen verkkotietoon perustamisen sekä automaattisen kuvasuhteen valinnan. Nämä myöhemmät asetukset koskevat 2.6:ta eivätkä määrittele tämän Pro-version työnkulkua. Valitse Pro, kun ohjeen vaikea osa liittyy vakaan esineidentiteetin, materiaalin ulkonäön tai tilallisen rakenteen säilyttämiseen yksityiskohtaisessa kuvassa.

Arvioi sekä pyydetty muutos että säilytettävä sisältö. Esineitä pitelevät kädet, leikkauskohdat, pieni teksti, kasvojen yhdennäköisyys ja heijastukset ovat hyödyllisiä tarkastuskohtia monimutkaisessa sommitelmassa. Uskottavassakin kuvassa voi olla harhaanjohtava merkintä tai väärä fyysinen suhde. Määrittele seuraava korjaus konkreettisesti ja säilytä ohjeen osat, jotka tuottivat halutun asettelun. Tämä tukee hallittua suunnittelumuutosten sarjaa koko kohtauksen jatkuvan uudelleenmäärittelyn sijaan.

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

microsoft/mai-image-2.5-pro

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

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-pro	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.884736 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-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

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-pro

Menetelmäpolkujen aliakset

/v1/images

Liittyvät kutsujan ID:t

microsoft/mai-image-2.5-pro

FAQ · Microsoft AI: MAI-Image-2.5 Pro

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

Microsoft AI: MAI-Image-2.5 Pro