Microsoft AI: MAI-Image-2.5

Microsoft AI MAI-Image-2.5 vytváří obrázky z textu a provádí cílené úpravy dodaných fotografií či návrhů. Podporuje změny předmětů a textu, čištění artefaktů a úpravy zachovávající tváře s výstupem PNG a až pěti vizuálními referencemi. Karta modelu určuje kontext 32K a 1 048 576 výstupních pixelů.

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

O modelu

Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.

Microsoft AI MAI-Image-2.5 je edice rodiny obrazových modelů 2.5 pro obecné generování a řízené úpravy. Karta modelu popisuje difuzní model využívající flow matching s 20 miliardami parametrů mimo embeddingy, textovým a obrazovým vstupem a kontextem 32K tokenů. Vytváří obrazový výstup pro koncepty, portréty, produktové snímky, ilustrace a úpravy existujících návrhů. Užitečnou počáteční volbou je, zda úloha potřebuje novou kompozici, nebo konkrétní změnu materiálu, který již obsahuje zamýšlený objekt.

Pro generování popište hlavní objekt, vizuální styl, světlo, úhel pohledu a uspořádání. Výrobce zdůrazňuje detailní, souvislé obrázky, vykreslování textu, produktové vizuály a dodržování promptu. Praktické zadání ilustrace pro prezentaci může určit roli objektu, zamýšlený vizuální důraz a množství okolního prostoru. Produktový koncept může zahrnovat materiál, měřítko a povrchovou úpravu. Popis udržujte souvislý, aby objekty sdílely jednu scénu a jeden plán osvětlení místo kombinování několika neslučitelných vizuálních zpracování.

Vizuální uvažování této edice se týká struktury scény, osvětlení, měřítka a prostorových vztahů. Výrobce uvádí přidání předmětu s vhodnou perspektivou a stíny jako využití při úpravách. U úpravy dílny umístěte malou stoličku vedle pracovního stolu při zachování existujícího úhlu pohledu a světla. Kontrola má porovnat velikost stoličky, místo dotyku s podlahou a soulad jejího stínu s ostatními předměty. Místně přesvědčivý předmět musí stále zapadat do geometrie celého zdrojového obrázku.

Řízené úpravy zahrnují odstranění či nahrazení předmětu, změny vlastností, inpainting, přizpůsobení rozvržení, aktualizace textu a čištění, například redukci artefaktů pohybového rozmazání. Dodejte zdrojový obrázek a pojmenujte opravu i detaily k zachování. Cílená úprava fotografie může odstranit rušivý předmět z pozadí při zachování osoby, ořezu a uspořádání popředí. Designová revize může aktualizovat krátký řádek textu a zachovat kompozici. Úplný výsledek porovnejte se zdrojem místo hodnocení jen upravené oblasti.

Microsoft také zdůrazňuje konzistenci identity obličeje mezi úpravami včetně změn pózy, výrazu či úhlu pohledu. Použijte jasnou referenci podoby a zamýšlenou změnu určete tak, aby zachovala určující rysy. Současná příručka výrobce pro úpravy přijímá až pět obrázků JPEG nebo PNG, takže různé reference mohou určit osobu, předmět, scénu či styl. Tyto role pojmenujte v promptu. U úpravy portrétu před označením obrázku za hotový zkontrolujte tvář i změněný oděv či pozadí.

Konkrétní karta modelu omezuje výstup na celkem 1 048 576 pixelů, ekvivalent čtverce 1024×1024, a dovoluje jedné straně překročit 1024, pokud souhrn zůstane v této ploše. Příručka provozního rozhraní navíc vyžaduje oba rozměry alespoň 768 pixelů. Obdélníkový cíl jako 1344×768 má 1 032 192 pixelů a splňuje dokumentovaná pravidla plochy i minimálních rozměrů. Užitečným limitem je součin šířky a výšky, proto cílový formát připravte před žádostí o kompozici na šířku či výšku.

Generování a úpravy vracejí v provozním rozhraní výrobce obrazová data PNG. Nativní karta modelu uvádí kontext 32K tokenů, zatímco rozhraní určuje maximální kontext promptu 32 000 tokenů. Samostatný katalogový údaj 4 096 výstupních tokenů je tokenový limit, nikoli výstupní rozměr. Při organizaci podrobného promptu a hotového obrázku zachovejte tyto uvedené rozsahy. Zdrojové materiály, zachované vlastnosti, požadované úpravy a cílová velikost tvoří vedle PNG užitečný záznam revize.

Tvůrčí rozsah modelu zahrnuje fotorealistické a filmové obrazy, portréty, produktové či značkové koncepty, návrhy s textem a další vizuální styly. U etikety nebo nápisu dodejte přesné znění a pravopis zkontrolujte v konečné velikosti zobrazení. Rozpoznatelný fotografický povrch může přesto obsahovat vymyšlený detail, nesourodý odraz či nepřesné písmo. Praktická kontrola sleduje požadavky designu: důležité jsou identita předmětu, čitelnost, prostorové vztahy i zachovaná scéna. Konkrétní opravu oddělte od změn, které již fungují.

V rodině 2.5 zdůrazňuje Pro vyšší věrnost a stabilní vztahy v hustých scénách, zatímco Flash slouží rychle reagující produkci. Rodina 2.6 přináší větší dokumentovaný limit pixelové plochy, volitelné webové ukotvení a volbu poměru stran řízenou modelem. Standardní 2.5 si ponechává vlastní postup generování a úprav bez těchto pozdějších ovládání. Edici vyberte podle obtížné části skutečné obrazové úlohy a hotový výsledek porovnejte s tímto zadání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

Přijímané vstupy: Text · Obrázky
Výsledky: Obrázky

Dostupné v Ailoot · vstupy a metody

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

Vstup: text, image
Výstup: image

Pole	Typ	Požadavek	Hodnoty a limity	Výchozí
Pole`model`	Typ`string`	PožadavekPovinné	Hodnoty a limity microsoft/mai-image-2.5	Výchozí—
Pole`prompt`	Typ`string`	PožadavekPovinné	Hodnoty a limity Minimální délka: 1	Výchozí—
Pole`aspect_ratio`	Typ`string`	PožadavekVolitelné	Hodnoty a limity 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto	Výchozí—
Pole`n`	Typ`integer`	PožadavekVolitelné	Hodnoty a limity Minimum: 1 Maximum: 1	Výchozí—
Pole`input_references`	Typ`array`	PožadavekVolitelné	Hodnoty a limity Minimální počet položek: 0 Maximální počet položek: 1	Výchozí—
Pole`provider`	Typ`object`	PožadavekVolitelné	Hodnoty a limity	Výchozí—

Parametry a životní cyklus metody

Parametr	Kontrakt
Parametr`content_type`	Kontraktapplication/json
Parametr`required`	Kontraktmodel, prompt
Parametr`material_types`	Kontrakttext, image

Životní cyklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · skutečně vrácené task_id nebo záznam v knihovně médií

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Tarify

Jak se vypočítá konečný poplatek

Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.

Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.

Rychlý režim: Neuvedeno Při výběru rychlého režimu
Režim flex: Neuvedeno Při výběru režimu flex
Maximální intenzita uvažování: Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)

Odhadované sazby pro srovnání

Ceny podle konfigurace

Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.

Konfigurace	Tabulka sazeb	Předpokládané množství	Poplatek
KonfiguraceZákladní sazby za tokeny	Tabulka sazebZákladní sazba	Předpokládané množství—	Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů
KonfiguraceOdhadovaná cena generování	Tabulka sazeb—	Předpokládané množstvíodhad pro jedno generování	Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.385024 odhad před generováním Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování.

Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →

Příklady požadavků

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

Přijímání a ukládání výsledků

Ailoot Ultra · Obrázky

Stáhněte každý vrácený obrázek nebo 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}

Další načtení obsahu

Načíst existující soubory, které vám patří

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.

Uchovejte všechny dokončené výsledky

Uložte každý dokončený obrázek; stáhněte obsah každé vrácené URL nebo dekódujte obsah Base64.

Uchovejte úplnou odpověď a hlavičky, všechny skutečné výstupy, původní vrácené identifikátory a všechna pole s údaji o využití. Obnovte původní operaci bez opětovného odeslání požadavku na vytvoření.

Pokud je nutné ověřit původní odpověď

Uchovejte vrácené X-Client-Request-ID pro spárování záznamů. Načítejte pouze skutečně vrácené hodnoty task_id/asset_id nebo vlastní knihovnu médií; nikdy nevytvářejte URL úlohy z ID operace a nikdy znovu neodesílejte požadavek na vytvoření.

Pole odpovědi

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

Aliasy

Aliasy modelu

Ailoot Ultra microsoft/mai-image-2.5

Aliasy cest metod

/v1/images

Související ID modelů

microsoft/mai-image-2.5

FAQ · Microsoft AI: MAI-Image-2.5

Jaké vstupy a výsledky jsou dostupné?: POST /v1/images/generations · microsoft/mai-image-2.5: text, image → image
Jaká pole požadavek používá?: POST /v1/images/generations · microsoft/mai-image-2.5: model, prompt, aspect_ratio, n, input_references, provider
Jaké limity platí?: POST /v1/images/generations · microsoft/mai-image-2.5: n.minimum: 1; n.maximum: 1

Microsoft AI: MAI-Image-2.5