Source: https://ailoot.ai/models/cs/microsoft-mai-image-2-5/ Canonical: https://ailoot.ai/models/cs/microsoft-mai-image-2-5/ Language: cs # Microsoft AI: MAI-Image-2.5 [Markdown](https://ailoot.ai/models/cs/microsoft-mai-image-2-5/index.md) · [JSON](https://ailoot.ai/models/cs/microsoft-mai-image-2-5/facts.json) ## [Microsoft AI: MAI-Image-2.5](https://ailoot.ai/models/cs/microsoft-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`](https://ailoot.ai/models/cs/microsoft-mai-image-2-5/#method-0) 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`](https://ailoot.ai/models/cs/#m=microsoft%2Fmai-image-2.5&route=Ultra&caller=microsoft%2Fmai-image-2.5&fmt=images) Microsoft AI /`microsoft/mai-image-2.5` ### Úvod 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ů. 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í →](https://ailoot.ai/docs/cs/billing/reserve/) ### Příklady požadavků #### Ailoot Ultra · Obrázky curl ```bash 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"