{ "aboutHtml": "

Recraft V4 Pro النموذج النقطي الأعلى دقة في عائلة V4 لدى Recraft. يركّز V4 على الحكم البصري والتكوين المتوازن والألوان المترابطة والتفسير المتأني للاتجاه الإبداعي. ويضع المنتج Pro للتفاصيل الأدق والمشاهد المعقّدة الأكثر واقعية والمرئيات الإنتاجية الكبيرة. استخدمه لرسم تفصيلي أو صورة تحريرية أو مفهوم ملصق أو صورة أخرى تستفيد من نتيجة نقطية أكبر. ويبقى مستقلًا عن نموذج V4.1 اللاحق وعن مخرجات SVG في V4 Pro Vector.

رمز المنتج المحدّد recraftv4_pro. المخرجات الموثّقة نقطية 2K بصيغة WebP من دون فقدان أو PNG: ‏2048 × 2048 بكسل للمربع و2688 × 1536 ل16:9 و1664 × 2560 ل2:3. وللنسب المدعومة الأخرى أبعادها الخاصة. اختر نسبة أبعاد للتخطيط المقصود أو حجمًا دقيقًا مسموحًا؛ فحجم البكسلات الاعتباطي ليس جزءًا من عقد التوليد الموثّق. ولV4 القياسي مخرجات نقطية 1K أصغر، بينما لا تملك النماذج المتجهية دقة بكسلات ثابتة.

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

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

يسمح مرجع التوليد الحالي بتوجيهات حتى 10,000 حرف ومخرج واحد إلى ستة مخرجات وبذرة عشوائية وعناصر للألوان المفضّلة ولون الخلفية. ويمكن لأساليب مخصّصة اختيارية أو صور مرجعية متوافقة توجيه المظهر بمطابقة مرنة أو دقيقة. ولا يقبل النموذج عناصر V3 الأقدم negative_prompt أو الأساليب المنسّقة أو text_layout أو artistic_level أو no_text. صِف الصورة النهائية المقصودة في التوجيه الإيجابي وأبقِ متطلبات العنصر والتخطيط والألوان صريحة. وللتوليد بأسلوب مرجعي، استخدم من صورة واحدة إلى عشر صور PNG أو JPG أو WebP، بإجمالي لا يتجاوز 64 MB وحجم أقل من 20 MB لكل صورة. ويحتاج كل مرجع إلى ضلع أقصر لا يقل عن 256 بكسل وضلع أطول لا يزيد على 4,096 بكسل ودقة لا تتجاوز 16 ميغابكسل. استخدم هذه المراجع أو أسلوبًا محفوظًا متوافقًا، لا كليهما.

توثّق Recraft عملية مستقلة من صورة إلى صورة لV4. تجمع صورة موجودة وتوجيهًا مع قوة من 0 إلى 1 للتحكّم بدرجة التغيير، ولا تقبل عناصر أسلوب V4 المخصّص في تلك العملية. جهّز المصدر ضمن حدود إدخال الصور لدى المنتج واذكر الصفات التي يجب أن تنتقل إلى النتيجة الجديدة. ولصورة نهائية أكبر، افحص التفاصيل الدقيقة والاقتصاص والحروف بالحجم المقصود. تدعم التفاصيل النقطية الإضافية في Pro ذلك الفحص، بينما تبقى الصورة تفسيرًا مولَّدًا للتوجيه الإبداعي المقدَّم. وللتحويل من صورة إلى صورة، قدّم PNG أو JPG أو WebP أو SVG بحجم أقل من 20 MB، ودقة لا تتجاوز 16 ميغابكسل، وكلا الضلعين بين 256 و4,096 بكسل.

", "aboutText": "Recraft V4 Pro النموذج النقطي الأعلى دقة في عائلة V4 لدى Recraft. يركّز V4 على الحكم البصري والتكوين المتوازن والألوان المترابطة والتفسير المتأني للاتجاه الإبداعي. ويضع المنتج Pro للتفاصيل الأدق والمشاهد المعقّدة الأكثر واقعية والمرئيات الإنتاجية الكبيرة. استخدمه لرسم تفصيلي أو صورة تحريرية أو مفهوم ملصق أو صورة أخرى تستفيد من نتيجة نقطية أكبر. ويبقى مستقلًا عن نموذج V4.1 اللاحق وعن مخرجات SVG في V4 Pro Vector.\n\nرمز المنتج المحدّد recraftv4_pro. المخرجات الموثّقة نقطية 2K بصيغة WebP من دون فقدان أو PNG: ‏2048 × 2048 بكسل للمربع و2688 × 1536 ل16:9 و1664 × 2560 ل2:3. وللنسب المدعومة الأخرى أبعادها الخاصة. اختر نسبة أبعاد للتخطيط المقصود أو حجمًا دقيقًا مسموحًا؛ فحجم البكسلات الاعتباطي ليس جزءًا من عقد التوليد الموثّق. ولV4 القياسي مخرجات نقطية 1K أصغر، بينما لا تملك النماذج المتجهية دقة بكسلات ثابتة.\n\nيمكن لV4 تفسير توجيه قصير للاستكشاف أو توجيه منظم لنتيجة منضبطة. وللاتجاه الفني المحدّد، ينتقل دليل الجهة المصنّعة من العنصر والبيئة إلى التأطير والصفات والعلاقات المكانية والإضاءة والعمق والمزاج. ولصورة منتج تحريرية، اطلب صورة رأسية درامية لكرسي نحتي بأسطح معدنية مصقولة بالفرشاة وإضاءة جانبية وخلفية داكنة هادئة ومساحة فوق الجسم لعنوان. تسمية هذه العلاقات تجعل التكوين المقصود أوضح من طلب عام لصورة فاخرة.\n\nيشمل المجال الإبداعي للعائلة الرسوم السردية والمشاهد الواقعية والمرئيات المجسّمة بإشارات للمادة والإضاءة. وتظل النتيجة ذات المظهر الثلاثي الأبعاد صورة، لا مشهدًا ثلاثي الأبعاد قابلًا للتحرير. ولملصق جرافيكي، حدّد الطبقات البصرية وتفاعلها: الخلفية والرسم أو الصورة والتسلسل الهرمي للعناوين والنص المساند. يُقدَّم V4 لعبارات قصيرة ومتوسطة الطول مقروءة، لكن ينبغي فحص الإملاء والتسلسل النهائيين بدلًا من استنتاجهما من اسم النموذج.\n\nيسمح مرجع التوليد الحالي بتوجيهات حتى 10,000 حرف ومخرج واحد إلى ستة مخرجات وبذرة عشوائية وعناصر للألوان المفضّلة ولون الخلفية. ويمكن لأساليب مخصّصة اختيارية أو صور مرجعية متوافقة توجيه المظهر بمطابقة مرنة أو دقيقة. ولا يقبل النموذج عناصر V3 الأقدم negative_prompt أو الأساليب المنسّقة أو text_layout أو artistic_level أو no_text. صِف الصورة النهائية المقصودة في التوجيه الإيجابي وأبقِ متطلبات العنصر والتخطيط والألوان صريحة. وللتوليد بأسلوب مرجعي، استخدم من صورة واحدة إلى عشر صور PNG أو JPG أو WebP، بإجمالي لا يتجاوز 64 MB وحجم أقل من 20 MB لكل صورة. ويحتاج كل مرجع إلى ضلع أقصر لا يقل عن 256 بكسل وضلع أطول لا يزيد على 4,096 بكسل ودقة لا تتجاوز 16 ميغابكسل. استخدم هذه المراجع أو أسلوبًا محفوظًا متوافقًا، لا كليهما.\n\nتوثّق Recraft عملية مستقلة من صورة إلى صورة لV4. تجمع صورة موجودة وتوجيهًا مع قوة من 0 إلى 1 للتحكّم بدرجة التغيير، ولا تقبل عناصر أسلوب V4 المخصّص في تلك العملية. جهّز المصدر ضمن حدود إدخال الصور لدى المنتج واذكر الصفات التي يجب أن تنتقل إلى النتيجة الجديدة. ولصورة نهائية أكبر، افحص التفاصيل الدقيقة والاقتصاص والحروف بالحجم المقصود. تدعم التفاصيل النقطية الإضافية في Pro ذلك الفحص، بينما تبقى الصورة تفسيرًا مولَّدًا للتوجيه الإبداعي المقدَّم. وللتحويل من صورة إلى صورة، قدّم PNG أو JPG أو WebP أو SVG بحجم أقل من 20 MB، ودقة لا تتجاوز 16 ميغابكسل، وكلا الضلعين بين 256 و4,096 بكسل.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "9e7f6e5e0e8d045e28496a2212771f422694a2b58ab41a81c1f0b73d429e991c", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ar", "methods": [ { "html": "

•

Recraft: Recraft V4 Pro

Recraft /recraft/recraft-v4-pro

البداية

يولّد Recraft V4 Pro صورًا نقطية 2K للتكوينات التفصيلية والواقعية الفوتوغرافية والرسوم التوضيحية والعمل الإبداعي الموجّه للطباعة. وهو إصدار V4 الأعلى دقة، بتوجيهات نصية ومدخلات أسلوبية اختيارية ومسار مستقل للتحويل من صورة إلى صورة.

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

عن النموذج

يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.

Recraft V4 Pro النموذج النقطي الأعلى دقة في عائلة V4 لدى Recraft. يركّز V4 على الحكم البصري والتكوين المتوازن والألوان المترابطة والتفسير المتأني للاتجاه الإبداعي. ويضع المنتج Pro للتفاصيل الأدق والمشاهد المعقّدة الأكثر واقعية والمرئيات الإنتاجية الكبيرة. استخدمه لرسم تفصيلي أو صورة تحريرية أو مفهوم ملصق أو صورة أخرى تستفيد من نتيجة نقطية أكبر. ويبقى مستقلًا عن نموذج V4.1 اللاحق وعن مخرجات SVG في V4 Pro Vector.

رمز المنتج المحدّد recraftv4_pro. المخرجات الموثّقة نقطية 2K بصيغة WebP من دون فقدان أو PNG: ‏2048 × 2048 بكسل للمربع و2688 × 1536 ل16:9 و1664 × 2560 ل2:3. وللنسب المدعومة الأخرى أبعادها الخاصة. اختر نسبة أبعاد للتخطيط المقصود أو حجمًا دقيقًا مسموحًا؛ فحجم البكسلات الاعتباطي ليس جزءًا من عقد التوليد الموثّق. ولV4 القياسي مخرجات نقطية 1K أصغر، بينما لا تملك النماذج المتجهية دقة بكسلات ثابتة.

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

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

يسمح مرجع التوليد الحالي بتوجيهات حتى 10,000 حرف ومخرج واحد إلى ستة مخرجات وبذرة عشوائية وعناصر للألوان المفضّلة ولون الخلفية. ويمكن لأساليب مخصّصة اختيارية أو صور مرجعية متوافقة توجيه المظهر بمطابقة مرنة أو دقيقة. ولا يقبل النموذج عناصر V3 الأقدم negative_prompt أو الأساليب المنسّقة أو text_layout أو artistic_level أو no_text. صِف الصورة النهائية المقصودة في التوجيه الإيجابي وأبقِ متطلبات العنصر والتخطيط والألوان صريحة. وللتوليد بأسلوب مرجعي، استخدم من صورة واحدة إلى عشر صور PNG أو JPG أو WebP، بإجمالي لا يتجاوز 64 MB وحجم أقل من 20 MB لكل صورة. ويحتاج كل مرجع إلى ضلع أقصر لا يقل عن 256 بكسل وضلع أطول لا يزيد على 4,096 بكسل ودقة لا تتجاوز 16 ميغابكسل. استخدم هذه المراجع أو أسلوبًا محفوظًا متوافقًا، لا كليهما.

توثّق Recraft عملية مستقلة من صورة إلى صورة لV4. تجمع صورة موجودة وتوجيهًا مع قوة من 0 إلى 1 للتحكّم بدرجة التغيير، ولا تقبل عناصر أسلوب V4 المخصّص في تلك العملية. جهّز المصدر ضمن حدود إدخال الصور لدى المنتج واذكر الصفات التي يجب أن تنتقل إلى النتيجة الجديدة. ولصورة نهائية أكبر، افحص التفاصيل الدقيقة والاقتصاص والحروف بالحجم المقصود. تدعم التفاصيل النقطية الإضافية في Pro ذلك الفحص، بينما تبقى الصورة تفسيرًا مولَّدًا للتوجيه الإبداعي المقدَّم. وللتحويل من صورة إلى صورة، قدّم PNG أو JPG أو WebP أو SVG بحجم أقل من 20 MB، ودقة لا تتجاوز 16 ميغابكسل، وكلا الضلعين بين 256 و4,096 بكسل.

متاح في Ailoot · المدخلات والطرائق

Ailoot Ultra · الصور POST /v1/images/generations

الإدخال: text, image
الإخراج: image
صيغة الإخراج: ملف صورة

الحقل	النوع	المتطلب	القيم والحدود	القيمة الافتراضية
الحقل`model`	النوع`string`	المتطلبمطلوب	القيم والحدود recraft/recraft-v4-pro	القيمة الافتراضية—
الحقل`prompt`	النوع`string`	المتطلبمطلوب	القيم والحدود الحد الأدنى للطول: ⁦1⁩	القيمة الافتراضية—
الحقل`n`	النوع`integer`	المتطلباختياري	القيم والحدود الحد الأدنى: ⁦1⁩ الحد الأقصى: ⁦6⁩	القيمة الافتراضية—
الحقل`aspect_ratio`	النوع`string`	المتطلباختياري	القيم والحدود 1:1, 4:3, 3:4, 16:9, 9:16, auto	القيمة الافتراضية—
الحقل`input_references`	النوع`array`	المتطلباختياري	القيم والحدود الحد الأدنى للعناصر: ⁦0⁩ الحد الأقصى للعناصر: ⁦1⁩	القيمة الافتراضية—

تركيبات مواد الإدخال

تحويل النص إلى صورة · مطلوب: prompt

معلمات الطريقة ودورة حياتها

المعلمة	المواصفات
المعلمة`content_type`	المواصفاتapplication/json
المعلمة`required`	المواصفاتmodel, prompt
المعلمة`material_types`	المواصفاتtext, image
المعلمة`optional_controls`	المواصفاتaspect_ratio, n, input_references
المعلمة`exact_supported_parameters`	المواصفات{"aspect_ratio":{"type":"enum","values":["1:1","4:3","3:4","16:9","9:16","auto"]},"n":{"type":"range","min":1,"max":6},"input_references":{"type":"range","min":0,"max":1}}
المعلمة`reference_material_rule`	المواصفاتمراجع الصور الفعلية الخاصة بالعميل فقط؛ وتخضع لشروط نقطة النهاية لدى المزوّد.

الأسماء البديلة للطريقة: /v1/images

دورة الحياة: 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 من الرموز
الإعداداتUltra	جدول التعرفة—	الكمية المتوقعة—	وحدة الفوترةلكل صورة مُخرجة	الرسوم الإخراج · إخراج الصور · تقدير للمقارنة فقط $0.5 لكل صورة مُخرجة
الإعداداتتكلفة التوليد التقديرية	جدول التعرفة—	الكمية المتوقعةتقدير لتوليد واحد	وحدة الفوترة—	الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.5 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة.

تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →

تفاصيل التعرفة المرجعية

لا تغيّر جداول التعرفة المرجعية على مستوى النموذج اختيار الطريقة أو عروض الأسعار أو الرسوم. وتستخدم الرسوم الفعلية تعرفات طريقة Ailoot المحددة.

إعدادات تسعير الصور

الأسعار حسب الإعدادات

الإعدادات	شروط الفوترة	الرسوم
الإعداداتصورة المخرجات	شروط الفوترةلم يُعلَن أي خيار تسعير بديل.	الرسوم الإخراج · صورة المخرجات $0.5 لكل صورة تصف البنود المتكافئة الرسم نفسه؛ ولا تضيف رسماً ثانياً.

أمثلة للطلبات

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': 'recraft/recraft-v4-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

from openai import OpenAI\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")\n\nrequest={'model': 'recraft/recraft-v4-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\n

import OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "recraft/recraft-v4-pro", "prompt": "a red panda astronaut floating in space, studio lighting"};\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n  const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n  if(!encoded && uri.startsWith("data:image/")) {\n    const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n    encoded=uri.slice(comma+1);\n  }\n  if(encoded) {\n    if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n    raw=Buffer.from(encoded,"base64");\n  } else if(uri) {\n    const u=new URL(uri,"https://api.ailoot.ai");\n    if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n    const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n    const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n    if(!response.ok) throw new Error("Image content download failed: "+response.status);\n    raw=Buffer.from(await response.arrayBuffer());\n  } else throw new Error("Image has neither bytes nor URL");\n  if(!raw.length) throw new Error("Empty image result");\n  const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n  writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\n

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

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}

الاحتفاظ بكل النتائج المكتملة

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

احتفظ بكل عنصر بيانات وبالاستخدام كاملاً؛ واحفظ جميع الصور الفعلية المُعادة كأصول مملوكة لك. لا تختلق عناوين URL أو معرّفات.

عند الحاجة إلى التحقق من الاستجابة الأصلية

إذا تطلبت نتيجة توليد صورة أو تعديلها التحقق، فاحتفظ بقيمة operation_id/X-Client-Request-ID الأصلية ومعلومات النتيجة المُعادة. استعد النتائج الموجودة والمملوكة لك عبر مكتبة الوسائط باستخدام قيم task_id أو asset_id الفعلية. لا تُعِد إرسال طلب التوليد أو التعديل، ولا تنشئ عنوان URL للاستعلام الدوري من operation_id.

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

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

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

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

Ailoot Ultra recraft/recraft-v4-pro

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

/v1/images

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

recraft/recraft-v4-pro

", "method_identity": { "effective_request_model_id": "recraft/recraft-v4-pro", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "recraft/recraft-v4-pro", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|recraft%2Frecraft-v4-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 every data item and complete usage; own and save all actual returned images. No invented URLs or IDs.", "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": "إذا تطلبت نتيجة توليد صورة أو تعديلها التحقق، فاحتفظ بقيمة operation_id/X-Client-Request-ID الأصلية ومعلومات النتيجة المُعادة. استعد النتائج الموجودة والمملوكة لك عبر مكتبة الوسائط باستخدام قيم task_id أو asset_id الفعلية. لا تُعِد إرسال طلب التوليد أو التعديل، ولا تنشئ عنوان URL للاستعلام الدوري من operation_id." }, "material_combinations": [ { "content_type": "application/json", "mode": "text_to_image", "required": [ "prompt" ] } ], "outputs": { "all_results": "احتفظ بكل عنصر بيانات وبالاستخدام كاملاً؛ واحفظ جميع الصور الفعلية المُعادة كأصول مملوكة لك. لا تختلق عناوين URL أو معرّفات.", "family": "image", "fields": [ { "description": null, "name": "created", "type": "integer" }, { "description": null, "name": "data[].url", "type": "string" }, { "description": null, "name": "data[].b64_json", "type": "base64 string" }, { "description": null, "name": "usage", "type": "object" } ], "format": "actual validated raster MIME" }, "parameters": [ { "availability": "source_interface", "enum": [ "recraft/recraft-v4-pro" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "saved_exact_supplier_endpoint", "maximum": 6, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "availability": "saved_exact_supplier_endpoint", "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "availability": "saved_exact_supplier_endpoint", "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "material_rule": "Actual customer HTTP(S) image URL or base64 data URI; no invented reference URL.", "maximum_items": 1, "minimum_items": 0, "name": "input_references", "required": false, "type": "array" } ], "request_schema": { "properties": { "aspect_ratio": { "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "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": [ "recraft/recraft-v4-pro" ], "type": "string" }, "n": { "maximum": 6, "minimum": 1, "type": "integer" }, "prompt": { "minLength": 1, "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "model": "recraft/recraft-v4-pro", "prompt": "a red panda astronaut floating in space, studio lighting" }, "content_type": "application/json" } }, "hints": [ "استخدم النموذج الدقيق وحقول الإدخال الموثّقة.", "احتفظ بالاستجابة كاملة، وكل مخرج فعلي، والمعرّفات الأصلية المُعادة." ], "input": { "content_type": "application/json", "exact_supported_parameters": { "aspect_ratio": { "type": "enum", "values": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ] }, "input_references": { "max": 1, "min": 0, "type": "range" }, "n": { "max": 6, "min": 1, "type": "range" } }, "material_types": [ "text", "image" ], "optional_controls": [ "aspect_ratio", "n", "input_references" ], "reference_material_rule": "مراجع الصور الفعلية الخاصة بالعميل فقط؛ وتخضع لشروط نقطة النهاية لدى المزوّد.", "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": "If an image generation or edit result requires a check, keep the original operation_id/X-Client-Request-ID and returned result information. Recover existing owned results through the media library using actual task_id or asset_id values. Do not resubmit the generation/edit request or construct a polling URL from operation_id." }, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [ "/v1/images" ], "operation_modes": [ "text_to_image", "reference_guided_image" ], "output": { "all_results": true, "family": "image", "format": "actual validated raster MIME", "result": "every actual owned URL or b64_json" } }, "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" } ] }, { "dimensions": { "quantity_basis": "actual physical units", "quoted_unit": "per image output" }, "label": "Ultra", "units": [ { "amount": "0.5", "amount_unit": "usd_per_image_output", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "image output", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "per image output", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "تكلفة التوليد التقديرية", "units": [ { "amount": "0.5", "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.5", "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': 'recraft/recraft-v4-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\"