Microsoft AI: MAI-Image-2.5
Microsoft AI MAI-Image-2.5 kuria vaizdus iš teksto ir tikslinėmis pataisomis keičia pateiktas nuotraukas arba dizainus. Jis palaiko daiktų bei teksto keitimą, artefaktų valymą ir veidą išsaugančias pataisas, grąžina PNG vaizdus ir priima iki penkių vaizdinių orientyrų. Modelio kortelė nurodo 32K kontekstą ir 1 048 576 išvesties pikselius.
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 yra bendro generavimo ir valdomo redagavimo 2.5 vaizdų šeimos versija. Modelio kortelė aprašo difuzijos modelį, naudojantį srauto derinimą, su 20 milijardų parametrų, neįskaitant įterpinių, teksto ir vaizdo įvestimi bei 32K žetonų kontekstu. Jis pateikia vaizdus koncepcijoms, portretams, produktų vaizdams, iliustracijoms ir esamų dizainų pataisoms. Naudingas pradinis pasirinkimas – ar užduočiai reikia naujos kompozicijos, ar konkretaus pakeitimo faile, kuriame jau yra numatytas objektas.
Generavimui aprašykite pagrindinį objektą, vaizdinį stilių, šviesą, žiūros tašką ir išdėstymą. Gamintojas pabrėžia detalius, vientisus vaizdus, teksto atvaizdavimą, produktų vaizdus ir užklausos laikymąsi. Praktiška pristatymo iliustracijos užduotis gali nurodyti objekto vaidmenį, norimą vaizdinį akcentą ir aplinkinės erdvės kiekį. Produkto koncepcija gali įtraukti medžiagą, mastelį ir paviršiaus apdailą. Aprašymą išlaikykite vientisą, kad daiktai dalytųsi viena scena bei vienu apšvietimo planu, užuot derinę kelias nesuderinamas vaizdines stilistikas.
Šios versijos vaizdinis samprotavimas susijęs su scenos struktūra, apšvietimu, masteliu ir erdviniais ryšiais. Gamintojas kaip redagavimo naudojimą pateikia daikto pridėjimą su tinkama perspektyva bei šešėliais. Dirbtuvių pataisai pastatykite mažą taburetę prie darbastalio, išlaikydami esamą žiūros tašką ir šviesą. Peržiūra turi palyginti taburetės dydį, sąlyčio su grindimis vietą ir tai, ar šešėlis seka kitus daiktus. Vietoje įtikinamas daiktas vis tiek turi derėti prie viso pradinio vaizdo geometrijos.
Kryptingos pataisos apima daiktų pašalinimą arba pakeitimą, savybių keitimą, sričių perpiešimą, maketo pritaikymą, teksto atnaujinimus ir valymą, pavyzdžiui, judesio suliejimo artefaktų mažinimą. Pateikite pradinį vaizdą ir įvardykite korekciją bei išsaugotinas detales. Kryptinga nuotraukos pataisa gali pašalinti dėmesį blaškantį daiktą iš fono, išlaikydama žmogų, iškirpimą ir priekinio plano išdėstymą. Dizaino pataisa gali atnaujinti trumpą teksto eilutę, išlaikydama kompoziciją. Visą rezultatą lyginkite su šaltiniu, užuot vertinę tik redaguotą sritį.
Microsoft taip pat pabrėžia veido tapatumo nuoseklumą tarp pataisų, įskaitant pozos, išraiškos arba žiūros taško pokyčius. Panašumui naudokite aiškų orientyrą ir norimą pakeitimą nurodykite taip, kad būtų išsaugotos atpažinimo savybės. Dabartinis gamintojo redagavimo vadovas priima iki penkių JPEG arba PNG vaizdų, leisdamas skirtingais orientyrais nurodyti žmogų, daiktą, sceną ar stilių. Užklausoje įvardykite tuos vaidmenis. Portreto pataisoje prieš laikydami vaizdą užbaigtu tikrinkite veidą ir pakeistą aprangą arba foną.
Konkreti modelio kortelė išvestį apriboja 1 048 576 bendrais pikseliais, lygiaverčiais 1024×1024 kvadratui, ir leidžia vienai kraštinei viršyti 1024, jei bendras plotas lieka šiose ribose. Aptarnavimo vadovas papildomai reikalauja bent 768 pikselių abiem matmenims. Stačiakampis tikslas, toks kaip 1344×768, turi 1 032 192 pikselius ir atitinka dokumentuotas ploto bei minimalių matmenų taisykles. Naudinga riba yra pločio ir aukščio sandauga, todėl paskirties formą paruoškite prieš prašydami horizontalios ar vertikalios kompozicijos.
Generavimas ir redagavimas gamintojo aptarnavimo sąsajoje grąžina PNG vaizdo duomenis. Modelio kortelė praneša 32K žetonų kontekstą, o ta sąsaja nurodo daugiausia 32 000 žetonų užklausos kontekstą. Atskiras katalogo 4 096 išvesties žetonų skaičius yra žetonų limitas, o ne išvesties matmuo. Tvarkydami išsamią užklausą ir užbaigtą vaizdą išlaikykite šias nurodytas taikymo sritis. Pradiniai failai, išsaugotinos savybės, prašytos pataisos ir tikslinis dydis sudaro naudingą pataisos įrašą šalia PNG.
Kūrybinis modelio diapazonas apima fotorealistinius ir kinematografinius vaizdus, portretus, produktų ar prekės ženklo koncepcijas, dizainus su tekstu ir kitus vaizdinius stilius. Etiketei arba iškabai pateikite tikslų tekstą ir tikrinkite rašybą galutiniu rodymo dydžiu. Atpažįstamame fotografiniame paviršiuje vis tiek gali būti išgalvotų detalių, nenuoseklus atspindys arba netikslūs užrašai. Praktiška patikra seka dizaino reikalavimus: svarbūs daikto tapatumas, įskaitomumas, erdviniai ryšiai ir išsaugota scena. Konkrečią pataisą atskirkite nuo jau pavykusių pakeitimų.
2.5 šeimoje Pro pabrėžia aukštesnę atitiktį ir stabilius ryšius tankiose scenose, o Flash skirtas greičiau reaguojančiai gamybai. 2.6 šeima įveda didesnį dokumentuotą pikselių ploto limitą, pasirenkamą rėmimąsi interneto informacija ir modelio valdomą santykio pasirinkimą. Standartinis 2.5 išlaiko savą generavimo bei redagavimo eigą be tų vėlesnių valdiklių. Versiją rinkitės pagal sudėtingą tikrosios vaizdo užduoties dalį ir užbaigtą rezultatą tikrinkite pagal tą užduotį.
Ailoot Ultra · Vaizdai POST /v1/images/generations microsoft/mai-image-2.5
microsoft/mai-image-2.5Pradžia
Microsoft AI MAI-Image-2.5 kuria vaizdus iš teksto ir tikslinėmis pataisomis keičia pateiktas nuotraukas arba dizainus. Jis palaiko daiktų bei teksto keitimą, artefaktų valymą ir veidą išsaugančias pataisas, grąžina PNG vaizdus ir priima iki penkių vaizdinių orientyrų. Modelio kortelė nurodo 32K kontekstą ir 1 048 576 išvesties pikselius.
- 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 |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos microsoft/mai-image-2.5 | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos Mažiausias ilgis: 1 | Numatyta— |
Laukasaspect_ratio | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto | Numatyta— |
Laukasn | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausia reikšmė: 1 Didžiausia reikšmė: 1 | Numatyta— |
Laukasinput_references | Tipasarray | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausias elementų skaičius: 0 Didžiausias elementų skaičius: 1 | Numatyta— |
Laukasprovider | Tipasobject | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Metodo parametrai ir gyvavimo ciklas
| Parametras | Specifikacija |
|---|---|
Parametrascontent_type | Specifikacijaapplication/json |
Parametrasrequired | Specifikacijamodel, prompt |
Parametrasmaterial_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.385024 į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
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
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}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Kito turinio skaitymas
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 |
|---|---|
Laukascreated | Tipas |
Laukasdata[].url | Tipas |
Laukasdata[].b64_json | Tipas |
Laukasusage | Tipas |
Pseudonimai
Modelių pseudonimai
Ailoot Ultra microsoft/mai-image-2.5
Metodų kelių pseudonimai
/v1/images
Susiję ID iškvietimui
FAQ · Microsoft AI: MAI-Image-2.5
- Kokios įvestys ir rezultatai prieinami?
POST /v1/images/generations·microsoft/mai-image-2.5:text,image→image- Kokius laukus naudoja užklausa?
POST /v1/images/generations·microsoft/mai-image-2.5:model,prompt,aspect_ratio,n,input_references,provider- Kokie apribojimai taikomi?
POST /v1/images/generations·microsoft/mai-image-2.5:n.minimum:1;n.maximum:1