Microsoft AI: MAI-Image-2.5 Pro

Microsoft AI MAI-Image-2.5 Pro generuje a upravuje podrobné obrázky pre hlavné vizuály, produktové kompozície a presný text v obraze. Edícia Pro zdôrazňuje konzistentné predmety, postavy, materiály a priestorové vzťahy v hustých scénach a pomocou textu a vizuálnych referencií vytvára obrázok PNG.

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

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 Pro je edícia série obrázkov 2.5 zameraná na vernosť. Generuje obrázky zo zadaní v prirodzenom jazyku a vykonáva riadené úpravy existujúcich vizuálov. Microsoft označuje hlavné vizuály, podrobné úpravy a presný text v obraze za kľúčové použitia a jeho porovnanie modelov zdôrazňuje konzistentnosť predmetov, postáv, materiálov a priestorových vzťahov v zložitých kompozíciách. Konečným výstupom je obrázok pre dizajnový či produkčný postup, napríklad kľúčový produktový vizuál alebo starostlivo usporiadaná redakčná scéna.

Pri generovaní opisujte kompozíciu prostredníctvom vzťahov namiesto zoznamu nesúvisiacich objektov. Určte hlavný subjekt, jeho mierku voči blízkym predmetom, použité materiály a smer svetla. Dokumentované vizuálne uvažovanie edície Pro je užitočné tam, kde tieto vzťahy určujú vierohodnosť hustej scény. Pri produktovej kompozícii umiestnite keramický džbán, priehľadné poháre a zloženú látku na drevený stôl s konzistentnými odrazmi a jediným svetlom z okna. Vo výslednom obrázku kontrolujte kontakty, tiene a viditeľné vlastnosti materiálov.

Pri produktoch a postavách dodajte vizuálnu identitu, ktorá musí prežiť úpravu. Microsoft opisuje konzistentnosť objektov naprieč zložitými scénami a postáv naprieč pohľadmi a okamihmi ako silné stránky Pro. Uveďte vlastnosti identifikujúce predmet alebo osobu a aspekt scény, ktorý sa má zmeniť. Napríklad zachovajte siluetu a detaily zapínania bundy a umiestnite postavu do iného pozadia. Užitočná kontrola porovná tieto zachované detaily so zdrojovou referenciou; vizuálne príťažlivý výsledok sám osebe nie je dôkazom presnej zhody.

Rozhranie výrobcu na úpravu obrázkov prijíma až päť referencií JPEG alebo PNG. V zadaní oddeľte ich úlohy: produkt, osoba, prostredie či vizuálne spracovanie. Úlohy úprav zahŕňajú odstránenie a nahradenie objektov, zmeny vlastností, inpainting, prispôsobenie rozloženia, aktualizáciu textu a čistenie artefaktov. Pri lokálnej úprave opíšte cieľ a okolité prvky na zachovanie. Pri výraznejšom preusporiadaní vysvetlite, ako má kompozícia fungovať po zmene, aby mal model súdržný priestorový cieľ.

Vykresľovanie textu je obzvlášť relevantné pre hlavný vizuál alebo koncept obalu. Dodajte presnú frázu, jej polohu a vzťah k predmetu či obrázku. Opakované názvy a text štítkov udržujte konzistentné medzi zadaním a referenciami. Každý vykreslený znak skontrolujte pri zamýšľanej veľkosti zobrazenia a porovnajte s dodaným znením. Neskoršia úprava sa môže sústrediť na znenie alebo umiestnenie pri zachovaní úspešnej produktovej kompozície. Výstup PNG potom možno začleniť do rozloženia, ktorého konečné požiadavky na typografiu a výrez sú známe.

Aktuálny obrazový návod Microsoft uplatňuje na modely 2.5 maximálnu výstupnú plochu 1 048 576 pixelov, čo zodpovedá 1024×1024. Oba rozmery musia byť v tomto rozhraní aspoň 768 pixelov a dlhšia strana je povolená, keď celková plocha zostane v limite. To umožňuje obdĺžnikové kompozície ako 1344×768, spolu 1 032 192 pixelov. Toto plošné obmedzenie sa líši od maxima 1024 pre každú stranu. Cieľový formát pripravte pre kompozíciu namiesto očakávania, že všeobecné označenie pomeru strán správne určí výrez.

Návod obslužného rozhrania určuje maximálny kontext zadania 32 000 tokenov a vracia obrazové dáta PNG pri generovaní aj úpravách. Presná katalógová stránka Pro samostatne uvádza kontextové okno 131.072K a 4 096 výstupných tokenov. Ide o publikované tokenové hodnoty s vlastným katalógovým alebo obslužným rozsahom; praktická príprava obrazovej požiadavky sa riadi limitmi zadania a pixelov obslužného rozhrania. Obrázok, zdrojové referencie a zadanie uchovajte ako jeden záznam revízie. Samotný vizuálny výsledok overte voči podrobným obmedzeniam identity, materiálu a geometrie, ktoré motivovali voľbu Pro.

Výber verzie má nasledovať kompozíciu. Štandardný MAI-Image-2.5 pokrýva všeobecné generovanie a lokálne úpravy; Pro pridáva dôraz série na vernosť a konzistentné vzťahy vo vizuálne hustých scénach. Rodina 2.6 zvyšuje dokumentovaný limit výstupnej plochy a pridáva voliteľné ukotvenie vo webových zdrojoch aj automatický výber pomeru strán. Tieto neskoršie ovládania sú špecifické pre 2.6 a nedefinujú postup tejto edície Pro. Pro zvoľte, keď sa náročná časť zadania týka stabilnej identity objektu, vzhľadu materiálu alebo priestorovej štruktúry v podrobnom obrázku.

Kontrolujte požadovanú zmenu aj zachovaný obsah. Ruky držiace predmety, prieniky, drobná tlač, podoba tváre a odrazy sú užitočné miesta na kontrolu v zložitej kompozícii. Vierohodný obrázok môže stále obsahovať zavádzajúce označenie alebo nesprávny fyzický vzťah. Ďalšiu opravu konkretizujte a zachovajte časti zadania, ktoré vytvorili zamýšľané rozloženie. To podporuje kontrolovanú sekvenciu dizajnových revízií namiesto opakovaného predefinovania celej scény.

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

microsoft/mai-image-2.5-pro

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

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

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

Aliasy ciest metód

/v1/images

Súvisiace ID na volanie

microsoft/mai-image-2.5-pro

FAQ · Microsoft AI: MAI-Image-2.5 Pro

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

Microsoft AI: MAI-Image-2.5 Pro