{ "aboutHtml": "

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

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

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

Microsoft AI: MAI-Image-2.5 Pro

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

البداية

يولّد Microsoft AI MAI-Image-2.5 Pro صورًا تفصيلية ويحرّرها للمرئيات الرئيسية وتكوينات المنتجات والنص الدقيق داخل الصور. يركّز إصدار Pro على اتساق الأجسام والشخصيات والمواد والعلاقات المكانية في المشاهد الكثيفة، باستخدام النص والمراجع البصرية لإنتاج صورة PNG.

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

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

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

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

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

/v1/images

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

microsoft/mai-image-2.5-pro

", "method_identity": { "effective_request_model_id": "microsoft/mai-image-2.5-pro", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "microsoft/mai-image-2.5-pro", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|microsoft%2Fmai-image-2.5-pro", "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-pro" ], "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-pro" ], "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-pro", "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.884736", "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.884736", "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-pro', '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\"