Microsoft AI: MAI-Image-2.5 Pro

Microsoft AI MAI-Image-2.5 Pro generuje a upravuje detailní obrázky pro hlavní vizuály, produktové kompozice a přesný text uvnitř obrazu. Edice Pro zdůrazňuje konzistentní předměty, postavy, materiály a prostorové vztahy v hustých scénách a pomocí textu a vizuálních referencí vytváří obrázek PNG.

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

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 Pro je edice obrazové řady 2.5 zaměřená na věrnost. Generuje obrázky ze zadání v přirozeném jazyce a provádí řízené úpravy existujících materiálů. Microsoft označuje hlavní vizuály, podrobné úpravy a přesný text uvnitř obrázku za klíčová použití a ve srovnání modelů zdůrazňuje konzistenci předmětů, postav, materiálů a prostorových vztahů ve složitých kompozicích. Konečným výstupem je obrázek pro designový či produkční postup, například klíčový produktový obrázek nebo pečlivě uspořádaná redakční scéna.

Pro generování popište kompozici prostřednictvím vztahů místo seznamu nesouvisejících předmětů. Určete hlavní objekt, jeho měřítko vůči blízkým položkám, použité materiály a směr světla. Dokumentované vizuální uvažování edice Pro je užitečné tam, kde tyto vztahy určují věrohodnost husté scény. U produktové kompozice umístěte keramický džbán, čiré sklenice a složenou látku na dřevěný stůl s konzistentními odrazy a jediným okenním světlem. Ve výsledném obrázku zkontrolujte kontakty, stíny a viditelné vlastnosti materiálů.

Při práci s produkty a postavami dodejte vizuální identitu, která má úpravu přežít. Microsoft popisuje konzistenci předmětů napříč složitými scénami a postav napříč pohledy i okamžiky jako silné stránky Pro. Uveďte vlastnosti určující předmět či osobu a aspekt scény, který se má změnit. Například zachovejte siluetu bundy a detaily zapínání a postavu umístěte do jiného pozadí. Užitečná kontrola porovnává tyto zachované detaily se zdrojovou referencí; vizuálně atraktivní výsledek sám nedokládá přesnou shodu.

Rozhraní výrobce pro úpravu obrázků přijímá až pět referencí JPEG nebo PNG. V zadání oddělte jejich role: produkt, osoba, prostředí či vizuální zpracování. Úlohy úprav zahrnují odstraňování a nahrazování předmětů, změny vlastností, inpainting, přizpůsobení rozvržení, aktualizace textu a čištění artefaktů. U místní úpravy popište cíl a okolní prvky k zachování. U podstatnějšího přeuspořádání vysvětlete, jak má kompozice po změně fungovat, aby model měl souvislý prostorový cíl.

Vykreslování textu je zvlášť důležité pro hlavní kompozici nebo koncept obalu. Dodejte přesnou frázi, její polohu a vztah k objektu či obrázku. Opakovaná jména a text etiket udržujte konzistentní mezi zadáním a referencemi. Každý vykreslený znak prohlédněte v zamýšlené velikosti zobrazení a porovnejte s dodaným zněním. Pozdější úprava se může soustředit na znění či umístění a zachovat úspěšnou produktovou kompozici. Výstup PNG pak lze začlenit do rozvržení se známými konečnými typografickými požadavky a ořezem.

Současná obrazová příručka Microsoftu používá pro modely 2.5 maximální výstupní plochu 1 048 576 pixelů, ekvivalent 1024×1024. Oba rozměry musí mít v tomto rozhraní alespoň 768 pixelů a delší strana je dovolena, pokud celková plocha zůstane v limitu. To dovoluje obdélníkové kompozice jako 1344×768, celkem 1 032 192 pixelů. Omezení plochy se liší od maxima 1024 na každé straně. Připravte cílový formát pro kompozici místo očekávání, že obecný štítek poměru stran určí ořez správně.

Příručka provozního rozhraní určuje maximální kontext promptu 32 000 tokenů a pro generování i úpravy vrací obrazová data PNG. Konkrétní katalogová stránka Pro samostatně uvádí kontextové okno 131.072K a 4 096 výstupních tokenů. Jde o publikovaná tokenová množství s vlastním katalogovým či provozním rozsahem; praktická příprava obrazového požadavku se řídí provozními limity promptu a pixelů. Obrázek, zdrojové reference a zadání uchovejte jako jeden záznam úpravy. Samotný vizuální výsledek zkontrolujte vůči podrobným omezením identity, materiálu a geometrie, která vedla k volbě Pro.

Volba verze se má řídit kompozicí. Standardní MAI-Image-2.5 pokrývá obecné generování a místní úpravy; Pro přidává důraz řady na věrnost a konzistentní vztahy ve vizuálně hustých scénách. Rodina 2.6 zvyšuje dokumentovaný limit výstupní plochy a přidává volitelné webové ukotvení a automatickou volbu poměru stran. Tato pozdější ovládání jsou specifická pro 2.6 a neurčují postup této edice Pro. Pro zvolte tehdy, když obtížná část zadání spočívá ve stabilní identitě objektu, vzhledu materiálu nebo prostorové struktuře detailního obrázku.

Zkontrolujte požadovanou změnu i zachovaný obsah. Ruce držící předměty, průsečíky, drobný tisk, podobnost tváře a odrazy jsou užitečná místa ke kontrole ve složité kompozici. Věrohodný obrázek může přesto obsahovat zavádějící značení nebo nesprávný fyzický vztah. Další opravu formulujte konkrétně a zachovejte části zadání, které vytvořily zamýšlené rozvržení. To podporuje řízenou posloupnost designových úprav místo opakovaného předefinování celé 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

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

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

Aliasy cest metod

/v1/images

Související ID modelů

microsoft/mai-image-2.5-pro

FAQ · Microsoft AI: MAI-Image-2.5 Pro

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

Microsoft AI: MAI-Image-2.5 Pro