Microsoft AI: MAI-Image-2.5 Pro

Microsoft AI MAI-Image-2.5 Pro generuoja ir redaguoja detalius vaizdus pagrindiniams vizualams, produktų kompozicijoms bei tiksliam tekstui vaizde. Pro versija pabrėžia nuoseklius daiktus, personažus, medžiagas ir erdvinius ryšius tankiose scenose, naudodama tekstą bei vaizdinius orientyrus PNG vaizdui sukurti.

Ailoot Ultra · Vaizdai POST /v1/images/generations microsoft/mai-image-2.5-pro

Apie modelį

Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.

Microsoft AI MAI-Image-2.5 Pro yra į atitiktį orientuota 2.5 vaizdų serijos versija. Ji generuoja vaizdus iš natūralios kalbos užduočių ir kryptingai redaguoja esamus failus. Microsoft pagrindinius vizualus, išsamų redagavimą ir tikslų tekstą vaizde įvardija kaip pagrindinius naudojimo būdus, o modelių palyginimas pabrėžia daiktų, personažų, medžiagų bei erdvinių ryšių nuoseklumą sudėtingose kompozicijose. Galutinis rezultatas – vaizdas dizaino arba gamybos eigai, pavyzdžiui, pagrindinis produkto vaizdas arba kruopščiai išdėliota redakcinė scena.

Generavimui kompoziciją aprašykite ryšiais, o ne nesusijusių daiktų sąrašu. Įvardykite pagrindinį objektą, jo mastelį šalia esančių daiktų atžvilgiu, naudojamas medžiagas ir šviesos kryptį. Dokumentuotas Pro versijos vaizdinis samprotavimas naudingas ten, kur tie ryšiai lemia tankios scenos įtikinamumą. Produkto kompozicijai ant medinio stalo išdėliokite keraminį ąsotį, skaidrias stiklines ir sulankstytą audinį, su nuosekliais atspindžiais ir viena lango šviesa. Gautame vaizde tikrinkite sąlyčius, šešėlius ir matomas medžiagų savybes.

Darbui su produktais ir personažais pateikite vaizdinį tapatumą, kuris turi išlikti po pakeitimo. Microsoft daiktų nuoseklumą sudėtingose scenose ir personažų nuoseklumą skirtingais rakursais bei momentais aprašo kaip Pro stiprybes. Nurodykite, kurios savybės identifikuoja daiktą arba žmogų ir kuris scenos aspektas turi keistis. Pavyzdžiui, išlaikykite striukės siluetą bei užsegimo detales, perkeldami personažą į kitą foną. Naudinga peržiūra tas išsaugotas detales lygina su pradiniu orientyru; vien vizualiai patrauklus rezultatas nėra tikslios atitikties įrodymas.

Gamintojo vaizdų redagavimo sąsaja priima iki penkių JPEG arba PNG orientyrų. Užduotyje atskirkite jų vaidmenis: produktas, žmogus, aplinka arba vaizdinė stilistika. Redagavimo užduotys apima daiktų pašalinimą ir pakeitimą, savybių keitimą, sričių perpiešimą, maketo pritaikymą, teksto atnaujinimus ir artefaktų valymą. Vietinei pataisai aprašykite taikinį bei išsaugotinus aplinkinius elementus. Didesniam pertvarkymui paaiškinkite, kaip kompozicija turi veikti po pakeitimo, kad modelis turėtų vientisą erdvinį tikslą.

Teksto atvaizdavimas ypač svarbus pagrindinei kompozicijai arba pakuotės koncepcijai. Pateikite tikslią frazę, jos vietą ir ryšį su daiktu ar vaizdu. Pasikartojančius pavadinimus ir etikečių tekstą išlaikykite nuoseklius užduotyje bei orientyruose. Kiekvieną atvaizduotą simbolį tikrinkite numatytu rodymo dydžiu ir lyginkite su pateiktu tekstu. Vėlesnė pataisa gali sutelkti dėmesį į tekstą arba vietą, išsaugodama sėkmingą produkto kompoziciją. PNG išvestį tuomet galima įtraukti į maketą, kurio galutiniai tipografijos bei iškirpimo reikalavimai žinomi.

Dabartinis Microsoft vaizdų vadovas 2.5 modeliams taiko daugiausia 1 048 576 pikselių išvesties plotą, lygiavertį 1024×1024. Toje sąsajoje abu matmenys turi būti bent 768 pikselių, o ilgesnė kraštinė leidžiama, kai bendras plotas lieka ribose. Tai leidžia stačiakampes kompozicijas, tokias kaip 1344×768, kuri iš viso turi 1 032 192 pikselius. Šis ploto apribojimas skiriasi nuo 1024 maksimumo kiekvienai kraštinei. Paruoškite tikslinę kompozicijos formą, užuot tikėjęsi, kad bendrinė kraštinių santykio žyma teisingai nustatys iškirpimą.

Aptarnavimo vadovas nurodo daugiausia 32 000 žetonų užklausos kontekstą ir generavimui bei redagavimui grąžina PNG vaizdo duomenis. Konkretus Pro katalogo puslapis atskirai nurodo 131.072K konteksto langą ir 4 096 išvesties žetonus. Tai paskelbti žetonų kiekiai su sava katalogo arba aptarnavimo taikymo sritimi; praktiškas vaizdo užklausos paruošimas seka aptarnavimo užklausos ir pikselių ribas. Vaizdą, pradinius orientyrus ir užduotį laikykite kaip vieną pataisos įrašą. Patį vaizdinį rezultatą tikrinkite pagal išsamius tapatumo, medžiagų ir geometrijos reikalavimus, paskatinusius rinktis Pro.

Versiją reikia rinktis pagal kompoziciją. Standartinis MAI-Image-2.5 apima bendrą generavimą ir vietines pataisas; Pro prideda serijos akcentą atitikčiai bei nuosekliems ryšiams vizualiai tankiose scenose. 2.6 šeima pakelia dokumentuotą išvesties ploto limitą ir prideda pasirenkamą rėmimąsi interneto informacija bei automatinį santykio pasirinkimą. Tie vėlesni valdikliai būdingi 2.6 ir neapibrėžia šios Pro versijos eigos. Rinkitės Pro, kai sudėtinga užduoties dalis yra stabilus daikto tapatumas, medžiagos išvaizda arba erdvinė struktūra detaliame vaizde.

Peržiūrėkite prašytą pakeitimą ir išsaugotą turinį. Daiktus laikančios rankos, susikirtimai, smulkus tekstas, veido panašumas ir atspindžiai yra naudingos tikrinimo vietos sudėtingoje kompozicijoje. Įtikinamame vaizde vis tiek gali būti klaidinantis žymėjimas arba neteisingas fizinis ryšys. Kitą pataisą sukonkretinkite ir išsaugokite užduoties dalis, sukūrusias norimą maketą. Tai palaiko valdomą dizaino pataisų seką, užuot kaskart iš naujo apibrėžus visą sceną.

Ailoot Ultra · Vaizdai POST /v1/images/generations microsoft/mai-image-2.5-pro

microsoft/mai-image-2.5-pro

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

Pradžia

Leidžiamos įvestys: Tekstas · Vaizdai
Rezultatai: Vaizdai

Prieinama Ailoot · įvestys ir metodai

Ailoot Ultra · Vaizdai POST /v1/images/generations

Įvestis: text, image
Išvestis: image

Laukas	Tipas	Reikalavimas	Reikšmės ir ribos	Numatyta
Laukas`model`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos microsoft/mai-image-2.5-pro	Numatyta—
Laukas`prompt`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos Mažiausias ilgis: 1	Numatyta—
Laukas`aspect_ratio`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto	Numatyta—
Laukas`n`	Tipas`integer`	ReikalavimasNeprivaloma	Reikšmės ir ribos Mažiausia reikšmė: 1 Didžiausia reikšmė: 1	Numatyta—
Laukas`input_references`	Tipas`array`	ReikalavimasNeprivaloma	Reikšmės ir ribos Mažiausias elementų skaičius: 0 Didžiausias elementų skaičius: 1	Numatyta—
Laukas`provider`	Tipas`object`	ReikalavimasNeprivaloma	Reikšmės ir ribos	Numatyta—

Metodo parametrai ir gyvavimo ciklas

Parametras	Specifikacija
Parametras`content_type`	Specifikacijaapplication/json
Parametras`required`	Specifikacijamodel, prompt
Parametras`material_types`	Specifikacijatext, image

Gyvavimo ciklas: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · faktiškai grąžinta task_id reikšmė arba medijos bibliotekos įrašas

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Planai

Kaip apskaičiuojamas galutinis mokestis

Rodomi įkainiai leidžia įvertinti kainą prieš generavimą. Galutinė suma apskaičiuojama pagal užfiksuotą pradinio generavimo kainą. Išmatuota rezultato trukmė ir prognozuoti kiekiai nėra galutinis apmokestinamas kiekis.

Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.

Spartusis režimas: Nenurodyta Pasirinkus spartųjį režimą
Flex režimas: Nenurodyta Pasirinkus flex režimą
Didžiausios samprotavimo pastangos: Nenurodyta Kai didžiausioms samprotavimo pastangoms taikomas numatytasis koregavimas (default)

Numatomi įkainiai palyginimui

Kainos pagal konfigūraciją

Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.

Konfigūracija	Įkainių lentelė	Numatomas kiekis	Mokestis
KonfigūracijaBaziniai žetonų įkainiai	Įkainių lentelėBazinis įkainis	Numatomas kiekis—	Mokestis Įvestis · Įvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Išvestis · Išvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Įvestis · Talpyklos skaitymas · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val · Įvertis tik palyginimui — / 1K tokenų
KonfigūracijaNumatoma generavimo kaina	Įkainių lentelė—	Numatomas kiekisvieno generavimo įvertis	Mokestis Išvestis · Numatoma generavimo kaina · Įvertis tik palyginimui $0.884736 įvertis prieš generavimą Šis įvertis nėra papildomas mokestis ar fiksuotas užbaigto generavimo įkainis.

Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →

Užklausų pavyzdžiai

Ailoot Ultra · Vaizdai

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

Gauti ir išsaugoti rezultatus

Ailoot Ultra · Vaizdai

Atsisiųskite kiekvieną grąžintą vaizdą arba išsaugokite jo Base64 turinį

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

Kito turinio skaitymas

Skaityti esamą jums priklausančią medžiagą

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.

Išsaugoti visus baigtus rezultatus

Išsaugokite kiekvieną baigtą vaizdą; gaukite turinį iš kiekvieno grąžinto URL arba dekoduokite jo Base64 turinį.

Išsaugokite visą atsakymą ir antraštes, visus faktiškai gautus rezultatus, pradinius grąžintus identifikatorius ir visus naudojimo apskaitos laukus. Atkurkite prieigą prie pradinės operacijos pakartotinai neteikdami kūrimo užklausos.

Jei reikia patikrinti pradinį atsakymą

Išsaugokite grąžintą X-Client-Request-ID duomenims sutikrinti. Tikrinkite tik faktiškai grąžintas task_id/asset_id reikšmes arba jums priklausančią medijos biblioteką; niekada nekurkite užduoties URL iš operacijos ID ir niekada pakartotinai neteikite kūrimo užklausos.

Atsakymo laukai

Laukas	Tipas
Laukas`created`	Tipas
Laukas`data[].url`	Tipas
Laukas`data[].b64_json`	Tipas
Laukas`usage`	Tipas

Pseudonimai

Modelių pseudonimai

Ailoot Ultra microsoft/mai-image-2.5-pro

Metodų kelių pseudonimai

/v1/images

Susiję ID iškvietimui

microsoft/mai-image-2.5-pro

FAQ · Microsoft AI: MAI-Image-2.5 Pro

Kokios įvestys ir rezultatai prieinami?: POST /v1/images/generations · microsoft/mai-image-2.5-pro: text, image → image
Kokius laukus naudoja užklausa?: POST /v1/images/generations · microsoft/mai-image-2.5-pro: model, prompt, aspect_ratio, n, input_references, provider
Kokie apribojimai taikomi?: POST /v1/images/generations · microsoft/mai-image-2.5-pro: n.minimum: 1; n.maximum: 1

Microsoft AI: MAI-Image-2.5 Pro