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. افصل أدوارها في التوجيه: المنتج أو الشخص أو المكان أو المعالجة البصرية. وتشمل مهام التحرير إزالة الأجسام واستبدالها وتغيير الصفات والترميم داخل المناطق وتكييف التخطيط وتحديث النص وتنظيف العيوب. ولتعديل موضعي، صِف الهدف والعناصر المحيطة المطلوب الحفاظ عليها. ولإعادة ترتيب أوسع، اشرح كيفية عمل التكوين بعد التغيير كي يكون للنموذج هدف مكاني مترابط.

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

يطبّق دليل الصور الحالي لدى Microsoft مساحة إخراج قصوى قدرها 1,048,576 بكسل على نماذج 2.5، تعادل 1024×1024. ويجب ألّا يقل أي من البعدين عن 768 بكسل في تلك الواجهة، ويُسمح بضلع أطول عندما تبقى المساحة الإجمالية ضمن الحد. وهذا يتيح تكوينات مستطيلة مثل 1344×768، بإجمالي 1,032,192 بكسل. ويختلف قيد المساحة عن حد أقصى 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 الفعلية المُعادة أو مكتبة الوسائط المملوكة لك؛ ولا تنشئ عنوان URL لمهمة من معرّف العملية، ولا تُعِد إرسال طلب الإنشاء مطلقًا.

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

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

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

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

Ailoot Ultra microsoft/mai-image-2.5-pro

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

/v1/images

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

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