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. تصف بطاقة النموذج نموذج انتشار يستخدم مطابقة التدفق، ب20 مليار معلمة غير خاصة بالتضمين ومدخلات نص وصورة وسياق 32K توكن. وينتج صورًا للمفاهيم والصور الشخصية وصور المنتجات والرسوم التوضيحية ومراجعات التصاميم الموجودة. ويكون القرار الأول المفيد هو هل تحتاج المهمة تكوينًا جديدًا أم تغييرًا محدّدًا لصورة تحتوي بالفعل على العنصر المقصود.

للتوليد، صِف العنصر الرئيسي والأسلوب البصري والضوء وزاوية الرؤية والترتيب. تبرز الجهة المطوّرة الصور التفصيلية المترابطة ورسم النص وصور المنتجات والالتزام بالتوجيه. ويمكن لتوجيه عملي لرسم توضيحي في عرض تقديمي تحديد دور العنصر والتركيز البصري المقصود وكمية المساحة المحيطة. ويمكن لمفهوم منتج تضمين المادة والمقياس وتشطيب السطح. أبقِ الوصف مترابطًا كي تشترك الأجسام في مشهد وخطة إضاءة واحدة، بدلًا من جمع عدة معالجات بصرية غير متوافقة.

يتعلّق الاستدلال البصري في هذا الإصدار ببنية المشهد والإضاءة والمقياس والعلاقات المكانية. وتقدّم الجهة المصنّعة إضافة جسم بمنظور وظلال مناسبين كاستخدام للتحرير. ولتعديل ورشة، ضع مقعدًا صغيرًا بجوار منضدة عمل مع الحفاظ على زاوية الرؤية والضوء الموجودين. وينبغي للمراجعة مقارنة حجم المقعد وموضع ملامسته للأرض وما إذا كان ظله يتبع الأجسام الأخرى. فحتى الجسم المقنع محليًا يحتاج إلى التوافق مع هندسة الصورة المصدرية كاملة.

تشمل التعديلات الموجّهة إزالة الأجسام أو استبدالها وتغيير الصفات والترميم داخل المناطق وتكييف التخطيط وتحديث النص والتنظيف مثل تقليل عيوب ضبابية الحركة. قدّم الصورة المصدرية واذكر التصحيح والتفاصيل المطلوب إبقاؤها معًا. ويمكن لتعديل فوتوغرافي مركّز إزالة جسم مشتّت من الخلفية مع الحفاظ على الشخص والاقتصاص وترتيب المقدمة. ويمكن لمراجعة تصميم تحديث سطر قصير مع إبقاء التكوين. قارن النتيجة كاملة بالمصدر بدلًا من تقييم المنطقة المعدّلة فقط.

تركّز 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 الفعلية المُعادة أو مكتبة الوسائط المملوكة لك؛ ولا تنشئ عنوان URL لمهمة من معرّف العملية، ولا تُعِد إرسال طلب الإنشاء مطلقًا.

حقول الاستجابة

الحقل	النوع
الحقل`created`	النوع
الحقل`data[].url`	النوع
الحقل`data[].b64_json`	النوع
الحقل`usage`	النوع

الأسماء البديلة

الأسماء البديلة للنموذج

Ailoot Ultra microsoft/mai-image-2.5

الأسماء البديلة لمسارات الطرائق

/v1/images

معرّفات النماذج ذات الصلة IDs

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