FLUX.2 [max] أعلى أعضاء عائلة FLUX.2 من Black Forest Labs جودةً لتوليد الصور وتحريرها. وتضعه الجهة المصنّعة للمخرجات النهائية المتطلّبة والالتزام القوي بتوجيه معقّد والاتساق عبر التعديلات. ينشئ صورة من وصف مكتوب أو يستخدم صورًا مقدَّمة كمراجع بصرية. وقدرته المميِّزة داخل العائلة هي البحث لإسناد التوليد بالمعلومات: يمكن للطلب الاستفادة من معلومات راهنة بدلًا من الاعتماد فقط على المشهد الموصوف في التوجيه.
توثّق الجهة المطوّرة البحث في الويب لموضوعات مثل الطقس الحالي أو حدث رياضي حديث أو سياق تاريخي. حدّد الموقع والحدث والوقت الفعليين المرتبطين بالصورة، ثم صِف المعالجة الفنية بصورة مستقلة. ويمكن لمفهوم بطاقة طقس مسنَدة بالمعلومات تحديد المدينة والحالة المطلوب تصويرها والعنوان الدقيق والتخطيط. يزوّد البحث عملية التوليد بالمعلومات؛ لكن الرسمة الجذابة تظل بحاجة إلى مقارنة حقائقها الظاهرة بالمصدر المعني قبل استخدامها لتواصل واقعي.
تخص قدرة البحث هذه [max] في مقارنة FLUX.2 المنشورة. وللأعضاء الآخرين المسمّين أدوارهم: [pro] للإنتاج و[flex] لأخذ العينات والطباعة القابلين للضبط و[klein] للتوليد التفاعلي المدمج. احتفظ باسم النموذج المختار مع النتيجة كي لا تستبدل مراجعة لاحقة ملف البحث المسنَد بالمعلومات بإصدار مختلف ضمنيًا.
يأخذ ملف الطلب الموثّق ما يصل إلى ثماني صور مرجعية؛ وتسمح واجهة الجهة المطوّرة التفاعلية بعشر صور بصورة مستقلة. عيّن دورًا لكل مرجع، مثل مظهر شخصية أو تصميم منتج أو ملابس أو غرفة أو أسلوب بصري. ويمكن لتكوين جمع الكرسي من صورة بالغرفة من صورة أخرى، مع الحفاظ على شكل الكرسي الخارجي ومادته. وفي مشهد موجود، حدّد الجسم المطلوب تغييره والتفاصيل المطلوب الاحتفاظ بها، بما فيها اتجاه الضوء وهندسة المحيط.
تشمل أمثلة العائلة تغيير الخلفيات واستبدال الأجسام وتركيبات الأثاث وتعديل النصوص والشخصيات المتّسقة. ويمكن لتوجيه مبتكر لصورة نهائية وضع ساعة مقدَّمة على قماش داكن مطوي، مع الاحتفاظ بتصميم الميناء والسوار وتغيير الإضاءة فقط إلى ضوء جانبي ناعم. حدّد المصدر الذي يقدّم كل سمة، وراجع الميناء والعلامات والمادة والانعكاسات الناتجة معًا. تحدّد تعليمات الحفاظ الهدف؛ والصورة الناتجة هي الدليل الذي يُقارَن به.
يوصي دليل FLUX.2 ببنية العنصر–الفعل–الأسلوب–السياق، مع وضع العناصر المهمة أولًا. ويقترح 10–30 كلمة للمفاهيم السريعة و30–80 للمشروعات المعتادة وأوصافًا أطول للمشاهد المعقّدة. وهذه توصيات للكتابة، وليست حدودًا صارمة للسياق. وتُوثَّق اللغة الطبيعية وأوصاف المشاهد المنظمة بصيغة JSON كطريقتين لتنظيم العناصر والمواضع والضوء والأسلوب. والتوجيه المنظم وصف للصورة، وليس وعدًا باستجابة نصية منظمة.
للحروف الظاهرة، ضع النص بين علامتي اقتباس وحدّد موضعه وصِف التسلسل الطباعي. اربط كل لون سداسي بجسم أو عنصر نصي بعينه؛ فرمز اللون من دون هدف مسمّى ملتبس. يستخدم دليل الجهة المطوّرة أوصافًا إيجابية بدلًا من آلية التوجيه السلبي. وفي مشهد منتج به مساحة فارغة لعنوان، صِف تلك المساحة وموضعها المقصود مباشرة.
تطبّق مواصفات طلب [max] المحدّدة توسيع التوجيه افتراضيًا. ويُطفئ عنصر disable_pup هذا التوسيع عندما يجب استخدام توجيه مكتوب بعناية كما قُدّم. وهذا يختلف عن الادعاء بأن كل كلمة ستظهر من دون تغيير في الصورة النهائية. احتفظ بالتوجيه الفعلي والإعداد المختار مع النتيجة عند تقييم ما إذا كان قرار بصري غير متوقّع نابعًا من التعليمات أو من تفسيرها.
يوثّق دليل العائلة صورًا حتى 4 ميغابكسل، بأبعاد صريحة لا تقل عن 64×64 ومن مضاعفات 16. وتوصيته للاستخدام المعتاد حتى 2 ميغابكسل. يسرد ملف [max] المحدّد صيغ JPEG وPNG وWebP، مع JPEG افتراضيًا وبذرة عشوائية اختيارية. اختر شكل المخرجات لموضع استخدامها المقصود قبل ترتيب التكوين. وتوليد الصور في النموذج عملية منفصلة عن تغيير حجم صورة مكتملة بالفعل.
احتفظ بالصورة والمراجع والتوجيه والأبعاد وهوية النموذج عند اختيار النسخة النهائية. وينبّه دليل FLUX.2 لدى المنتج إلى أن رابط النتيجة الموقّع مؤقت، بنافذة استرجاع مدتها عشر دقائق. افحص النص الدقيق وهوية الأجسام والتخطيط والضوء وأي حقائق مستمدة من البحث بحجم العرض المقصود. والناتج المفيد هو الصورة المختارة بسياق كافٍ لمواصلة مراجعة دقيقة، بدلًا من مشهد لم تُقارَن تفاصيله المهمة بالتوجيه قط.
", "aboutText": "FLUX.2 [max] أعلى أعضاء عائلة FLUX.2 من Black Forest Labs جودةً لتوليد الصور وتحريرها. وتضعه الجهة المصنّعة للمخرجات النهائية المتطلّبة والالتزام القوي بتوجيه معقّد والاتساق عبر التعديلات. ينشئ صورة من وصف مكتوب أو يستخدم صورًا مقدَّمة كمراجع بصرية. وقدرته المميِّزة داخل العائلة هي البحث لإسناد التوليد بالمعلومات: يمكن للطلب الاستفادة من معلومات راهنة بدلًا من الاعتماد فقط على المشهد الموصوف في التوجيه.\n\n### المعلومات الواقعية والتوجيه البصري\n\nتوثّق الجهة المطوّرة البحث في الويب لموضوعات مثل الطقس الحالي أو حدث رياضي حديث أو سياق تاريخي. حدّد الموقع والحدث والوقت الفعليين المرتبطين بالصورة، ثم صِف المعالجة الفنية بصورة مستقلة. ويمكن لمفهوم بطاقة طقس مسنَدة بالمعلومات تحديد المدينة والحالة المطلوب تصويرها والعنوان الدقيق والتخطيط. يزوّد البحث عملية التوليد بالمعلومات؛ لكن الرسمة الجذابة تظل بحاجة إلى مقارنة حقائقها الظاهرة بالمصدر المعني قبل استخدامها لتواصل واقعي.\n\nتخص قدرة البحث هذه [max] في مقارنة FLUX.2 المنشورة. وللأعضاء الآخرين المسمّين أدوارهم: [pro] للإنتاج و[flex] لأخذ العينات والطباعة القابلين للضبط و[klein] للتوليد التفاعلي المدمج. احتفظ باسم النموذج المختار مع النتيجة كي لا تستبدل مراجعة لاحقة ملف البحث المسنَد بالمعلومات بإصدار مختلف ضمنيًا.\n\n### مراجع للتعديلات المتطلّبة\n\nيأخذ ملف الطلب الموثّق ما يصل إلى ثماني صور مرجعية؛ وتسمح واجهة الجهة المطوّرة التفاعلية بعشر صور بصورة مستقلة. عيّن دورًا لكل مرجع، مثل مظهر شخصية أو تصميم منتج أو ملابس أو غرفة أو أسلوب بصري. ويمكن لتكوين جمع الكرسي من صورة بالغرفة من صورة أخرى، مع الحفاظ على شكل الكرسي الخارجي ومادته. وفي مشهد موجود، حدّد الجسم المطلوب تغييره والتفاصيل المطلوب الاحتفاظ بها، بما فيها اتجاه الضوء وهندسة المحيط.\n\nتشمل أمثلة العائلة تغيير الخلفيات واستبدال الأجسام وتركيبات الأثاث وتعديل النصوص والشخصيات المتّسقة. ويمكن لتوجيه مبتكر لصورة نهائية وضع ساعة مقدَّمة على قماش داكن مطوي، مع الاحتفاظ بتصميم الميناء والسوار وتغيير الإضاءة فقط إلى ضوء جانبي ناعم. حدّد المصدر الذي يقدّم كل سمة، وراجع الميناء والعلامات والمادة والانعكاسات الناتجة معًا. تحدّد تعليمات الحفاظ الهدف؛ والصورة الناتجة هي الدليل الذي يُقارَن به.\n\n### النص والألوان وتفسير التوجيه\n\nيوصي دليل FLUX.2 ببنية العنصر–الفعل–الأسلوب–السياق، مع وضع العناصر المهمة أولًا. ويقترح 10–30 كلمة للمفاهيم السريعة و30–80 للمشروعات المعتادة وأوصافًا أطول للمشاهد المعقّدة. وهذه توصيات للكتابة، وليست حدودًا صارمة للسياق. وتُوثَّق اللغة الطبيعية وأوصاف المشاهد المنظمة بصيغة JSON كطريقتين لتنظيم العناصر والمواضع والضوء والأسلوب. والتوجيه المنظم وصف للصورة، وليس وعدًا باستجابة نصية منظمة.\n\nللحروف الظاهرة، ضع النص بين علامتي اقتباس وحدّد موضعه وصِف التسلسل الطباعي. اربط كل لون سداسي بجسم أو عنصر نصي بعينه؛ فرمز اللون من دون هدف مسمّى ملتبس. يستخدم دليل الجهة المطوّرة أوصافًا إيجابية بدلًا من آلية التوجيه السلبي. وفي مشهد منتج به مساحة فارغة لعنوان، صِف تلك المساحة وموضعها المقصود مباشرة.\n\nتطبّق مواصفات طلب [max] المحدّدة توسيع التوجيه افتراضيًا. ويُطفئ عنصر disable_pup هذا التوسيع عندما يجب استخدام توجيه مكتوب بعناية كما قُدّم. وهذا يختلف عن الادعاء بأن كل كلمة ستظهر من دون تغيير في الصورة النهائية. احتفظ بالتوجيه الفعلي والإعداد المختار مع النتيجة عند تقييم ما إذا كان قرار بصري غير متوقّع نابعًا من التعليمات أو من تفسيرها.\n\n### المخرجات وصورة نهائية مفيدة\n\nيوثّق دليل العائلة صورًا حتى 4 ميغابكسل، بأبعاد صريحة لا تقل عن 64×64 ومن مضاعفات 16. وتوصيته للاستخدام المعتاد حتى 2 ميغابكسل. يسرد ملف [max] المحدّد صيغ JPEG وPNG وWebP، مع JPEG افتراضيًا وبذرة عشوائية اختيارية. اختر شكل المخرجات لموضع استخدامها المقصود قبل ترتيب التكوين. وتوليد الصور في النموذج عملية منفصلة عن تغيير حجم صورة مكتملة بالفعل.\n\nاحتفظ بالصورة والمراجع والتوجيه والأبعاد وهوية النموذج عند اختيار النسخة النهائية. وينبّه دليل FLUX.2 لدى المنتج إلى أن رابط النتيجة الموقّع مؤقت، بنافذة استرجاع مدتها عشر دقائق. افحص النص الدقيق وهوية الأجسام والتخطيط والضوء وأي حقائق مستمدة من البحث بحجم العرض المقصود. والناتج المفيد هو الصورة المختارة بسياق كافٍ لمواصلة مراجعة دقيقة، بدلًا من مشهد لم تُقارَن تفاصيله المهمة بالتوجيه قط.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "da6444e2406b50f69b63339519d09e4f84f3fe5bec1de86eb4a0db8e0f13eab9", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ar", "methods": [ { "html": "black-forest-labs/flux.2-maxFLUX.2 [max] نموذج الصور من Black Forest Labs للمخرجات النهائية المتطلّبة والتعديلات المتّسقة. يجمع ملفه الموثّق المراجع البصرية والتحكّم التفصيلي بالمشهد والإسناد بمعلومات الويب للموضوعات الراهنة، بمخرجات حتى 4 ميغابكسل.
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
FLUX.2 [max] أعلى أعضاء عائلة FLUX.2 من Black Forest Labs جودةً لتوليد الصور وتحريرها. وتضعه الجهة المصنّعة للمخرجات النهائية المتطلّبة والالتزام القوي بتوجيه معقّد والاتساق عبر التعديلات. ينشئ صورة من وصف مكتوب أو يستخدم صورًا مقدَّمة كمراجع بصرية. وقدرته المميِّزة داخل العائلة هي البحث لإسناد التوليد بالمعلومات: يمكن للطلب الاستفادة من معلومات راهنة بدلًا من الاعتماد فقط على المشهد الموصوف في التوجيه.
توثّق الجهة المطوّرة البحث في الويب لموضوعات مثل الطقس الحالي أو حدث رياضي حديث أو سياق تاريخي. حدّد الموقع والحدث والوقت الفعليين المرتبطين بالصورة، ثم صِف المعالجة الفنية بصورة مستقلة. ويمكن لمفهوم بطاقة طقس مسنَدة بالمعلومات تحديد المدينة والحالة المطلوب تصويرها والعنوان الدقيق والتخطيط. يزوّد البحث عملية التوليد بالمعلومات؛ لكن الرسمة الجذابة تظل بحاجة إلى مقارنة حقائقها الظاهرة بالمصدر المعني قبل استخدامها لتواصل واقعي.
تخص قدرة البحث هذه [max] في مقارنة FLUX.2 المنشورة. وللأعضاء الآخرين المسمّين أدوارهم: [pro] للإنتاج و[flex] لأخذ العينات والطباعة القابلين للضبط و[klein] للتوليد التفاعلي المدمج. احتفظ باسم النموذج المختار مع النتيجة كي لا تستبدل مراجعة لاحقة ملف البحث المسنَد بالمعلومات بإصدار مختلف ضمنيًا.
يأخذ ملف الطلب الموثّق ما يصل إلى ثماني صور مرجعية؛ وتسمح واجهة الجهة المطوّرة التفاعلية بعشر صور بصورة مستقلة. عيّن دورًا لكل مرجع، مثل مظهر شخصية أو تصميم منتج أو ملابس أو غرفة أو أسلوب بصري. ويمكن لتكوين جمع الكرسي من صورة بالغرفة من صورة أخرى، مع الحفاظ على شكل الكرسي الخارجي ومادته. وفي مشهد موجود، حدّد الجسم المطلوب تغييره والتفاصيل المطلوب الاحتفاظ بها، بما فيها اتجاه الضوء وهندسة المحيط.
تشمل أمثلة العائلة تغيير الخلفيات واستبدال الأجسام وتركيبات الأثاث وتعديل النصوص والشخصيات المتّسقة. ويمكن لتوجيه مبتكر لصورة نهائية وضع ساعة مقدَّمة على قماش داكن مطوي، مع الاحتفاظ بتصميم الميناء والسوار وتغيير الإضاءة فقط إلى ضوء جانبي ناعم. حدّد المصدر الذي يقدّم كل سمة، وراجع الميناء والعلامات والمادة والانعكاسات الناتجة معًا. تحدّد تعليمات الحفاظ الهدف؛ والصورة الناتجة هي الدليل الذي يُقارَن به.
يوصي دليل FLUX.2 ببنية العنصر–الفعل–الأسلوب–السياق، مع وضع العناصر المهمة أولًا. ويقترح 10–30 كلمة للمفاهيم السريعة و30–80 للمشروعات المعتادة وأوصافًا أطول للمشاهد المعقّدة. وهذه توصيات للكتابة، وليست حدودًا صارمة للسياق. وتُوثَّق اللغة الطبيعية وأوصاف المشاهد المنظمة بصيغة JSON كطريقتين لتنظيم العناصر والمواضع والضوء والأسلوب. والتوجيه المنظم وصف للصورة، وليس وعدًا باستجابة نصية منظمة.
للحروف الظاهرة، ضع النص بين علامتي اقتباس وحدّد موضعه وصِف التسلسل الطباعي. اربط كل لون سداسي بجسم أو عنصر نصي بعينه؛ فرمز اللون من دون هدف مسمّى ملتبس. يستخدم دليل الجهة المطوّرة أوصافًا إيجابية بدلًا من آلية التوجيه السلبي. وفي مشهد منتج به مساحة فارغة لعنوان، صِف تلك المساحة وموضعها المقصود مباشرة.
تطبّق مواصفات طلب [max] المحدّدة توسيع التوجيه افتراضيًا. ويُطفئ عنصر disable_pup هذا التوسيع عندما يجب استخدام توجيه مكتوب بعناية كما قُدّم. وهذا يختلف عن الادعاء بأن كل كلمة ستظهر من دون تغيير في الصورة النهائية. احتفظ بالتوجيه الفعلي والإعداد المختار مع النتيجة عند تقييم ما إذا كان قرار بصري غير متوقّع نابعًا من التعليمات أو من تفسيرها.
يوثّق دليل العائلة صورًا حتى 4 ميغابكسل، بأبعاد صريحة لا تقل عن 64×64 ومن مضاعفات 16. وتوصيته للاستخدام المعتاد حتى 2 ميغابكسل. يسرد ملف [max] المحدّد صيغ JPEG وPNG وWebP، مع JPEG افتراضيًا وبذرة عشوائية اختيارية. اختر شكل المخرجات لموضع استخدامها المقصود قبل ترتيب التكوين. وتوليد الصور في النموذج عملية منفصلة عن تغيير حجم صورة مكتملة بالفعل.
احتفظ بالصورة والمراجع والتوجيه والأبعاد وهوية النموذج عند اختيار النسخة النهائية. وينبّه دليل FLUX.2 لدى المنتج إلى أن رابط النتيجة الموقّع مؤقت، بنافذة استرجاع مدتها عشر دقائق. افحص النص الدقيق وهوية الأجسام والتخطيط والضوء وأي حقائق مستمدة من البحث بحجم العرض المقصود. والناتج المفيد هو الصورة المختارة بسياق كافٍ لمواصلة مراجعة دقيقة، بدلًا من مشهد لم تُقارَن تفاصيله المهمة بالتوجيه قط.
POST /v1/images/generationstext, imageimage| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود black-forest-labs/flux.2-max | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلبمطلوب | القيم والحدود الحد الأدنى للطول: 1 | القيمة الافتراضية— |
الحقلaspect_ratio | النوعstring | المتطلباختياري | القيم والحدود 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | القيمة الافتراضية— |
الحقلoutput_format | النوعstring | المتطلباختياري | القيم والحدود png, jpeg | القيمة الافتراضية— |
الحقلn | النوعinteger | المتطلباختياري | القيم والحدود الحد الأدنى: 1 الحد الأقصى: 1 | القيمة الافتراضية— |
الحقلinput_references | النوعarray | المتطلباختياري | القيم والحدود الحد الأدنى للعناصر: 0 الحد الأقصى للعناصر: 8 | القيمة الافتراضية— |
الحقل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}
تقدّر التعرفات المعروضة التكلفة قبل التوليد. تُحسب الرسوم النهائية من التكلفة المسجّلة لعملية التوليد الأصلية. مدة المخرجات المقاسة والكميات المتوقعة ليست الكمية النهائية الخاضعة للفوترة.
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | جدول التعرفة | الكمية المتوقعة | وحدة الفوترة | الرسوم |
|---|---|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | الكمية المتوقعة— | وحدة الفوترة— | الرسوم الإدخال · رموز الإدخال · تقدير للمقارنة فقط — / 1K من الرموز الإخراج · رموز الإخراج · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط — / 1K من الرموز |
| الإعداداتميغابكسل من الصورة الناتجة | جدول التعرفة— | الكمية المتوقعة— | وحدة الفوترةلكل ميغابكسل من صورة الإخراج | الرسوم الإخراج · ميغابكسل من الصورة الناتجة · تقدير للمقارنة فقط $0.14 لكل ميغابكسل من صورة الإخراج |
| الإعداداتتكلفة التوليد التقديرية | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | وحدة الفوترة— | الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.14 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة. |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
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': 'black-forest-labs/flux.2-max', '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نزّل كل صورة مُرجعة أو احفظ محتواها بصيغة Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}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 black-forest-labs/flux.2-max
/v1/images