Microsoft AI: MAI-Image-2.5

Microsoft AI MAI-Image-2.5 мәтіннен сурет жасайды және берілген фотолар мен дизайндарды нысаналы өңдейді. Ол зат пен мәтін өзгерістерін, ақау тазалауды және бет тұлғасын сақтайтын түзетулерді, PNG нәтижесін және беске дейін көрнекі референсті қолдайды. Модель карточкасында 32K контекст және 1,048,576 шығыс пикселі көрсетілген.

Ailoot Ultra · Суреттер POST /v1/images/generations microsoft/mai-image-2.5

Модель туралы

Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.

Microsoft AI MAI-Image-2.5 — 2.5 кескін тобының жалпы генерация және басқарылатын өңдеу нұсқасы. Модель карточкасы flow matching қолданатын, embedding-тен тыс 20 миллиард параметрі, мәтін мен сурет кірісі және 32K токен контексті бар диффузиялық модельді сипаттайды. Ол тұжырымдамаларға, портреттерге, өнім көріністеріне, иллюстрацияларға және бар дизайн түзетулеріне сурет береді. Пайдалы бастапқы таңдау — міндетке жаңа композиция керек пе, әлде қажетті нысаны бар ресурстағы нақты өзгеріс пе екенін анықтау.

Генерацияда негізгі нысанды, көрнекі стильді, жарықты, көру нүктесін және орналасуды сипаттаңыз. Өндіруші егжей-тегжейлі үйлесімді суреттерді, мәтін рендерлеуді, өнім көріністерін және промптты орындауды атап көрсетеді. Презентация иллюстрациясына арналған практикалық тапсырма нысан рөлін, қажетті көрнекі екпінді және айнала кеңістік мөлшерін белгілей алады. Өнім тұжырымдамасы материалды, ауқымды және бет өңдеуін қамти алады. Бірнеше үйлеспейтін көрнекі өңдеуді біріктірмей, заттар бір көрініс пен бір жарық жоспарын бөлісетіндей сипаттаманы үйлесімді ұстаңыз.

Осы нұсқадағы көрнекі пайымдау көрініс құрылымына, жарыққа, ауқымға және кеңістік байланыстарына қатысты. Өндіруші тиісті перспективасы мен көлеңкесі бар зат қосуды өңдеу қолданысы ретінде береді. Шеберхана өңдеуінде бар көру нүктесі мен жарықты сақтап, жұмыс үстелі қасына шағын орындық қойыңыз. Тексеру орындық өлшемін, еденге жанасуын және көлеңкесінің өзге заттарға сәйкестігін салыстыруы керек. Жергілікті сенімді зат бүкіл бастапқы сурет геометриясына да сай болуы тиіс.

Бағытталған өңдеу затты алып тастау не алмастыруды, атрибут өзгертуді, inpainting, макет бейімдеуді, мәтін жаңартуды және қозғалыс бұлдыры ақауын азайту сияқты тазалауды қамтиды. Бастапқы суретті беріп, түзетуді де, сақталатын бөлшектерді де атаңыз. Нысаналы фото өңдеу адамды, қиындыны және алдыңғы орналасуды сақтап, фондағы алаңдататын затты алып тастай алады. Дизайн түзетуі композицияны сақтап, қысқа мәтін жолын жаңарта алады. Тек өңделген аумақты бағаламай, толық нәтижені бастапқы суретпен салыстырыңыз.

Microsoft қалып, эмоция не көру нүктесі өзгергенде де өңдеулер арасындағы бет тұлғасының тұрақтылығын атап көрсетеді. Ұқсастық үшін анық референс қолданып, қажетті өзгерісті тануға көмектесетін белгілерді сақтайтындай сипаттаңыз. Өндірушінің қазіргі өңдеу нұсқаулығы беске дейін JPEG не PNG суретін қабылдайды; әртүрлі референс адамды, затты, көріністі не стильді анықтай алады. Сол рөлдерді промптта атаңыз. Портрет түзетуін дайын деп есептемес бұрын өзгерген киім не фонмен бірге бетті де тексеріңіз.

Нақты модель карточкасы нәтижені 1,048,576 жалпы пиксельмен шектейді, бұл 1024×1024 шаршыға тең; жалпы аудан осы шекте қалса, бір жағы 1024-тен аса алады. Қызмет көрсету нұсқаулығы қосымша екі өлшем де кемінде 768 пиксель болуын талап етеді. 1344×768 сияқты тікбұрышты нысана 1,032,192 пиксельге тең және құжатталған аудан мен ең аз өлшем ережелеріне сай. Пайдалы шек — ен мен биіктік көбейтіндісі, сондықтан көлденең не тік композиция сұрамас бұрын мақсатты пішімді дайындаңыз.

Өндірушінің қызмет көрсету интерфейсінде генерация мен өңдеу PNG сурет дерегін қайтарады. Нативті модель карточкасы 32K токен контекстін, интерфейс 32,000 токен ең үлкен промпт контекстін көрсетеді. Каталогтағы бөлек 4,096 шығыс токені көрсеткіші — сурет өлшемі емес, токен лимиті. Егжей-тегжейлі промпт пен дайын суретті ұйымдастырғанда осы ауқымдарды сақтаңыз. Бастапқы ресурстар, сақталған белгілер, сұралған өңдеулер және мақсатты өлшем PNG-мен бірге пайдалы түзету жазбасын құрайды.

Модельдің шығармашылық ауқымы фотошынайы және кинематографиялық көріністерді, портреттерді, өнім не бренд тұжырымдамаларын, мәтіні бар дизайндарды және басқа көрнекі стильдерді қамтиды. Жапсырма не маңдайша үшін нақты мәтін беріп, соңғы көрсету өлшемінде емлені тексеріңіз. Танылатын фотографиялық бетте ойдан қосылған бөлшек, үйлеспейтін шағылыс немесе қате жазу бәрібір болуы мүмкін. Практикалық тексеру дизайн талаптарына бағынады: зат тұлғасы, оқылуы, кеңістік байланыстары және сақталған көрініс бәрі маңызды. Нақты түзетуді сәтті болған өзгерістерден бөлек ұстаңыз.

2.5 тобында Pro жоғары дәлдікке және тығыз көріністердегі тұрақты байланыстарға, Flash шапшаң өндіріске басымдық береді. 2.6 тобы үлкенірек құжатталған пиксель ауданы лимитін, қосымша веб негіздеуді және модель бағыттайтын арақатынас таңдауын енгізеді. Стандартты 2.5 кейінгі басқаруларсыз өз генерация және өңдеу ағынын сақтайды. Нұсқаны нақты сурет міндетінің қиын бөлігіне сай таңдап, дайын нәтижені сол тапсырмамен салыстырыңыз.

Ailoot Ultra · Суреттер POST /v1/images/generations microsoft/mai-image-2.5

microsoft/mai-image-2.5

Microsoft AI /microsoft/mai-image-2.5

Бастау

Қабылданатын кіріс деректері: Мәтін · Суреттер
Нәтижелер: Суреттер

Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер

Ailoot Ultra · Суреттер POST /v1/images/generations

Кіріс: text, image
Шығыс: image

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер microsoft/mai-image-2.5	Әдепкі—
Өріс`prompt`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер Ең аз ұзындық: 1	Әдепкі—
Өріс`aspect_ratio`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto	Әдепкі—
Өріс`n`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Ең азы: 1 Ең көбі: 1	Әдепкі—
Өріс`input_references`	Түрі`array`	ТалапМіндетті емес	Мәндер мен шектеулер Элементтердің ең аз саны: 0 Элементтердің ең көп саны: 1	Әдепкі—
Өріс`provider`	Түрі`object`	ТалапМіндетті емес	Мәндер мен шектеулер	Әдепкі—

Әдіс параметрлері мен өмірлік циклі

Параметр	Параметр талаптары
Параметр`content_type`	Параметр талаптарыapplication/json
Параметр`required`	Параметр талаптарыmodel, prompt
Параметр`material_types`	Параметр талаптарыtext, image

Өмірлік цикл: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Нақты қайтарылған task_id немесе медиатека жазбасы

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Тарифтер

Қорытынды төлем қалай есептеледі

Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.

Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.

Жылдам режим: Көрсетілмеген Жылдам режим таңдалғанда
Икемді режим: Көрсетілмеген flex режимі таңдалғанда
Ой қорытудың ең жоғары деңгейі: Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда

Салыстыруға арналған болжамды мөлшерлемелер

Баптаулар бойынша бағалар

Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.

Баптау	Мөлшерлемелер кестесі	Болжамды мөлшер	Төлем
БаптауТокендердің базалық тарифтері	Мөлшерлемелер кестесіНегізгі мөлшерлеме	Болжамды мөлшер—	Төлем Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау — / 1K токен Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау — / 1K токен
БаптауГенерацияның болжамды құны	Мөлшерлемелер кестесі—	Болжамды мөлшербір генерацияға арналған болжам	Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.385024 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →

Сұрау мысалдары

Ailoot Ultra · Суреттер

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

Нәтижелерді алу және сақтау

Ailoot Ultra · Суреттер

Қайтарылған әр суретті жүктеп алыңыз немесе оның Base64 мазмұнын сақтаңыз

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

Басқа мазмұнды оқу

Өзіңізге тиесілі қолда бар материалдарды оқу

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.

Барлық дайын нәтижені сақтау

Әр дайын суретті сақтаңыз; қайтарылған әр URL арқылы мазмұнды алыңыз немесе оның Base64 мазмұнын декодтаңыз.

Толық жауапты және тақырыптарды, алынған әрбір нәтижені, бастапқыда қайтарылған идентификаторларды және пайдалану туралы барлық өрістерді сақтаңыз. Жасау сұрауын қайта жібермей, бастапқы операцияны қалпына келтіріңіз.

Бастапқы жауапты тексеру қажет болса

Есептерді салыстырып тексеру үшін қайтарылған X-Client-Request-ID мәнін сақтаңыз. Тек нақты қайтарылған task_id/asset_id мәндері арқылы немесе өзіңізге тиесілі медиатекадан оқыңыз; операция ID мәнінен тапсырманың URL мекенжайын ешқашан құрастырмаңыз және жасау сұрауын ешқашан қайта жібермеңіз.

Жауап өрістері

Өріс	Түрі
Өріс`created`	Түрі
Өріс`data[].url`	Түрі
Өріс`data[].b64_json`	Түрі
Өріс`usage`	Түрі

Балама атаулар

Модельдердің балама атаулары

Ailoot Ultra microsoft/mai-image-2.5

Әдіс жолдарының балама атаулары

/v1/images

Шақыруға арналған байланысты ID

microsoft/mai-image-2.5

FAQ · Microsoft AI: MAI-Image-2.5

Қандай кіріс деректері мен нәтижелер қолжетімді?: POST /v1/images/generations · microsoft/mai-image-2.5: text, image → image
Сұрау қандай өрістерді пайдаланады?: POST /v1/images/generations · microsoft/mai-image-2.5: model, prompt, aspect_ratio, n, input_references, provider
Қандай шектеулер қолданылады?: POST /v1/images/generations · microsoft/mai-image-2.5: n.minimum: 1; n.maximum: 1

Microsoft AI: MAI-Image-2.5