Microsoft AI: MAI-Image-2.5 Pro

Microsoft AI MAI-Image-2.5 Pro басты көрнекі материалдарға, өнім композицияларына және сурет ішіндегі дәл мәтінге арналған егжей-тегжейлі сурет жасайды әрі өңдейді. Pro нұсқасы тығыз көріністердегі заттар, кейіпкерлер, материалдар және кеңістік байланыстарының тұрақтылығына басымдық беріп, мәтін мен көрнекі референстерден PNG суретін жасайды.

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

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

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

Microsoft AI MAI-Image-2.5 Pro — 2.5 кескін сериясының дәл сәйкестікке бағытталған нұсқасы. Ол табиғи тіл тапсырмаларынан сурет жасайды және бар ресурстарды бағытталған түрде өңдейді. Microsoft басты көрнекі материалдарды, егжей-тегжейлі өңдеуді және сурет ішіндегі дәл мәтінді негізгі қолданыстар деп атайды; модель салыстыруы күрделі композициялардағы зат, кейіпкер, материал және кеңістік байланысының тұрақтылығын атап көрсетеді. Соңғы артефакт — дизайн не өндіріс ағынына, мысалы, негізгі өнім суретіне немесе мұқият құрастырылған редакциялық көрініске арналған сурет.

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

Өнім мен кейіпкер жұмысында өңдеуден сақталуы тиіс көрнекі тұлғаны беріңіз. Microsoft күрделі көріністердегі зат тұрақтылығын және түрлі көріністер мен сәттердегі кейіпкер тұрақтылығын Pro артықшылығы деп сипаттайды. Затты не адамды танытатын белгілерді және көріністің өзгеретін қырын айтыңыз. Мысалы, кейіпкерді басқа фонға орналастырғанда күртеше сұлбасы мен бекіткіш бөлшектерін сақтаңыз. Пайдалы тексеру сақталған бөлшектерді бастапқы референспен салыстырады; көзге тартымды нәтиженің өзі дәл сәйкестіктің дәлелі емес.

Өндірушінің кескін өңдеу интерфейсі беске дейін JPEG не PNG референс қабылдайды. Тапсырмада рөлдерін бөліңіз: өнім, адам, орта немесе көрнекі өңдеу. Өңдеу міндеттері затты алып тастау мен алмастыруды, атрибут өзгертуді, inpainting, макет бейімдеуді, мәтін жаңартуды және ақау тазалауды қамтиды. Жергілікті өңдеуде нысананы және сақталатын айнала элементтерді сипаттаңыз. Кеңірек қайта орналастыруда модельге үйлесімді кеңістік мақсатын беру үшін өзгерістен кейін композиция қалай жұмыс істейтінін түсіндіріңіз.

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

Қазіргі Microsoft кескін нұсқаулығы 2.5 модельдеріне 1,048,576 пиксель ең үлкен шығыс ауданын қолданады, бұл 1024×1024-ке тең. Осы интерфейсте екі өлшем де кемінде 768 пиксель болуы керек; жалпы аудан лимитте қалса, бір жағы ұзынырақ бола алады. Бұл 1,032,192 пиксель болатын 1344×768 сияқты тікбұрышты композицияларға мүмкіндік береді. Аудан шектеуі әр жаққа 1024 максимум қоюдан өзгеше. Жалпы арақатынас атауы қиындыны дұрыс анықтайды деп күтпей, композицияға мақсатты пішім дайындаңыз.

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

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

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

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

microsoft/mai-image-2.5-pro

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

Бастау

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

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

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

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

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер microsoft/mai-image-2.5-pro	Әдепкі—
Өріс`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.884736 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

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

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

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

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

/v1/images

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

microsoft/mai-image-2.5-pro

FAQ · Microsoft AI: MAI-Image-2.5 Pro

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

Microsoft AI: MAI-Image-2.5 Pro