{ "aboutHtml": "

GPT Image 2.5 Flare هو إصدار OpenAI لتوليد الصور وتحريرها، والمقدَّم للأعمال اليومية السريعة عالية الجودة. يقبل النصوص والصور ويُرجع نتائج صورية. استخدمه للمسودات البصرية والرسوم التوضيحية ومفاهيم المنتجات والمهام الإبداعية المتكررة التي تحتاج إلى تحويل موجز إلى صورة قابلة للاستخدام سريعًا. يختلف Flare عن Sunburst الذي يركز تقديمه على دقة التحرير. اختر Flare لإنشاء الصور المعتاد وSunburst عندما تكون دقة التحرير هي الأولوية.

ابدأ بالموضوع الرئيسي والفعل والبيئة والتكوين والمعالجة البصرية. ولرسم حملة، اطلب راكب دراجة يعبر جسرًا صغيرًا في ضوء مسائي دافئ، بهيئة بارزة وسماء مفتوحة لنص لاحق. يمكن لموجز استكشاف موجز أن يترك القرارات الجمالية مفتوحة؛ أما موجز الإنتاج فينبغي أن يسمّي التفاصيل والمواضع المهمة. تتيح مسارات التوليد والتحرير المباشرة تعليمات حتى 32,000 محرف ومن نتيجة واحدة إلى عشر، مما يفيد في مقارنة بضع نسخ بالغرض نفسه.

يمكن للتحرير استخدام ما يصل إلى ست عشرة صورة مرجعية. حدّد دورًا واضحًا لكل مرجع بدلًا من توقّع أن يقرر النموذج ما إذا كانت الصورة تمثّل هوية الموضوع أو المشهد أو الأسلوب. يمكن لقناع توجيه تغيير في منطقة؛ وينطبق على الصورة الأولى عند تعدد الصور. تحتاج الصورة والقناع إلى صيغة وأبعاد متطابقة، ويجب أن يتضمن القناع قناة ألفا. يشترط الدليل أن يكون المصدر والقناع أقل من 50 MB. القناع توجيه وليس وعدًا بالحفاظ الدقيق على الحدود، لذا حدّد التعديل المطلوب وما ينبغي أن يظل قابلًا للتعرّف معًا.

يدعم Flare جودة low وmedium وhigh وxhigh وmax وتلقائية، مع auto افتراضيًا. يمكن للجودة الأقل خدمة مسودة بصرية سريعة؛ ويمكن مقارنة الإعدادات الأعلى لتفاصيل المادة النهائية. الجودة مستقلة عن الحجم وضغط الإخراج. تشمل الأحجام القياسية 1024 × 1024 و1536 × 1024 و1024 × 1536، وتتاح أيضًا أبعاد تلقائية أو مخصصة. اختر الاتجاه وفق الموضع النهائي والمساحة المفيدة في المشهد.

يجب أن يكون العرض والارتفاع المخصصان من مضاعفات ستة عشر، وألا يزيد أي ضلع على 3840 بكسل. تتراوح النسبة المسموحة من 1:3 إلى 3:1، ويجب ألا تقل المساحة الإجمالية عن 655,360 وألا تزيد على 8,294,400 بكسل. تنطبق الشروط الأربعة معًا. يصنّف الدليل الدقات الأعلى من 2560 × 1440 بأنها تجريبية. استخدم إطارًا صالحًا يناسب التكوين، وأدرج أي تفاصيل حساسة للاقتصاص في الموجز بدلًا من التعامل مع دقة أكبر باعتبارها تحسينًا تلقائيًا للتخطيط.

صيغة النتيجة PNG افتراضيًا، مع بديلَي JPEG وWebP. يتيح JPEG وWebP ضغطًا من 0 إلى 100. ولخلفية شفافة، اختر PNG أو WebP؛ وتُدعم أيضًا الخلفيات المعتمة والتلقائية. يمكن وضع مادة شفافة في تخطيط لاحق، بينما تضم الصورة المعتمة خلفيتها الخاصة. اختر الصيغة والخلفية والضغط وفق الحاجة الفعلية للتسليم، واحتفظ بالملف المكتمل مع الموجز والإعدادات المختارة.

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

افحص حروف الصورة ومواضع العناصر وتفاصيل الموضوع والتكوين بالحجم المقصود. قد يظل GPT Image يواجه صعوبة في وضع النص بدقة والتخطيطات المنظّمة وتكرار الهوية البصرية بين عمليات التوليد. احتفظ بنسخة مقبولة مرجعًا تاليًا، وضيّق التعديل اللاحق إلى المشكلة المهمة. يفيد دور Flare في التوليد اليومي ضمن تسلسل واضح يبدأ بالموجز ثم البدائل البصرية والاختيار والتحسين، مع الحكم على المادة النهائية بحسب الغرض الإبداعي الفعلي.

", "aboutText": "GPT Image 2.5 Flare هو إصدار OpenAI لتوليد الصور وتحريرها، والمقدَّم للأعمال اليومية السريعة عالية الجودة. يقبل النصوص والصور ويُرجع نتائج صورية. استخدمه للمسودات البصرية والرسوم التوضيحية ومفاهيم المنتجات والمهام الإبداعية المتكررة التي تحتاج إلى تحويل موجز إلى صورة قابلة للاستخدام سريعًا. يختلف Flare عن Sunburst الذي يركز تقديمه على دقة التحرير. اختر Flare لإنشاء الصور المعتاد وSunburst عندما تكون دقة التحرير هي الأولوية.\n\nابدأ بالموضوع الرئيسي والفعل والبيئة والتكوين والمعالجة البصرية. ولرسم حملة، اطلب راكب دراجة يعبر جسرًا صغيرًا في ضوء مسائي دافئ، بهيئة بارزة وسماء مفتوحة لنص لاحق. يمكن لموجز استكشاف موجز أن يترك القرارات الجمالية مفتوحة؛ أما موجز الإنتاج فينبغي أن يسمّي التفاصيل والمواضع المهمة. تتيح مسارات التوليد والتحرير المباشرة تعليمات حتى 32,000 محرف ومن نتيجة واحدة إلى عشر، مما يفيد في مقارنة بضع نسخ بالغرض نفسه.\n\nيمكن للتحرير استخدام ما يصل إلى ست عشرة صورة مرجعية. حدّد دورًا واضحًا لكل مرجع بدلًا من توقّع أن يقرر النموذج ما إذا كانت الصورة تمثّل هوية الموضوع أو المشهد أو الأسلوب. يمكن لقناع توجيه تغيير في منطقة؛ وينطبق على الصورة الأولى عند تعدد الصور. تحتاج الصورة والقناع إلى صيغة وأبعاد متطابقة، ويجب أن يتضمن القناع قناة ألفا. يشترط الدليل أن يكون المصدر والقناع أقل من 50 MB. القناع توجيه وليس وعدًا بالحفاظ الدقيق على الحدود، لذا حدّد التعديل المطلوب وما ينبغي أن يظل قابلًا للتعرّف معًا.\n\nيدعم Flare جودة low وmedium وhigh وxhigh وmax وتلقائية، مع auto افتراضيًا. يمكن للجودة الأقل خدمة مسودة بصرية سريعة؛ ويمكن مقارنة الإعدادات الأعلى لتفاصيل المادة النهائية. الجودة مستقلة عن الحجم وضغط الإخراج. تشمل الأحجام القياسية 1024 × 1024 و1536 × 1024 و1024 × 1536، وتتاح أيضًا أبعاد تلقائية أو مخصصة. اختر الاتجاه وفق الموضع النهائي والمساحة المفيدة في المشهد.\n\nيجب أن يكون العرض والارتفاع المخصصان من مضاعفات ستة عشر، وألا يزيد أي ضلع على 3840 بكسل. تتراوح النسبة المسموحة من 1:3 إلى 3:1، ويجب ألا تقل المساحة الإجمالية عن 655,360 وألا تزيد على 8,294,400 بكسل. تنطبق الشروط الأربعة معًا. يصنّف الدليل الدقات الأعلى من 2560 × 1440 بأنها تجريبية. استخدم إطارًا صالحًا يناسب التكوين، وأدرج أي تفاصيل حساسة للاقتصاص في الموجز بدلًا من التعامل مع دقة أكبر باعتبارها تحسينًا تلقائيًا للتخطيط.\n\nصيغة النتيجة PNG افتراضيًا، مع بديلَي JPEG وWebP. يتيح JPEG وWebP ضغطًا من 0 إلى 100. ولخلفية شفافة، اختر PNG أو WebP؛ وتُدعم أيضًا الخلفيات المعتمة والتلقائية. يمكن وضع مادة شفافة في تخطيط لاحق، بينما تضم الصورة المعتمة خلفيتها الخاصة. اختر الصيغة والخلفية والضغط وفق الحاجة الفعلية للتسليم، واحتفظ بالملف المكتمل مع الموجز والإعدادات المختارة.\n\nيوثّق المنتج التوليد المباشر للصور وتحريرها، بالإضافة إلى أداة صور حوارية يمكنها الاحتفاظ بنتائج مختارة لإجراء تغييرات لاحقة. وفي ذلك المسار، يمكن أن يكون الإجراء تلقائيًا أو توليدًا مفروضًا أو تحريرًا مفروضًا عند وجود صورة في السياق. يمكن للبث عرض ما يصل إلى ثلاث صور جزئية قبل النتيجة النهائية. تقدّم هذه المعاينات عرضًا للتقدم، لا مواد مكتملة إضافية. وللعمل التكراري، تابع من الصورة المختارة وصِف تغييرًا مرئيًا، مثل تحريك عنصر واحد أو تعديل المعالجة اللونية. وتدعم واجهة الشركة المصنّعة أيضًا المعالجة الدفعية.\n\nافحص حروف الصورة ومواضع العناصر وتفاصيل الموضوع والتكوين بالحجم المقصود. قد يظل GPT Image يواجه صعوبة في وضع النص بدقة والتخطيطات المنظّمة وتكرار الهوية البصرية بين عمليات التوليد. احتفظ بنسخة مقبولة مرجعًا تاليًا، وضيّق التعديل اللاحق إلى المشكلة المهمة. يفيد دور Flare في التوليد اليومي ضمن تسلسل واضح يبدأ بالموجز ثم البدائل البصرية والاختيار والتحسين، مع الحكم على المادة النهائية بحسب الغرض الإبداعي الفعلي.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "8431bb73bf9d9fe67fa68a09981dadf62ed4459577aec7b87decfaf905e1cb6e", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ar", "methods": [ { "html": "

O

OpenAI: GPT Image 2.5 Flare

OpenAI /gpt-image-2.5-flare

البداية

يولّد GPT Image 2.5 Flare الصور ويحرّرها من النصوص والمراجع، مع التركيز على الإنشاء البصري اليومي السريع. يدعم الأحجام المخصصة والخلفيات الشفافة والأقنعة ومستويات الجودة حتى max للمسودات والرسوم التوضيحية ومواد الحملات.

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

عن النموذج

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

GPT Image 2.5 Flare هو إصدار OpenAI لتوليد الصور وتحريرها، والمقدَّم للأعمال اليومية السريعة عالية الجودة. يقبل النصوص والصور ويُرجع نتائج صورية. استخدمه للمسودات البصرية والرسوم التوضيحية ومفاهيم المنتجات والمهام الإبداعية المتكررة التي تحتاج إلى تحويل موجز إلى صورة قابلة للاستخدام سريعًا. يختلف Flare عن Sunburst الذي يركز تقديمه على دقة التحرير. اختر Flare لإنشاء الصور المعتاد وSunburst عندما تكون دقة التحرير هي الأولوية.

ابدأ بالموضوع الرئيسي والفعل والبيئة والتكوين والمعالجة البصرية. ولرسم حملة، اطلب راكب دراجة يعبر جسرًا صغيرًا في ضوء مسائي دافئ، بهيئة بارزة وسماء مفتوحة لنص لاحق. يمكن لموجز استكشاف موجز أن يترك القرارات الجمالية مفتوحة؛ أما موجز الإنتاج فينبغي أن يسمّي التفاصيل والمواضع المهمة. تتيح مسارات التوليد والتحرير المباشرة تعليمات حتى 32,000 محرف ومن نتيجة واحدة إلى عشر، مما يفيد في مقارنة بضع نسخ بالغرض نفسه.

يمكن للتحرير استخدام ما يصل إلى ست عشرة صورة مرجعية. حدّد دورًا واضحًا لكل مرجع بدلًا من توقّع أن يقرر النموذج ما إذا كانت الصورة تمثّل هوية الموضوع أو المشهد أو الأسلوب. يمكن لقناع توجيه تغيير في منطقة؛ وينطبق على الصورة الأولى عند تعدد الصور. تحتاج الصورة والقناع إلى صيغة وأبعاد متطابقة، ويجب أن يتضمن القناع قناة ألفا. يشترط الدليل أن يكون المصدر والقناع أقل من 50 MB. القناع توجيه وليس وعدًا بالحفاظ الدقيق على الحدود، لذا حدّد التعديل المطلوب وما ينبغي أن يظل قابلًا للتعرّف معًا.

يدعم Flare جودة low وmedium وhigh وxhigh وmax وتلقائية، مع auto افتراضيًا. يمكن للجودة الأقل خدمة مسودة بصرية سريعة؛ ويمكن مقارنة الإعدادات الأعلى لتفاصيل المادة النهائية. الجودة مستقلة عن الحجم وضغط الإخراج. تشمل الأحجام القياسية 1024 × 1024 و1536 × 1024 و1024 × 1536، وتتاح أيضًا أبعاد تلقائية أو مخصصة. اختر الاتجاه وفق الموضع النهائي والمساحة المفيدة في المشهد.

يجب أن يكون العرض والارتفاع المخصصان من مضاعفات ستة عشر، وألا يزيد أي ضلع على 3840 بكسل. تتراوح النسبة المسموحة من 1:3 إلى 3:1، ويجب ألا تقل المساحة الإجمالية عن 655,360 وألا تزيد على 8,294,400 بكسل. تنطبق الشروط الأربعة معًا. يصنّف الدليل الدقات الأعلى من 2560 × 1440 بأنها تجريبية. استخدم إطارًا صالحًا يناسب التكوين، وأدرج أي تفاصيل حساسة للاقتصاص في الموجز بدلًا من التعامل مع دقة أكبر باعتبارها تحسينًا تلقائيًا للتخطيط.

صيغة النتيجة PNG افتراضيًا، مع بديلَي JPEG وWebP. يتيح JPEG وWebP ضغطًا من 0 إلى 100. ولخلفية شفافة، اختر PNG أو WebP؛ وتُدعم أيضًا الخلفيات المعتمة والتلقائية. يمكن وضع مادة شفافة في تخطيط لاحق، بينما تضم الصورة المعتمة خلفيتها الخاصة. اختر الصيغة والخلفية والضغط وفق الحاجة الفعلية للتسليم، واحتفظ بالملف المكتمل مع الموجز والإعدادات المختارة.

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

افحص حروف الصورة ومواضع العناصر وتفاصيل الموضوع والتكوين بالحجم المقصود. قد يظل GPT Image يواجه صعوبة في وضع النص بدقة والتخطيطات المنظّمة وتكرار الهوية البصرية بين عمليات التوليد. احتفظ بنسخة مقبولة مرجعًا تاليًا، وضيّق التعديل اللاحق إلى المشكلة المهمة. يفيد دور Flare في التوليد اليومي ضمن تسلسل واضح يبدأ بالموجز ثم البدائل البصرية والاختيار والتحسين، مع الحكم على المادة النهائية بحسب الغرض الإبداعي الفعلي.

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

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

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

الحقل	النوع	المتطلب	القيم والحدود	القيمة الافتراضية
الحقل`model`	النوع`string`	المتطلبمطلوب	القيم والحدود gpt-image-2.5-flare	القيمة الافتراضية—
الحقل`prompt`	النوع`string`	المتطلبمطلوب	القيم والحدود الحد الأدنى للطول: ⁦1⁩	القيمة الافتراضية—
الحقل`n`	النوع`integer`	المتطلباختياري	القيم والحدود الحد الأدنى: ⁦1⁩	القيمة الافتراضية⁦1⁩
الحقل`response_format`	النوع`string`	المتطلباختياري	القيم والحدود url, b64_json	القيمة الافتراضية—
الحقل`stream`	النوع`boolean`	المتطلباختياري	القيم والحدود	القيمة الافتراضيةfalse
الحقل`size`	النوع`string`	المتطلباختياري	القيم والحدود يعتمد على النموذج	القيمة الافتراضية—
الحقل`quality`	النوع`string`	المتطلباختياري	القيم والحدود يعتمد على النموذج	القيمة الافتراضية—
الحقل`background`	النوع`string`	المتطلباختياري	القيم والحدود يعتمد على النموذج	القيمة الافتراضية—
الحقل`output_format`	النوع`string`	المتطلباختياري	القيم والحدود يعتمد على النموذج	القيمة الافتراضية—
الحقل`output_compression`	النوع`integer`	المتطلباختياري	القيم والحدود يعتمد على النموذج	القيمة الافتراضية—
الحقل`moderation`	النوع`string`	المتطلباختياري	القيم والحدود يعتمد على النموذج	القيمة الافتراضية—
الحقل`input_fidelity`	النوع`string`	المتطلباختياري	القيم والحدود يعتمد على النموذج	القيمة الافتراضية—
الحقل`style`	النوع`string`	المتطلباختياري	القيم والحدود يعتمد على النموذج	القيمة الافتراضية—
الحقل`partial_images`	النوع`integer`	المتطلباختياري	القيم والحدود يعتمد على النموذج	القيمة الافتراضية—

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

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

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

المعلمة	المواصفات
المعلمة`material_types`	المواصفاتtext
المعلمة`required`	المواصفاتmodel, prompt
المعلمة`optional_controls`	المواصفاتnull
المعلمة`content_type`	المواصفاتapplication/json

دورة الحياة: 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}

بُنى الطرق ومعرّفاتها دقيقة؛ قدرة المورد منفصلة عن السماح بالطلب.

الباقات

تعرفات طرائق Ailoot

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

إدخال النص: ⁦‏0.005 US$⁩ / 1K
الإدخال، صورة: ⁦‏0.008 US$⁩ / 1K tokens
الإخراج، صورة: ⁦‏0.03 US$⁩ / 1K tokens

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

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

Ailoot · الصور

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "gpt-image-2.5-flare", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\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\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'gpt-image-2.5-flare', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\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": "gpt-image-2.5-flare", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\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 · الصور

نزّل كل صورة مُرجعة أو احفظ محتواها بصيغة 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.

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

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

إذا تطلبت نتيجة توليد صورة أو تعديلها التحقق، فاحتفظ بقيمة 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

الأخطاء والخطوات التالية

الاستجابة	الشرط	الخطوة التالية
الاستجابة⁦400⁩ · `invalid_request_error`	الشرطحقول مطلوبة أو تمثيل مادة أو قيمة معلمة غير صحيحة	الخطوة التاليةصحّح الحقول المحددة قبل طلب إنشاء جديد.
الاستجابة`server_error`	الشرطتشير الاستجابة المُعادة إلى أن العملية أو النتيجة تتطلب التحقق	الخطوة التاليةاحتفظ بمعرّف العملية أو المهمة الأصلي المُعاد، وبترويسات الطلب وبالاستجابة؛ وواصل عمليات القراءة المدعومة لتلك العملية الأصلية. لا تُعِد إرسال طلب الإنشاء.

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

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

Ailoot gpt-image-2.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare

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

/v1/images

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

openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare

", "method_identity": { "effective_request_model_id": "gpt-image-2.5-flare", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "gpt-image-2.5-flare", "route_label": "Core" }, "method_key": "Core|images|/v1/images/generations|gpt-image-2.5-flare", "ordinal": 0, "rawMethod": { "cache_read": null, "cache_write": null, "cache_write_1h": null, "cache_write_5m": null, "conditional_meter": null, "contract": { "data": { "all_results": "Save every data item. Decode each b64_json or fetch every returned signed URL. Select a filename extension from the actual MIME/bytes.", "errors": [ { "code": null, "condition": "حقول مطلوبة أو تمثيل مادة أو قيمة معلمة غير صحيحة", "http_status": 400, "recovery": "صحّح الحقول المحددة قبل طلب إنشاء جديد.", "type": "invalid_request_error" }, { "code": null, "condition": "تشير الاستجابة المُعادة إلى أن العملية أو النتيجة تتطلب التحقق", "http_status": null, "recovery": "احتفظ بمعرّف العملية أو المهمة الأصلي المُعاد، وبترويسات الطلب وبالاستجابة؛ وواصل عمليات القراءة المدعومة لتلك العملية الأصلية. لا تُعِد إرسال طلب الإنشاء.", "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "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_types": [ "application/json", "multipart/form-data" ], "file_id_supported": false, "mode": "text_to_image", "multipart_part_read_limit_bytes": 20971520, "optional_mask": { "json": "mask.image_url", "multipart": "mask" }, "reference_representations": { "json": "images[].image_url", "multipart": [ "image", "image[]", "image[index]" ] }, "required": [ "prompt" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_image" ], "outputs": { "all_results": "احفظ كل عنصر بيانات. فك ترميز كل b64_json أو اجلب محتوى كل عنوان URL موقّع مُعاد. اختر امتداد اسم الملف بناءً على نوع MIME والبايتات الفعلية.", "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", "default": null, "default_known": false, "enum": [ "gpt-image-2.5-flare" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "enum": null, "enum_known": false, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "url", "b64_json" ], "enum_known": true, "name": "response_format", "required": false, "type": "string" }, { "availability": "source_interface", "default": false, "default_known": true, "enum": null, "enum_known": false, "name": "stream", "required": false, "type": "boolean" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "size", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "quality", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "background", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "output_format", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "output_compression", "required": false, "type": "integer" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "moderation", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_fidelity", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "style", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "partial_images", "required": false, "type": "integer" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [ "images[].file_id", "mask.file_id" ] }, "hints": [ "بُنى الطرق ومعرّفاتها دقيقة؛ قدرة المورد منفصلة عن السماح بالطلب." ], "input": { "content_type": "application/json", "material_types": [ "text" ], "optional_controls": null, "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" }, "operation_modes": [ "images" ], "output": { "family": [ "image" ], "format": null, "multioutputs": "retain every actual response output" } }, "ctx": null, "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: \"${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}\"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{\"model\": \"gpt-image-2.5-flare\", \"prompt\": \"\"}')\nf=Path(os.environ[\"AILOOT_PROMPT_FILE\"])\nif not f.is_file():raise SystemExit(\"Choose your actual UTF-8 brief\")\np['prompt']=f.read_text(encoding=\"utf-8\")\nif not p['prompt'].strip():raise SystemExit(\"Brief must contain text\")\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\"O

OpenAI: GPT Image 2.5 Flare

OpenAI /gpt-image-2.5-flare

معرّف النموذج ID

البداية

يولّد GPT Image 2.5 Flare الصور ويحرّرها من النصوص والمراجع، مع التركيز على الإنشاء البصري اليومي السريع. يدعم الأحجام المخصصة والخلفيات الشفافة والأقنعة ومستويات الجودة حتى max للمسودات والرسوم التوضيحية ومواد الحملات.

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

عن النموذج

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

GPT Image 2.5 Flare هو إصدار OpenAI لتوليد الصور وتحريرها، والمقدَّم للأعمال اليومية السريعة عالية الجودة. يقبل النصوص والصور ويُرجع نتائج صورية. استخدمه للمسودات البصرية والرسوم التوضيحية ومفاهيم المنتجات والمهام الإبداعية المتكررة التي تحتاج إلى تحويل موجز إلى صورة قابلة للاستخدام سريعًا. يختلف Flare عن Sunburst الذي يركز تقديمه على دقة التحرير. اختر Flare لإنشاء الصور المعتاد وSunburst عندما تكون دقة التحرير هي الأولوية.

ابدأ بالموضوع الرئيسي والفعل والبيئة والتكوين والمعالجة البصرية. ولرسم حملة، اطلب راكب دراجة يعبر جسرًا صغيرًا في ضوء مسائي دافئ، بهيئة بارزة وسماء مفتوحة لنص لاحق. يمكن لموجز استكشاف موجز أن يترك القرارات الجمالية مفتوحة؛ أما موجز الإنتاج فينبغي أن يسمّي التفاصيل والمواضع المهمة. تتيح مسارات التوليد والتحرير المباشرة تعليمات حتى 32,000 محرف ومن نتيجة واحدة إلى عشر، مما يفيد في مقارنة بضع نسخ بالغرض نفسه.

يمكن للتحرير استخدام ما يصل إلى ست عشرة صورة مرجعية. حدّد دورًا واضحًا لكل مرجع بدلًا من توقّع أن يقرر النموذج ما إذا كانت الصورة تمثّل هوية الموضوع أو المشهد أو الأسلوب. يمكن لقناع توجيه تغيير في منطقة؛ وينطبق على الصورة الأولى عند تعدد الصور. تحتاج الصورة والقناع إلى صيغة وأبعاد متطابقة، ويجب أن يتضمن القناع قناة ألفا. يشترط الدليل أن يكون المصدر والقناع أقل من 50 MB. القناع توجيه وليس وعدًا بالحفاظ الدقيق على الحدود، لذا حدّد التعديل المطلوب وما ينبغي أن يظل قابلًا للتعرّف معًا.

يدعم Flare جودة low وmedium وhigh وxhigh وmax وتلقائية، مع auto افتراضيًا. يمكن للجودة الأقل خدمة مسودة بصرية سريعة؛ ويمكن مقارنة الإعدادات الأعلى لتفاصيل المادة النهائية. الجودة مستقلة عن الحجم وضغط الإخراج. تشمل الأحجام القياسية 1024 × 1024 و1536 × 1024 و1024 × 1536، وتتاح أيضًا أبعاد تلقائية أو مخصصة. اختر الاتجاه وفق الموضع النهائي والمساحة المفيدة في المشهد.

يجب أن يكون العرض والارتفاع المخصصان من مضاعفات ستة عشر، وألا يزيد أي ضلع على 3840 بكسل. تتراوح النسبة المسموحة من 1:3 إلى 3:1، ويجب ألا تقل المساحة الإجمالية عن 655,360 وألا تزيد على 8,294,400 بكسل. تنطبق الشروط الأربعة معًا. يصنّف الدليل الدقات الأعلى من 2560 × 1440 بأنها تجريبية. استخدم إطارًا صالحًا يناسب التكوين، وأدرج أي تفاصيل حساسة للاقتصاص في الموجز بدلًا من التعامل مع دقة أكبر باعتبارها تحسينًا تلقائيًا للتخطيط.

صيغة النتيجة PNG افتراضيًا، مع بديلَي JPEG وWebP. يتيح JPEG وWebP ضغطًا من 0 إلى 100. ولخلفية شفافة، اختر PNG أو WebP؛ وتُدعم أيضًا الخلفيات المعتمة والتلقائية. يمكن وضع مادة شفافة في تخطيط لاحق، بينما تضم الصورة المعتمة خلفيتها الخاصة. اختر الصيغة والخلفية والضغط وفق الحاجة الفعلية للتسليم، واحتفظ بالملف المكتمل مع الموجز والإعدادات المختارة.

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

افحص حروف الصورة ومواضع العناصر وتفاصيل الموضوع والتكوين بالحجم المقصود. قد يظل GPT Image يواجه صعوبة في وضع النص بدقة والتخطيطات المنظّمة وتكرار الهوية البصرية بين عمليات التوليد. احتفظ بنسخة مقبولة مرجعًا تاليًا، وضيّق التعديل اللاحق إلى المشكلة المهمة. يفيد دور Flare في التوليد اليومي ضمن تسلسل واضح يبدأ بالموجز ثم البدائل البصرية والاختيار والتحسين، مع الحكم على المادة النهائية بحسب الغرض الإبداعي الفعلي.

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

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

الإدخال: text
الإخراج: image

الحقل	النوع	المتطلب	القيم والحدود	القيمة الافتراضية
الحقل`model`	النوع`string`	المتطلبمطلوب	القيم والحدود gpt-image-2.5-flare	القيمة الافتراضية—
الحقل`prompt`	النوع`string`	المتطلبمطلوب	القيم والحدود الحد الأقصى للطول: ⁦32,000⁩	القيمة الافتراضية—
الحقل`size`	النوع`string`	المتطلباختياري	القيم والحدود الشروط: استخدم auto أو WIDTHxHEIGHT على أن يكون كلا البعدين قابلاً للقسمة على 16. يجب ألا يتجاوز الضلع الأطول 3,840 بكسل، وألا يتجاوز الحجم الإجمالي 8,300,000 بكسل.	القيمة الافتراضيةauto
الحقل`background`	النوع`string`	المتطلباختياري	القيم والحدود transparent, opaque, auto	القيمة الافتراضيةauto
الحقل`moderation`	النوع`string`	المتطلباختياري	القيم والحدود low, auto الشروط: استخدم auto للإشراف القياسي على المحتوى.	القيمة الافتراضية—
الحقل`n`	النوع`integer`	المتطلباختياري	القيم والحدود الحد الأدنى: ⁦1⁩ الحد الأقصى: ⁦10⁩	القيمة الافتراضية⁦1⁩
الحقل`quality`	النوع`string`	المتطلباختياري	القيم والحدود auto, high, medium, low	القيمة الافتراضيةauto
الحقل`output_compression`	النوع`integer`	المتطلباختياري	القيم والحدود الحد الأدنى: ⁦0⁩ الحد الأقصى: ⁦100⁩ الشروط: ينطبق على مخرجات JPEG وWebP؛ أرسل القيمة الصحيحة العددية الموثّقة.	القيمة الافتراضية⁦100⁩
الحقل`output_format`	النوع`string`	المتطلباختياري	القيم والحدود webp, png, jpeg	القيمة الافتراضيةpng
الحقل`stream`	النوع`boolean`	المتطلباختياري	القيم والحدود false الشروط: يُعيد هذا المسار استجابة JSON واحدة مكتملة.	القيمة الافتراضيةfalse

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

المعلمة	المواصفات
المعلمة`content_type`	المواصفاتapplication/json
المعلمة`required`	المواصفاتprompt, model
المعلمة`material_types`	المواصفاتtext
المعلمة`optional`	المواصفاتsize, background, moderation, n, quality, output_compression, output_format, stream
المعلمة`conditions`	المواصفاتتتطلب الخلفية الشفافة صيغة PNG أو WebP., ينطبق ضغط المخرجات على JPEG أو WebP., تولّد الطريقة المختارة انطلاقاً من النص. عناصر التحكم في التحرير والبث الموصوفة لدى الشركة المصنّعة إمكانيات منفصلة.

دورة الحياة: 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.24576 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة.

تحجز 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={'prompt': 'A cute baby sea otter', 'model': 'gpt-image-2.5-flare', 'size': '1024x1024', 'n': 1, 'background': 'auto', 'moderation': 'auto', 'output_format': 'png'}\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

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

عمليات أخرى لقراءة المحتوى

set -eu\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 gpt-image-2.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare

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

/v1/images

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

openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare

", "method_identity": { "effective_request_model_id": "gpt-image-2.5-flare", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "gpt-image-2.5-flare", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|gpt-image-2.5-flare", "ordinal": 1, "rawMethod": { "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": [ "gpt-image-2.5-flare" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "maxLength": 32000, "maximum_length": 32000, "name": "prompt", "required": true, "type": "string" }, { "conditions": "استخدم auto أو WIDTHxHEIGHT على أن يكون كلا البعدين قابلاً للقسمة على 16. يجب ألا يتجاوز الضلع الأطول 3,840 بكسل، وألا يتجاوز الحجم الإجمالي 8,300,000 بكسل.", "default": "auto", "default_known": true, "description": "Use auto or WIDTHxHEIGHT with both dimensions divisible by 16. The longest side is at most 3,840 pixels and total size at most 8,300,000 pixels.", "name": "size", "required": false, "type": "string" }, { "default": "auto", "default_known": true, "enum": [ "transparent", "opaque", "auto" ], "enum_known": true, "name": "background", "required": false, "type": "string" }, { "conditions": "استخدم auto للإشراف القياسي على المحتوى.", "description": "Use auto for standard content moderation.", "enum": [ "low", "auto" ], "enum_known": true, "name": "moderation", "required": false, "type": "string" }, { "default": 1, "default_known": true, "maximum": 10, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "default": "auto", "default_known": true, "enum": [ "auto", "high", "medium", "low" ], "enum_known": true, "name": "quality", "required": false, "type": "string" }, { "conditions": "ينطبق على مخرجات JPEG وWebP؛ أرسل القيمة الصحيحة العددية الموثّقة.", "default": 100, "default_known": true, "description": "Applies to JPEG and WebP output; send the documented integer value.", "maximum": 100, "minimum": 0, "name": "output_compression", "required": false, "type": "integer" }, { "default": "png", "default_known": true, "enum": [ "webp", "png", "jpeg" ], "enum_known": true, "name": "output_format", "required": false, "type": "string" }, { "conditions": "يُعيد هذا المسار استجابة JSON واحدة مكتملة.", "default": false, "default_known": true, "description": "This route returns one completed JSON response.", "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" } ], "request_schema": { "properties": { "background": { "default": "auto", "enum": [ "transparent", "opaque", "auto" ], "type": "string" }, "model": { "enum": [ "gpt-image-2.5-flare" ], "type": "string" }, "moderation": { "description": "Use auto for standard content moderation.", "enum": [ "low", "auto" ], "type": "string" }, "n": { "default": 1, "maximum": 10, "minimum": 1, "type": "integer" }, "output_compression": { "default": 100, "description": "Applies to JPEG and WebP output; send the documented integer value.", "maximum": 100, "minimum": 0, "type": "integer" }, "output_format": { "default": "png", "enum": [ "webp", "png", "jpeg" ], "type": "string" }, "prompt": { "maxLength": 32000, "type": "string" }, "quality": { "default": "auto", "enum": [ "auto", "high", "medium", "low" ], "type": "string" }, "size": { "default": "auto", "description": "Use auto or WIDTHxHEIGHT with both dimensions divisible by 16. The longest side is at most 3,840 pixels and total size at most 8,300,000 pixels.", "type": "string" }, "stream": { "default": false, "description": "This route returns one completed JSON response.", "enum": [ false ], "type": "boolean" } }, "required": [ "prompt", "model" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "background": "auto", "model": "gpt-image-2.5-flare", "moderation": "auto", "n": 1, "output_format": "png", "prompt": "A cute baby sea otter", "size": "1024x1024" }, "content_type": "application/json" } }, "input": { "conditions": [ "تتطلب الخلفية الشفافة صيغة PNG أو WebP.", "ينطبق ضغط المخرجات على JPEG أو WebP.", "تولّد الطريقة المختارة انطلاقاً من النص. عناصر التحكم في التحرير والبث الموصوفة لدى الشركة المصنّعة إمكانيات منفصلة." ], "content_type": "application/json", "material_types": [ "text" ], "optional": [ "size", "background", "moderation", "n", "quality", "output_compression", "output_format", "stream" ], "required": [ "prompt", "model" ] }, "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.24576", "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.24576", "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={'prompt': 'A cute baby sea otter', 'model': 'gpt-image-2.5-flare', 'size': '1024x1024', 'n': 1, 'background': 'auto', 'moderation': 'auto', 'output_format': 'png'}\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\"O

OpenAI: GPT Image 2.5 Flare

OpenAI /openai/gpt-image-2.5-flare

معرّف النموذج ID

البداية

يولّد GPT Image 2.5 Flare الصور ويحرّرها من النصوص والمراجع، مع التركيز على الإنشاء البصري اليومي السريع. يدعم الأحجام المخصصة والخلفيات الشفافة والأقنعة ومستويات الجودة حتى max للمسودات والرسوم التوضيحية ومواد الحملات.

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

عن النموذج

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

GPT Image 2.5 Flare هو إصدار OpenAI لتوليد الصور وتحريرها، والمقدَّم للأعمال اليومية السريعة عالية الجودة. يقبل النصوص والصور ويُرجع نتائج صورية. استخدمه للمسودات البصرية والرسوم التوضيحية ومفاهيم المنتجات والمهام الإبداعية المتكررة التي تحتاج إلى تحويل موجز إلى صورة قابلة للاستخدام سريعًا. يختلف Flare عن Sunburst الذي يركز تقديمه على دقة التحرير. اختر Flare لإنشاء الصور المعتاد وSunburst عندما تكون دقة التحرير هي الأولوية.

ابدأ بالموضوع الرئيسي والفعل والبيئة والتكوين والمعالجة البصرية. ولرسم حملة، اطلب راكب دراجة يعبر جسرًا صغيرًا في ضوء مسائي دافئ، بهيئة بارزة وسماء مفتوحة لنص لاحق. يمكن لموجز استكشاف موجز أن يترك القرارات الجمالية مفتوحة؛ أما موجز الإنتاج فينبغي أن يسمّي التفاصيل والمواضع المهمة. تتيح مسارات التوليد والتحرير المباشرة تعليمات حتى 32,000 محرف ومن نتيجة واحدة إلى عشر، مما يفيد في مقارنة بضع نسخ بالغرض نفسه.

يمكن للتحرير استخدام ما يصل إلى ست عشرة صورة مرجعية. حدّد دورًا واضحًا لكل مرجع بدلًا من توقّع أن يقرر النموذج ما إذا كانت الصورة تمثّل هوية الموضوع أو المشهد أو الأسلوب. يمكن لقناع توجيه تغيير في منطقة؛ وينطبق على الصورة الأولى عند تعدد الصور. تحتاج الصورة والقناع إلى صيغة وأبعاد متطابقة، ويجب أن يتضمن القناع قناة ألفا. يشترط الدليل أن يكون المصدر والقناع أقل من 50 MB. القناع توجيه وليس وعدًا بالحفاظ الدقيق على الحدود، لذا حدّد التعديل المطلوب وما ينبغي أن يظل قابلًا للتعرّف معًا.

يدعم Flare جودة low وmedium وhigh وxhigh وmax وتلقائية، مع auto افتراضيًا. يمكن للجودة الأقل خدمة مسودة بصرية سريعة؛ ويمكن مقارنة الإعدادات الأعلى لتفاصيل المادة النهائية. الجودة مستقلة عن الحجم وضغط الإخراج. تشمل الأحجام القياسية 1024 × 1024 و1536 × 1024 و1024 × 1536، وتتاح أيضًا أبعاد تلقائية أو مخصصة. اختر الاتجاه وفق الموضع النهائي والمساحة المفيدة في المشهد.

يجب أن يكون العرض والارتفاع المخصصان من مضاعفات ستة عشر، وألا يزيد أي ضلع على 3840 بكسل. تتراوح النسبة المسموحة من 1:3 إلى 3:1، ويجب ألا تقل المساحة الإجمالية عن 655,360 وألا تزيد على 8,294,400 بكسل. تنطبق الشروط الأربعة معًا. يصنّف الدليل الدقات الأعلى من 2560 × 1440 بأنها تجريبية. استخدم إطارًا صالحًا يناسب التكوين، وأدرج أي تفاصيل حساسة للاقتصاص في الموجز بدلًا من التعامل مع دقة أكبر باعتبارها تحسينًا تلقائيًا للتخطيط.

صيغة النتيجة PNG افتراضيًا، مع بديلَي JPEG وWebP. يتيح JPEG وWebP ضغطًا من 0 إلى 100. ولخلفية شفافة، اختر PNG أو WebP؛ وتُدعم أيضًا الخلفيات المعتمة والتلقائية. يمكن وضع مادة شفافة في تخطيط لاحق، بينما تضم الصورة المعتمة خلفيتها الخاصة. اختر الصيغة والخلفية والضغط وفق الحاجة الفعلية للتسليم، واحتفظ بالملف المكتمل مع الموجز والإعدادات المختارة.

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

افحص حروف الصورة ومواضع العناصر وتفاصيل الموضوع والتكوين بالحجم المقصود. قد يظل GPT Image يواجه صعوبة في وضع النص بدقة والتخطيطات المنظّمة وتكرار الهوية البصرية بين عمليات التوليد. احتفظ بنسخة مقبولة مرجعًا تاليًا، وضيّق التعديل اللاحق إلى المشكلة المهمة. يفيد دور Flare في التوليد اليومي ضمن تسلسل واضح يبدأ بالموجز ثم البدائل البصرية والاختيار والتحسين، مع الحكم على المادة النهائية بحسب الغرض الإبداعي الفعلي.

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

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

الإدخال: text, image
الإخراج: image

الحقل	النوع	المتطلب	القيم والحدود	القيمة الافتراضية
الحقل`model`	النوع`string`	المتطلبمطلوب	القيم والحدود openai/gpt-image-2.5-flare	القيمة الافتراضية—
الحقل`prompt`	النوع`string`	المتطلبمطلوب	القيم والحدود الحد الأدنى للطول: ⁦1⁩	القيمة الافتراضية—
الحقل`aspect_ratio`	النوع`string`	المتطلباختياري	القيم والحدود 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, auto	القيمة الافتراضية—
الحقل`quality`	النوع`string`	المتطلباختياري	القيم والحدود auto, low, medium, high, xhigh, max	القيمة الافتراضية—
الحقل`background`	النوع`string`	المتطلباختياري	القيم والحدود auto, transparent, opaque	القيمة الافتراضية—
الحقل`n`	النوع`integer`	المتطلباختياري	القيم والحدود الحد الأدنى: ⁦1⁩ الحد الأقصى: ⁦10⁩	القيمة الافتراضية—
الحقل`input_references`	النوع`array`	المتطلباختياري	القيم والحدود الحد الأدنى للعناصر: ⁦0⁩ الحد الأقصى للعناصر: ⁦16⁩	القيمة الافتراضية—
الحقل`output_compression`	النوع`integer`	المتطلباختياري	القيم والحدود الحد الأدنى: ⁦0⁩ الحد الأقصى: ⁦100⁩	القيمة الافتراضية—
الحقل`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.24576 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة.

تحجز 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': 'openai/gpt-image-2.5-flare', '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

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

عمليات أخرى لقراءة المحتوى

set -eu\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 gpt-image-2.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare

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

/v1/images

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

openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare

", "method_identity": { "effective_request_model_id": "openai/gpt-image-2.5-flare", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "openai/gpt-image-2.5-flare", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|openai%2Fgpt-image-2.5-flare", "ordinal": 2, "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": [ "openai/gpt-image-2.5-flare" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "enum": [ "1:1", "3:2", "2:3", "4:3", "3:4", "16:9", "9:16", "21:9", "auto" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "enum": [ "auto", "low", "medium", "high", "xhigh", "max" ], "enum_known": true, "name": "quality", "required": false, "type": "string" }, { "enum": [ "auto", "transparent", "opaque" ], "enum_known": true, "name": "background", "required": false, "type": "string" }, { "maximum": 10, "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": 16, "minimum_items": 0, "name": "input_references", "required": false, "type": "array" }, { "maximum": 100, "minimum": 0, "name": "output_compression", "required": false, "type": "integer" }, { "name": "provider", "required": false, "type": "object" } ], "request_schema": { "properties": { "aspect_ratio": { "enum": [ "1:1", "3:2", "2:3", "4:3", "3:4", "16:9", "9:16", "21:9", "auto" ], "type": "string" }, "background": { "enum": [ "auto", "transparent", "opaque" ], "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": 16, "minItems": 0, "type": "array" }, "model": { "enum": [ "openai/gpt-image-2.5-flare" ], "type": "string" }, "n": { "maximum": 10, "minimum": 1, "type": "integer" }, "output_compression": { "maximum": 100, "minimum": 0, "type": "integer" }, "prompt": { "minLength": 1, "type": "string" }, "provider": { "description": "Exact image provider preferences from the documented image request schema.", "type": "object" }, "quality": { "enum": [ "auto", "low", "medium", "high", "xhigh", "max" ], "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "model": "openai/gpt-image-2.5-flare", "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.24576", "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.24576", "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': 'openai/gpt-image-2.5-flare', '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\"