{ "aboutHtml": "

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 القياسي بمساره الخاص للتوليد والتحرير من دون تلك العناصر اللاحقة. اختر الإصدار وفق الجزء الصعب من مهمة الصورة الفعلية وراجع النتيجة المكتملة مقابل ذلك التوجيه.

", "aboutText": "Microsoft AI MAI-Image-2.5 إصدار التوليد العام والتحرير المنضبط في عائلة الصور 2.5. تصف بطاقة النموذج نموذج انتشار يستخدم مطابقة التدفق، ب20 مليار معلمة غير خاصة بالتضمين ومدخلات نص وصورة وسياق 32K توكن. وينتج صورًا للمفاهيم والصور الشخصية وصور المنتجات والرسوم التوضيحية ومراجعات التصاميم الموجودة. ويكون القرار الأول المفيد هو هل تحتاج المهمة تكوينًا جديدًا أم تغييرًا محدّدًا لصورة تحتوي بالفعل على العنصر المقصود.\n\nللتوليد، صِف العنصر الرئيسي والأسلوب البصري والضوء وزاوية الرؤية والترتيب. تبرز الجهة المطوّرة الصور التفصيلية المترابطة ورسم النص وصور المنتجات والالتزام بالتوجيه. ويمكن لتوجيه عملي لرسم توضيحي في عرض تقديمي تحديد دور العنصر والتركيز البصري المقصود وكمية المساحة المحيطة. ويمكن لمفهوم منتج تضمين المادة والمقياس وتشطيب السطح. أبقِ الوصف مترابطًا كي تشترك الأجسام في مشهد وخطة إضاءة واحدة، بدلًا من جمع عدة معالجات بصرية غير متوافقة.\n\nيتعلّق الاستدلال البصري في هذا الإصدار ببنية المشهد والإضاءة والمقياس والعلاقات المكانية. وتقدّم الجهة المصنّعة إضافة جسم بمنظور وظلال مناسبين كاستخدام للتحرير. ولتعديل ورشة، ضع مقعدًا صغيرًا بجوار منضدة عمل مع الحفاظ على زاوية الرؤية والضوء الموجودين. وينبغي للمراجعة مقارنة حجم المقعد وموضع ملامسته للأرض وما إذا كان ظله يتبع الأجسام الأخرى. فحتى الجسم المقنع محليًا يحتاج إلى التوافق مع هندسة الصورة المصدرية كاملة.\n\nتشمل التعديلات الموجّهة إزالة الأجسام أو استبدالها وتغيير الصفات والترميم داخل المناطق وتكييف التخطيط وتحديث النص والتنظيف مثل تقليل عيوب ضبابية الحركة. قدّم الصورة المصدرية واذكر التصحيح والتفاصيل المطلوب إبقاؤها معًا. ويمكن لتعديل فوتوغرافي مركّز إزالة جسم مشتّت من الخلفية مع الحفاظ على الشخص والاقتصاص وترتيب المقدمة. ويمكن لمراجعة تصميم تحديث سطر قصير مع إبقاء التكوين. قارن النتيجة كاملة بالمصدر بدلًا من تقييم المنطقة المعدّلة فقط.\n\nتركّز Microsoft أيضًا على اتساق الهوية الوجهية عبر التعديلات، بما فيها تغيّر الوضعية أو التعبير أو زاوية الرؤية. استخدم مرجعًا واضحًا للشبه وحدّد التغيير المقصود بطريقة تحافظ على السمات المعرِّفة. يقبل دليل التحرير الحالي لدى الجهة المصنّعة ما يصل إلى خمس صور JPEG أو PNG، بما يتيح لمراجع مختلفة تعريف الشخص أو الجسم أو المشهد أو الأسلوب. سمِّ هذه الأدوار في التوجيه. وفي مراجعة صورة شخصية، افحص الوجه والملابس أو الخلفية المعدّلة معًا قبل اعتبار الصورة مكتملة.\n\nتحدّ بطاقة النموذج المحدّدة المخرجات عند 1,048,576 بكسل إجمالًا، بما يعادل مربعًا 1024×1024، وتسمح لضلع واحد بتجاوز 1024 إذا بقي الإجمالي ضمن تلك المساحة. ويشترط دليل الخدمة أيضًا ألّا يقل أي من البعدين عن 768 بكسل. ويبلغ هدف مستطيل مثل 1344×768 عدد 1,032,192 بكسل، ويستوفي قواعد المساحة والحد الأدنى للأبعاد الموثّقة. الحد المفيد هو حاصل ضرب العرض في الارتفاع، لذا جهّز شكل الوجهة قبل طلب تكوين أفقي أو رأسي.\n\nيعيد التوليد والتحرير بيانات صور PNG في واجهة الخدمة لدى الجهة المصنّعة. وتذكر بطاقة النموذج الأصلية سياق 32K توكن، بينما تحدّد تلك الواجهة حدًا أقصى لسياق التوجيه قدره 32,000 توكن. ورقم 4,096 توكن للمخرجات المنفصل في الكتالوج سعة توكن، وليس بُعدًا للإخراج. حافظ على نطاق هذه التصريحات عند تنظيم توجيه تفصيلي والصورة المكتملة. وتشكل الصور المصدرية والسمات المحتفَظ بها والتعديلات المطلوبة والحجم المستهدف سجل مراجعة مفيدًا إلى جانب PNG.\n\nيمتد المجال الإبداعي للنموذج إلى الصور الواقعية والسينمائية والصور الشخصية ومفاهيم المنتجات أو العلامات التجارية والتصاميم الحاملة للنص وأساليب بصرية أخرى. ولملصق أو لافتة، قدّم النص الدقيق وافحص إملاءه بحجم العرض النهائي. وقد يحتوي سطح فوتوغرافي مألوف على تفصيل مختلق أو انعكاس غير متّسق أو حروف غير دقيقة. يتبع الفحص العملي متطلبات التصميم: هوية الجسم والمقروئية والعلاقات المكانية والمشهد المحتفَظ به كلها مهمة. أبقِ التصحيح المحدّد منفصلًا عن التغييرات التي نجحت بالفعل.\n\nضمن عائلة 2.5، يركّز Pro على أمانة بصرية أعلى وعلاقات ثابتة في المشاهد الكثيفة، بينما يخدم Flash إنتاجًا أسرع استجابة. وتضيف عائلة 2.6 سعة موثّقة أكبر لمساحة البكسلات والإسناد الاختياري بالويب واختيار الأبعاد بتوجيه النموذج. يحتفظ 2.5 القياسي بمساره الخاص للتوليد والتحرير من دون تلك العناصر اللاحقة. اختر الإصدار وفق الجزء الصعب من مهمة الصورة الفعلية وراجع النتيجة المكتملة مقابل ذلك التوجيه.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "18766156038f81e24adf7606499ec7e374485b9709a84cb04d828e05d1d85962", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ar", "methods": [ { "html": "
•

Microsoft AI: MAI-Image-2.5

Microsoft AI /microsoft/mai-image-2.5

البداية

ينشئ Microsoft AI MAI-Image-2.5 صورًا من النص ويجري تعديلات مستهدفة على صور أو تصاميم مقدَّمة. يدعم تغيير الأجسام والنص وتنظيف العيوب وتعديلات تحافظ على الوجه، مع مخرجات PNG وما يصل إلى خمسة مراجع بصرية. وتحدّد بطاقة نموذجه سياق 32K و1,048,576 بكسل للمخرجات.

المدخلات المقبولة
النص · الصور
النتائج
الصور
عن النموذج

يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في 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 · المدخلات والطرائق

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 · الصور

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'microsoft/mai-image-2.5', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n    if not items: raise SystemExit("No completed images; retain the full response")\n    for index, item in enumerate(items):\n        encoded=item.get("b64_json")\n        uri=item.get("url", "")\n        if not encoded and uri.startswith("data:image/"):\n            header, separator, encoded=uri.partition(",")\n            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n        if encoded:\n            raw=base64.b64decode(encoded,validate=True)\n        elif uri:\n            uri=urljoin("https://api.ailoot.ai",uri)\n            parsed=urlsplit(uri)\n            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n                raise SystemExit("Invalid returned image URL")\n            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n            args=["curl","--fail-with-body","--silent","--show-error",uri]\n            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n            temporary=Path(f"image-{index}.bin")\n            subprocess.run(args+["-o",str(temporary)],check=True)\n            raw=temporary.read_bytes()\n            temporary.unlink()\n        else: raise SystemExit("Image has neither bytes nor URL")\n        if not raw: raise SystemExit("Empty image result")\n        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"\n        Path(f"image-{index}.{ext}").write_bytes(raw)\n    print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\n

استلام النتائج وحفظها

Ailoot Ultra · الصور

نزّل كل صورة مُرجعة أو احفظ محتواها بصيغة Base64

عمليات أخرى لقراءة المحتوى
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\n
الاحتفاظ بكل النتائج المكتملة

احفظ كل صورة مكتملة؛ نزّلها من كل 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

", "method_identity": { "effective_request_model_id": "microsoft/mai-image-2.5", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "microsoft/mai-image-2.5", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|microsoft%2Fmai-image-2.5", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "تقدّر التعرفات المعروضة التكلفة قبل التوليد. تُحسب الرسوم النهائية من التكلفة المسجّلة لعملية التوليد الأصلية. مدة المخرجات المقاسة والكميات المتوقعة ليست الكمية النهائية الخاضعة للفوترة.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "احتفظ بقيمة X-Client-Request-ID المُعادة للمطابقة. اقرأ فقط قيم task_id/asset_id الفعلية المُعادة أو مكتبة الوسائط المملوكة لك؛ ولا تنشئ عنوان URL لمهمة من معرّف العملية، ولا تُعِد إرسال طلب الإنشاء مطلقًا." }, "outputs": { "all_results": "احتفظ بالاستجابة كاملة وبجميع الترويسات، وبكل مخرج فعلي، وبالمعرّفات الأصلية المُعادة، وبجميع حقول الاستخدام. استعد العملية الأصلية دون إرسال طلب الإنشاء مجددًا.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] }, "parameters": [ { "enum": [ "microsoft/mai-image-2.5" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3", "auto" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "maximum": 1, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maximum_items": 1, "minimum_items": 0, "name": "input_references", "required": false, "type": "array" }, { "name": "provider", "required": false, "type": "object" } ], "request_schema": { "properties": { "aspect_ratio": { "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3", "auto" ], "type": "string" }, "input_references": { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 1, "minItems": 0, "type": "array" }, "model": { "enum": [ "microsoft/mai-image-2.5" ], "type": "string" }, "n": { "maximum": 1, "minimum": 1, "type": "integer" }, "prompt": { "minLength": 1, "type": "string" }, "provider": { "description": "Exact image provider preferences from the documented image request schema.", "type": "object" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "model": "microsoft/mai-image-2.5", "prompt": "a red panda astronaut floating in space, studio lighting" }, "content_type": "application/json" } }, "input": { "content_type": "application/json", "material_types": [ "text", "image" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "قيمة task_id الفعلية المُعادة أو سجل مكتبة الوسائط", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Keep the returned X-Client-Request-ID for reconciliation. Read only actual returned task_id/asset_id values or the owned media library; never build a task URL from the operation ID and never resubmit creation." }, "method": { "http": "POST", "path": "/v1/images/generations" }, "output": { "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "تكلفة التوليد التقديرية", "units": [ { "amount": "0.385024", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.385024", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'microsoft/mai-image-2.5', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit(\"No completed images; retain the full response\")\n for index, item in enumerate(items):\n encoded=item.get(\"b64_json\")\n uri=item.get(\"url\", \"\")\n if not encoded and uri.startswith(\"data:image/\"):\n header, separator, encoded=uri.partition(\",\")\n if not separator or \";base64\" not in header: raise SystemExit(\"Unsupported image data URI\")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin(\"https://api.ailoot.ai\",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!=\"https\" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit(\"Invalid returned image URL\")\n owned=parsed.netloc==\"api.ailoot.ai\" and parsed.path.startswith(\"/v1/media/assets/\") and parsed.path.endswith(\"/content\")\n args=[\"curl\",\"--fail-with-body\",\"--silent\",\"--show-error\",uri]\n if owned: args += [\"-H\",\"Authorization: Bearer \"+os.environ[\"AILOOT_API_KEY\"]]\n temporary=Path(f\"image-{index}.bin\")\n subprocess.run(args+[\"-o\",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit(\"Image has neither bytes nor URL\")\n if not raw: raise SystemExit(\"Empty image result\")\n 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\"