Microsoft AI: MAI-Image-2.5 Pro

Microsoft AI MAI-Image-2.5 Pro ustvarja in ureja podrobne slike za glavne vizualne podobe, kompozicije izdelkov in natančno besedilo znotraj slike. Različica Pro poudarja dosledne predmete, like, materiale in prostorska razmerja v gostih prizorih ter z besedilom in vizualnimi referencami izdela sliko PNG.

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

O modelu

Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.

Microsoft AI MAI-Image-2.5 Pro je različica serije slikovnih modelov 2.5 s poudarkom na zvestobi. Slike ustvarja iz opisov v naravnem jeziku in izvaja usmerjene ureditve obstoječega gradiva. Microsoft kot osrednje uporabe označuje glavne vizualne podobe, podrobno urejanje in natančno besedilo v slikah, njegova primerjava modelov pa poudarja doslednost predmetov, likov, materialov in prostorskih razmerij v kompleksnih kompozicijah. Končno gradivo je slika za oblikovalski ali produkcijski postopek, denimo ključna slika izdelka ali skrbno urejen uredniški prizor.

Pri ustvarjanju kompozicijo opišite z razmerji, ne s seznamom nepovezanih predmetov. Označite glavni motiv, njegovo merilo glede na bližnje predmete, vključene materiale in smer svetlobe. Dokumentirano vizualno sklepanje različice Pro je uporabno tam, kjer ta razmerja določajo verjetnost gostega prizora. Pri kompoziciji izdelka postavite keramični vrč, prozorne kozarce in zloženo krpo na leseno mizo, z doslednimi odsevi in eno svetlobo iz okna. V nastali sliki preverite stike, sence in vidne lastnosti materialov.

Pri delu z izdelki in liki priložite vizualno identiteto, ki mora preživeti urejanje. Microsoft doslednost predmetov v kompleksnih prizorih in likov med pogledi ter trenutki opisuje kot prednosti Pro. Navedite značilnosti, ki določajo predmet ali osebo, in vidik prizora, ki naj se spremeni. Ohranite denimo silhueto jakne in podrobnosti zapenjanja ter lik postavite v drugo ozadje. Uporaben pregled te ohranjene podrobnosti primerja z izvorno referenco; vizualno privlačen rezultat sam po sebi ni dokaz natančnega ujemanja.

Proizvajalčev vmesnik za urejanje slik sprejme do pet referenc JPEG ali PNG. V opisu ločite njihove vloge: izdelek, oseba, okolje ali vizualna obdelava. Naloge urejanja vključujejo odstranjevanje in zamenjavo predmetov, spremembe lastnosti, zapolnjevanje območij, prilagoditev postavitve, posodobitve besedila in odpravljanje artefaktov. Pri lokalni ureditvi opišite cilj in okoliške elemente za ohranitev. Pri večji prerazporeditvi pojasnite, kako naj kompozicija deluje po spremembi, da ima model skladen prostorski cilj.

Izris besedila je posebno pomemben za glavno kompozicijo ali zasnovo embalaže. Podajte točno frazo, njen položaj in razmerje do predmeta ali slike. Ponavljajoča se imena in besedilo etiket ohranite dosledna med opisom in referencami. Vsak izrisani znak preglejte pri predvideni velikosti prikaza in ga primerjajte s priloženim besedilom. Poznejša ureditev se lahko osredotoči na besedilo ali postavitev ter ohrani uspešno kompozicijo izdelka. Izhod PNG lahko nato vključite v postavitev, katere končne tipografske zahteve in zahteve izreza so znane.

Trenutni Microsoftov slikovni vodič za modele 2.5 uporablja največjo izhodno površino 1.048.576 pikslov, kar ustreza 1024×1024. Obe meri morata biti v tem vmesniku vsaj 768 pikslov, daljša stranica pa je dovoljena, kadar skupna površina ostane znotraj omejitve. To omogoča pravokotne kompozicije, kot je 1344×768, skupaj 1.032.192 pikslov. Ta omejitev površine se razlikuje od maksimuma 1024 na vsaki stranici. Ciljno obliko pripravite za kompozicijo, namesto da pričakujete, da bo splošna oznaka razmerja stranic pravilno določila izrez.

Vodič strežnega vmesnika določa največji kontekst poziva 32.000 žetonov in vrne slikovne podatke PNG za ustvarjanje in urejanje. Natančna kataloška stran Pro ločeno navaja kontekstno okno 131.072K in 4.096 izhodnih žetonov. To so objavljene količine žetonov z lastnim kataloškim ali strežnim obsegom; praktična priprava slikovne zahteve sledi omejitvam poziva in pikslov strežnega vmesnika. Sliko, izvorne reference in opis hranite kot en zapis spremembe. Sam vizualni rezultat preverite glede podrobnih zahtev identitete, materiala in geometrije, zaradi katerih ste izbrali Pro.

Izbira različice naj sledi kompoziciji. Standardni MAI-Image-2.5 pokriva splošno ustvarjanje in lokalizirane ureditve; Pro dodaja poudarek serije na zvestobi in doslednih razmerjih v vizualno gostih prizorih. Družina 2.6 zviša dokumentirano omejitev izhodne površine ter dodaja neobvezno spletno navezavo na podatke in samodejno izbiro razmerja. Te poznejše možnosti so specifične za 2.6 in ne določajo postopka te različice Pro. Pro izberite, kadar zahtevni del opisa zadeva stalno identiteto predmeta, videz materiala ali prostorsko strukturo podrobne slike.

Preglejte tako zahtevano spremembo kot ohranjeno vsebino. Roke, ki držijo predmete, presečišča, drobni tisk, podobnost obraza in odsevi so uporabna mesta pregleda v kompleksni kompoziciji. Verjetna slika lahko še vedno vsebuje zavajajočo oznako ali napačno fizično razmerje. Naslednji popravek konkretno določite in ohranite dele opisa, ki so ustvarili načrtovano postavitev. To podpira nadzorovano zaporedje oblikovalskih sprememb, namesto ponovnega določanja celotnega prizora ob vsakem poskusu.

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

microsoft/mai-image-2.5-pro

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

Začetek

Dovoljeni vhodi: Besedilo · Slike
Rezultati: Slike

Na voljo v Ailoot · vhodi in metode

Ailoot Ultra · Slike POST /v1/images/generations

Vhod: text, image
Izhod: image

Polje	Vrsta	Zahteva	Vrednosti in omejitve	Privzeto
Polje`model`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve microsoft/mai-image-2.5-pro	Privzeto—
Polje`prompt`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve Najmanjša dolžina: 1	Privzeto—
Polje`aspect_ratio`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto	Privzeto—
Polje`n`	Vrsta`integer`	ZahtevaIzbirno	Vrednosti in omejitve Najmanj: 1 Največ: 1	Privzeto—
Polje`input_references`	Vrsta`array`	ZahtevaIzbirno	Vrednosti in omejitve Najmanjše število elementov: 0 Največ elementov: 1	Privzeto—
Polje`provider`	Vrsta`object`	ZahtevaIzbirno	Vrednosti in omejitve	Privzeto—

Parametri in življenjski cikel metode

Parameter	Specifikacija
Parameter`content_type`	Specifikacijaapplication/json
Parameter`required`	Specifikacijamodel, prompt
Parameter`material_types`	Specifikacijatext, image

Življenjski cikel: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Dejansko vrnjeni task_id ali zapis v medijski knjižnici

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Cenik

Kako se izračuna končni strošek

Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina.

Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.

Hitri način: Ni navedeno Ko je izbran hitri način
Način flex: Ni navedeno Ko je izbran način flex
Najvišja raven razmišljanja: Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default)

Ocenjene cene za primerjavo

Cene po nastavitvah

Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.

Nastavitev	Cenovna lestvica	Predvidena količina	Strošek
NastavitevOsnovne cene žetonov	Cenovna lestvicaOsnovna cena	Predvidena količina—	Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo — / 1K žetonov
NastavitevOcenjeni strošek ustvarjanja	Cenovna lestvica—	Predvidena količinaocena za eno generiranje	Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo $0.884736 ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje.

Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →

Primeri zahtev

Ailoot Ultra · Slike

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

Prejmi in shrani rezultate

Ailoot Ultra · Slike

Prenesite vsako vrnjeno sliko ali shranite njeno vsebino Base64

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

Branje druge vsebine

Preberi obstoječa gradiva, ki vam pripadajo

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.

Ohrani vse dokončane rezultate

Shranite vsako dokončano sliko; pridobite vsebino z vsake vrnjene URL ali dekodirajte njeno vsebino Base64.

Shranite celoten odgovor in glave, vse dejanske izhode, izvirne vrnjene identifikatorje in vsa polja s podatki o porabi. Pridobite podatke izvirne operacije brez ponovnega pošiljanja zahteve za ustvarjanje.

Če je treba preveriti izvirni odgovor

Shranite vrnjeni X-Client-Request-ID za uskladitev evidenc. Berite samo dejansko vrnjene vrednosti task_id/asset_id ali svojo medijsko knjižnico; iz ID operacije nikoli ne sestavite URL opravila in zahteve za ustvarjanje nikoli ne pošljite znova.

Polja odgovora

Polje	Vrsta
Polje`created`	Vrsta
Polje`data[].url`	Vrsta
Polje`data[].b64_json`	Vrsta
Polje`usage`	Vrsta

Druga imena

Druga imena modelov

Ailoot Ultra microsoft/mai-image-2.5-pro

Druga imena poti metod

/v1/images

Povezani ID-ji za klic

microsoft/mai-image-2.5-pro

FAQ · Microsoft AI: MAI-Image-2.5 Pro

Kateri vhodi in rezultati so na voljo?: POST /v1/images/generations · microsoft/mai-image-2.5-pro: text, image → image
Katera polja uporablja zahteva?: POST /v1/images/generations · microsoft/mai-image-2.5-pro: model, prompt, aspect_ratio, n, input_references, provider
Katere omejitve veljajo?: POST /v1/images/generations · microsoft/mai-image-2.5-pro: n.minimum: 1; n.maximum: 1

Microsoft AI: MAI-Image-2.5 Pro