Microsoft AI: MAI-Image-2.5
A Microsoft AI MAI-Image-2.5 szövegből készít képeket és célzottan szerkeszti a megadott fotókat vagy dizájnokat. Támogatja a tárgy- és szövegváltoztatást, hibatisztítást és arcot megőrző módosításokat, PNG kimenettel és legfeljebb öt vizuális referenciával. Modellkártyája 32K kontextust és 1 048 576 kimeneti pixelt ad meg.
A modellről
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
A Microsoft AI MAI-Image-2.5 a 2.5 képcsalád általános generálásra és irányított szerkesztésre szánt kiadása. Modellkártyája flow matchinget használó diffúziós modellt ír le 20 milliárd nem embedding paraméterrel, szöveges és képi bemenettel és 32K tokenes kontextussal. Képkimenetet készít koncepciókhoz, portrékhoz, termékképekhez, illusztrációkhoz és meglévő dizájnok módosításához. Hasznos kiinduló döntés, hogy új kompozícióra van-e szükség, vagy olyan anyag konkrét változtatására, amely már tartalmazza a kívánt témát.
Generáláshoz írd le a fő témát, vizuális stílust, fényt, nézőpontot és elrendezést. A gyártó részletes, összefüggő képeket, szövegmegjelenítést, termékképeket és promptkövetést emel ki. Prezentációillusztráció gyakorlati leírása megadhatja a téma szerepét, kívánt vizuális hangsúlyát és a körülötte lévő tér mennyiségét. Termékkoncepció tartalmazhat anyagot, léptéket és felületkidolgozást. A leírás legyen összefüggő, hogy a tárgyak egy közös jelenetben, egységes világítással jelenjenek meg, több össze nem illő vizuális megoldás keverése helyett.
E kiadás vizuális következtetése a jelenetszerkezetre, világításra, léptékre és térbeli kapcsolatokra vonatkozik. A gyártó szerkesztési példája megfelelő perspektívájú és árnyékú tárgy hozzáadása. Műhely szerkesztésekor helyezz kis sámlit a munkapad mellé, a meglévő nézőpont és fény megtartásával. Ellenőrzéskor hasonlítsd össze a sámli méretét, padlóval való érintkezését és azt, hogy árnyéka követi-e a többi tárgyét. A helyileg meggyőző tárgynak is illeszkednie kell a teljes forráskép geometriájához.
Az irányított szerkesztés tárgyeltávolítást vagy -cserét, tulajdonságváltoztatást, inpaintinget, elrendezés-adaptációt, szövegfrissítést és például mozgási elmosódás okozta hibák csökkentését tartalmazza. Add meg a forrásképet, és nevezd meg a javítást és megtartandó részleteket is. Célzott fotószerkesztés eltávolíthat zavaró háttértárgyat, miközben megmarad a személy, kivágás és előtéri elrendezés. Dizájnmódosítás rövid szövegsort frissíthet a kompozíció megtartásával. A teljes eredményt vesd össze a forrással, ne csak a szerkesztett területet értékeld.
A Microsoft a szerkesztések közötti arcbeli azonosság következetességét is hangsúlyozza, póz-, arckifejezés- vagy nézőpontváltozásnál is. A hasonlósághoz használj tiszta referenciát, a kívánt változást pedig az azonosító jellemzők megőrzésével add meg. A gyártó jelenlegi szerkesztési útmutatója legfeljebb öt JPEG vagy PNG képet fogad, így külön referenciák azonosíthatják a személyt, tárgyat, jelenetet vagy stílust. E szerepeket nevezd meg a promptban. Portrémódosításnál az arcot is vizsgáld meg a megváltozott ruházat vagy háttér mellett, mielőtt késznek tekinted a képet.
A pontos modellkártya összesen 1 048 576 pixelre korlátozza a kimenetet, ami 1024×1024-es négyzetnek felel meg, és engedi, hogy az egyik oldal meghaladja az 1024-et, ha az összterület ezen belül marad. A kiszolgálási útmutató emellett mindkét mérethez legalább 768 pixelt igényel. Például az 1344×768-as téglalap 1 032 192 pixeles, és megfelel e dokumentált terület- és minimálisméret-szabályoknak. A hasznos korlát a szélesség és magasság szorzata, ezért fekvő vagy álló kompozíció kérése előtt készítsd elő a célformát.
A gyártó kiszolgálási felületén a generálás és szerkesztés PNG képadatot ad vissza. A natív modellkártya 32K tokenes kontextust jelent, a felület pedig legfeljebb 32 000 tokenes promptkontextust ír elő. A katalógus külön 4 096 kimeneti tokenje tokenkeret, nem kimeneti méret. Részletes prompt és kész kép rendezésekor őrizd meg e közölt hatóköröket. A forrásanyagok, megtartott jellemzők, kért szerkesztések és célméret a PNG mellett hasznos módosítási nyilvántartást alkotnak.
A modell alkotói tartománya fotórealisztikus és filmszerű képekre, portrékra, termék- vagy márkakoncepciókra, szöveges dizájnokra és más vizuális stílusokra terjed. Címkéhez vagy táblához add meg a pontos szöveget, és a végső megjelenítési méretben ellenőrizd helyesírását. A felismerhető fotografikus felület is tartalmazhat kitalált részletet, következetlen tükröződést vagy pontatlan feliratot. A gyakorlati ellenőrzés a dizájn követelményeit követi: tárgyazonosság, olvashatóság, térbeli kapcsolatok és megtartott jelenet mind számítanak. A konkrét javítást különítsd el a már sikerült változásoktól.
A 2.5 családon belül a Pro a zsúfolt jelenetek magasabb hűségét és stabil kapcsolatait hangsúlyozza, a Flash pedig gyors reakciójú gyártást szolgál. A 2.6 család nagyobb dokumentált pixelterület-keretet, opcionális webes megalapozást és modell által irányított oldalarány-választást vezet be. A normál 2.5 e későbbi vezérlők nélkül tartja meg saját generálási és szerkesztési munkafolyamatát. A kiadást a tényleges képfeladat nehéz része alapján válaszd, és a kész eredményt ehhez a leíráshoz mérd.
Ailoot Ultra · Képek POST /v1/images/generations microsoft/mai-image-2.5
microsoft/mai-image-2.5Kezdő lépések
A Microsoft AI MAI-Image-2.5 szövegből készít képeket és célzottan szerkeszti a megadott fotókat vagy dizájnokat. Támogatja a tárgy- és szövegváltoztatást, hibatisztítást és arcot megőrző módosításokat, PNG kimenettel és legfeljebb öt vizuális referenciával. Modellkártyája 32K kontextust és 1 048 576 kimeneti pixelt ad meg.
- Elfogadott bemenetek
- Szöveg · Képek
- Eredmények
- Képek
Elérhető az Ailootban · bemenetek és metódusok
Ailoot Ultra · Képek POST /v1/images/generations
- Bemenet
text,image- Kimenet
image
| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok microsoft/mai-image-2.5 | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok Minimális hossz: 1 | Alapértelmezett— |
Mezőaspect_ratio | Típusstring | KövetelményOpcionális | Értékek és korlátok 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto | Alapértelmezett— |
Mezőn | Típusinteger | KövetelményOpcionális | Értékek és korlátok Minimum: 1 Maximum: 1 | Alapértelmezett— |
Mezőinput_references | Típusarray | KövetelményOpcionális | Értékek és korlátok Minimális elemszám: 0 Maximális elemszám: 1 | Alapértelmezett— |
Mezőprovider | Típusobject | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, prompt |
Paramétermaterial_types | Szerződéstext, image |
Életciklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · A ténylegesen visszaadott task_id vagy a médiatár bejegyzése
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Díjcsomagok
A végső díj számítása
A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel.
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
- Gyors mód
- Nincs megadva Ha a gyors mód van kiválasztva
- Flex mód
- Nincs megadva Ha a flex mód van kiválasztva
- Maximális gondolkodási ráfordítás
- Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik
Becsült díjak összehasonlításhoz
Árak beállításonként
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Előre jelzett mennyiség | Díj |
|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Előre jelzett mennyiség— | Díj Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra — / 1K token Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra — / 1K token Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra — / 1K token |
| BeállításA generálás becsült költsége | Díjtáblázat— | Előre jelzett mennyiségbecslés egy generálásra | Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra $0.385024 becslés a generálás előtt Ez a becslés nem jelent további díjat, és nem rögzített díjszabás az elkészült generálásra. |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
Példakérések
Ailoot Ultra · Képek
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
Eredmények fogadása és mentése
Ailoot Ultra · Képek
Töltsön le minden visszaadott képet, vagy mentse a Base64-tartalmat
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
További tartalomlekérések
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.
Őrizzen meg minden elkészült eredményt
Mentsen minden elkészült képet; töltse le az összes visszaadott URL tartalmát, vagy dekódolja a Base64-tartalmat.
Őrizze meg a teljes választ és a fejléceket, minden tényleges kimenetet, az eredetileg visszaadott azonosítókat és az összes használati adatmezőt. Az eredeti műveletet állítsa helyre, a létrehozási kérés újbóli beküldése nélkül.
Ha az eredeti választ ellenőrizni kell
Őrizze meg a visszaadott X-Client-Request-ID értéket az egyeztetéshez. Csak a ténylegesen visszaadott task_id/asset_id értékekkel kérdezzen le, vagy használja a saját médiatárat; soha ne állítson össze feladat-URL-t a műveletazonosítóból, és soha ne küldje be újra a létrehozási kérést.
Válaszmezők
| Mező | Típus |
|---|---|
Mezőcreated | Típus |
Meződata[].url | Típus |
Meződata[].b64_json | Típus |
Mezőusage | Típus |
Álnevek
Modell álnevei
Ailoot Ultra microsoft/mai-image-2.5
Metódusútvonalak álnevei
/v1/images
Kapcsolódó modellazonosítók
FAQ · Microsoft AI: MAI-Image-2.5
- Milyen bemenetek és eredmények érhetők el?
POST /v1/images/generations·microsoft/mai-image-2.5:text,image→image- Mely mezőket használja a kérés?
POST /v1/images/generations·microsoft/mai-image-2.5:model,prompt,aspect_ratio,n,input_references,provider- Milyen korlátok érvényesek?
POST /v1/images/generations·microsoft/mai-image-2.5:n.minimum:1;n.maximum:1