Microsoft AI: MAI-Image-2.5

Microsoft AI MAI-Image-2.5 vytvára obrázky z textu a cielene upravuje dodané fotografie či dizajny. Podporuje zmeny objektov a textu, čistenie artefaktov a revízie zachovávajúce tvár, s výstupom PNG a až piatimi vizuálnymi referenciami. Jeho karta modelu určuje kontext 32K a 1 048 576 výstupných pixelov.

Ailoot Ultra · Obrázky POST /v1/images/generations microsoft/mai-image-2.5

O modeli

Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.

Microsoft AI MAI-Image-2.5 je edícia obrazovej rodiny 2.5 pre všeobecné generovanie a kontrolované úpravy. Jej karta modelu opisuje difúzny model používajúci flow matching s 20 miliardami parametrov mimo embeddingov, textovým a obrazovým vstupom a kontextom 32K tokenov. Vytvára obrazový výstup pre koncepty, portréty, produktové vizuály, ilustrácie a revízie existujúcich dizajnov. Užitočnou úvodnou voľbou je, či úloha vyžaduje novú kompozíciu alebo konkrétnu zmenu vizuálu, ktorý už obsahuje zamýšľaný subjekt.

Pri generovaní opíšte hlavný subjekt, vizuálny štýl, svetlo, uhol pohľadu a usporiadanie. Výrobca zdôrazňuje podrobné, súdržné obrázky, vykresľovanie textu, produktové vizuály a dodržiavanie zadania. Praktické zadanie prezentačnej ilustrácie môže určiť úlohu subjektu, zamýšľaný vizuálny dôraz a množstvo okolitého priestoru. Produktový koncept môže zahŕňať materiál, mierku a povrchovú úpravu. Opis udržte súdržný, aby objekty zdieľali jednu scénu a jeden plán osvetlenia namiesto kombinácie viacerých nezlučiteľných vizuálnych spracovaní.

Vizuálne uvažovanie v tejto edícii sa týka štruktúry scény, osvetlenia, mierky a priestorových vzťahov. Výrobca ako použitie úprav uvádza pridanie objektu s vhodnou perspektívou a tieňmi. Pri úprave dielne umiestnite malú taburetku vedľa pracovného stola pri zachovaní existujúceho uhla pohľadu a svetla. Kontrola má porovnať veľkosť taburetky, jej dotyk s podlahou a to, či tieň sleduje ostatné predmety. Lokálne presvedčivý predmet musí stále zapadať do geometrie celého zdrojového obrázka.

Riadené úpravy zahŕňajú odstránenie či nahradenie objektov, zmeny vlastností, inpainting, prispôsobenie rozloženia, aktualizáciu textu a čistenie, napríklad zníženie artefaktov pohybového rozmazania. Dodajte zdrojový obrázok a pomenujte opravu aj detaily na zachovanie. Sústredená fotografická úprava môže odstrániť rušivý predmet z pozadia pri zachovaní osoby, výrezu a usporiadania popredia. Dizajnová revízia môže aktualizovať krátky riadok textu pri zachovaní kompozície. Celý výsledok porovnajte so zdrojom namiesto hodnotenia iba upravenej oblasti.

Microsoft tiež zdôrazňuje konzistentnosť identity tváre naprieč úpravami vrátane zmien pózy, výrazu či uhla pohľadu. Pre podobu použite jasnú referenciu a zamýšľanú zmenu určte spôsobom zachovávajúcim identifikačné črty. Aktuálny návod výrobcu na úpravy prijíma až päť obrázkov JPEG alebo PNG a umožňuje rôznym referenciám identifikovať osobu, predmet, scénu alebo štýl. Tieto úlohy pomenujte v zadaní. Pri revízii portrétu pred vyhlásením obrázka za dokončený skontrolujte tvár aj zmenený odev či pozadie.

Presná karta modelu obmedzuje výstup na 1 048 576 pixelov spolu, čo zodpovedá štvorcu 1024×1024, a povoľuje jednej strane presiahnuť 1024, ak celok zostane v tejto ploche. Návod obslužného rozhrania navyše vyžaduje oba rozmery aspoň 768 pixelov. Obdĺžnikový cieľ ako 1344×768 má 1 032 192 pixelov a spĺňa tieto dokumentované pravidlá plochy aj minimálnych rozmerov. Užitočným limitom je súčin šírky a výšky, preto cieľový formát pripravte pred požiadavkou na kompozíciu na šírku či na výšku.

Generovanie aj úpravy vracajú v obslužnom rozhraní výrobcu obrazové dáta PNG. Natívna karta modelu uvádza kontext 32K tokenov, kým toto rozhranie určuje maximálny kontext zadania 32 000 tokenov. Samostatný katalógový údaj 4 096 výstupných tokenov je tokenový limit, nie výstupný rozmer. Pri organizovaní podrobného zadania a dokončeného obrázka zachovajte tieto uvedené rozsahy. Zdrojové vizuály, zachované črty, požadované úpravy a cieľová veľkosť tvoria spolu s PNG užitočný záznam revízie.

Tvorivý rozsah modelu zahŕňa fotorealistické a filmové obrazy, portréty, produktové či značkové koncepty, dizajny s textom a ďalšie vizuálne štýly. Pri štítku alebo nápise dodajte presné znenie a skontrolujte pravopis pri konečnej veľkosti zobrazenia. Rozpoznateľný fotografický povrch môže stále obsahovať vymyslený detail, nekonzistentný odraz alebo nepresné písmo. Praktická kontrola sleduje požiadavky dizajnu: dôležité sú identita objektu, čitateľnosť, priestorové vzťahy aj zachovaná scéna. Konkrétnu opravu držte oddelene od zmien, ktoré už fungovali.

V rámci rodiny 2.5 Pro zdôrazňuje vyššiu vernosť a stabilné vzťahy v hustých scénach, zatiaľ čo Flash slúži pohotovejšej produkcii. Rodina 2.6 zavádza väčší dokumentovaný limit pixelovej plochy, voliteľné ukotvenie vo webových zdrojoch a výber pomeru strán riadený modelom. Štandardný 2.5 si zachováva vlastný postup generovania a úprav bez týchto neskorších ovládaní. Edíciu vyberte podľa náročnej časti skutočnej obrazovej úlohy a dokončený výsledok porovnajte s týmto zadaním.

Ailoot Ultra · Obrázky POST /v1/images/generations microsoft/mai-image-2.5

microsoft/mai-image-2.5

Microsoft AI /microsoft/mai-image-2.5

Úvod

Povolené vstupy: Text · Obrázky
Výsledky: Obrázky

Dostupné v Ailoot · vstupy a metódy

Ailoot Ultra · Obrázky POST /v1/images/generations

Vstup: text, image
Výstup: image

Pole	Typ	Požiadavka	Hodnoty a limity	Predvolené
Pole`model`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity microsoft/mai-image-2.5	Predvolené—
Pole`prompt`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity Minimálna dĺžka: 1	Predvolené—
Pole`aspect_ratio`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto	Predvolené—
Pole`n`	Typ`integer`	PožiadavkaVoliteľné	Hodnoty a limity Minimum: 1 Maximum: 1	Predvolené—
Pole`input_references`	Typ`array`	PožiadavkaVoliteľné	Hodnoty a limity Minimálny počet položiek: 0 Maximálny počet položiek: 1	Predvolené—
Pole`provider`	Typ`object`	PožiadavkaVoliteľné	Hodnoty a limity	Predvolené—

Parametre a životný cyklus metódy

Parameter	Špecifikácia
Parameter`content_type`	Špecifikáciaapplication/json
Parameter`required`	Špecifikáciamodel, prompt
Parameter`material_types`	Špecifikáciatext, image

Životný cyklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · skutočne vrátené task_id alebo záznam v knižnici médií

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Cenník

Ako sa vypočíta konečný poplatok

Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.

Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.

Rýchly režim: Neuvedené Keď je zvolený rýchly režim
Režim Flex: Neuvedené Keď je zvolený režim flex
Maximálna úroveň uvažovania: Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)

Odhadované sadzby na porovnanie

Ceny podľa konfigurácie

Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.

Konfigurácia	Sadzobník	Odhadované množstvo	Poplatok
KonfiguráciaZákladné sadzby za tokeny	SadzobníkZákladná sadzba	Odhadované množstvo—	Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov
KonfiguráciaOdhadované náklady na generovanie	Sadzobník—	Odhadované množstvoodhad pre jedno generovanie	Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.385024 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie.

Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →

Príklady požiadaviek

Ailoot Ultra · Obrázky

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

Prijať a uložiť výsledky

Ailoot Ultra · Obrázky

Stiahnite každý vrátený obrázok alebo uložte jeho obsah Base64

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

Čítanie ďalšieho obsahu

Čítať existujúce podklady, ktoré vám patria

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.

Uchovať všetky dokončené výsledky

Uložte každý dokončený obrázok; stiahnite obsah z každej vrátenej URL alebo dekódujte jeho obsah Base64.

Uchovajte úplnú odpoveď a hlavičky, všetky skutočné výstupy, pôvodné vrátené identifikátory a všetky polia s údajmi o spotrebe. Obnovte pôvodnú operáciu bez opätovného odoslania požiadavky na vytvorenie.

Ak treba overiť pôvodnú odpoveď

Uchovajte vrátené X-Client-Request-ID na zosúladenie záznamov. Čítajte iba skutočne vrátené hodnoty task_id/asset_id alebo vlastnú knižnicu médií; nikdy nevytvárajte URL úlohy z ID operácie a nikdy znova neodosielajte požiadavku na vytvorenie.

Polia odpovede

Pole	Typ
Pole`created`	Typ
Pole`data[].url`	Typ
Pole`data[].b64_json`	Typ
Pole`usage`	Typ

Aliasy

Aliasy modelov

Ailoot Ultra microsoft/mai-image-2.5

Aliasy ciest metód

/v1/images

Súvisiace ID na volanie

microsoft/mai-image-2.5

FAQ · Microsoft AI: MAI-Image-2.5

Aké vstupy a výsledky sú dostupné?: POST /v1/images/generations · microsoft/mai-image-2.5: text, image → image
Aké polia používa požiadavka?: POST /v1/images/generations · microsoft/mai-image-2.5: model, prompt, aspect_ratio, n, input_references, provider
Aké limity platia?: POST /v1/images/generations · microsoft/mai-image-2.5: n.minimum: 1; n.maximum: 1

Microsoft AI: MAI-Image-2.5