GPT Image 2 هو نموذج OpenAI لتوليد الصور وتحريرها من النصوص والمدخلات البصرية. ينشئ صورة جديدة من موجز مكتوب، ويمكنه استخدام صور مصدرية للتعديلات أو للأعمال التي تقودها المراجع. تشمل المهام العملية الرسوم التوضيحية ومفاهيم المنتجات والتكوينات البصرية والتغييرات في مادة موجودة. وهو إصدار منفصل عن نموذجَي GPT Image 2.5 Sunburst وFlare، بنطاق جودة وسلوك أمانة مدخلات خاصَّين به.
للتوليد، صِف الموضوع والمشهد والتكوين والضوء والأسلوب المقصود. ولتعديل، سمِّ ما ينبغي تغييره وما ينبغي أن يحتفظ بمظهره. يمكن لموجز منتج أن يطلب مصباحًا خزفيًا على سطح فاتح بهيئة مركزية ومساحة لعبارة توضيحية؛ ويمكن لتعديل لاحق أن يغير الخلفية مع الاحتفاظ بشكل المصباح وزاوية رؤيته. تقبل مسارات التوليد والتحرير المباشرة الموثّقة تعليمات حتى 32,000 محرف، ويمكنها إرجاع من صورة واحدة إلى عشر صور.
يقبل التحرير المرجعي ما يصل إلى ست عشرة صورة إدخال. حدّد غرض كل مرجع كي لا يختلط الموضوع بالخلفية والمعالجة البصرية. يعالج GPT Image 2 كل صورة إدخال بأمانة عالية تلقائيًا؛ وينبغي حذف input_fidelity لأنه غير قابل للضبط في هذا الإصدار. ويختلف ذلك عن الاختيار بين high وlow في GPT Image 1، ونمط أمانة المدخلات low فقط في GPT Image 1 Mini. تدعم معالجة المدخلات بأمانة عالية تفاصيل المصدر دون ضمان إعادة إنتاج كل تفصيل دون تغيير.
يمكن لقناع تحديد المنطقة المطلوب تحريرها. يجب أن تكون صورة المصدر والقناع من الصيغة والأبعاد نفسيهما وأقل من 50 MB وفق متطلبات الإعداد في الدليل؛ ويحتاج القناع أيضًا إلى قناة ألفا. وإذا قُدمت عدة صور إدخال، ينطبق القناع على الأولى. يتعامل النموذج مع القناع بوصفه توجيهًا قائمًا على التعليمات وليس حدًا هندسيًا صارمًا. صِف التغيير المحلي ومتطلبات الحفاظ، ثم افحص المنطقة المحيطة بحثًا عن فروق غير مقصودة.
يدعم GPT Image 2 جودة low وmedium وhigh وauto، مع auto افتراضيًا. ولا تدخل إعدادات xhigh وmax لعائلة 2.5 ضمن نطاق جودة هذا الإصدار. يمكن أن يكون الحجم مربعًا أو أفقيًا أو عموديًا أو تلقائيًا أو عرضًا وارتفاعًا مخصصين صالحين. تشمل أمثلة المنتج 1024 × 1024 و1536 × 1024 و1024 × 1536 و2048 × 2048 و2048 × 1152 و3840 × 2160 و2160 × 3840 بكسل. اختر الاتجاه ومستوى التفاصيل للتخطيط الفعلي بدلًا من التعامل مع الجودة والأبعاد بوصفهما عنصر التحكم نفسه.
يجب أن تكون الأبعاد المخصصة من مضاعفات ستة عشر بكسل، مع ضلع أقصى بطول 3840 بكسل، ونسبة الضلع الطويل إلى القصير لا تتجاوز 3:1، ومساحة من 655,360 إلى 8,294,400 بكسل. تسري هذه الشروط في الوقت نفسه. تُصنَّف الدقات الأعلى من 2560 × 1440 بأنها تجريبية. قد يستوفي إطار قاعدة ويفشل في أخرى، لذا اختر زوجًا مدعومًا من الأبعاد وصِف العناصر الحساسة للاقتصاص في الموجز.
الإخراج PNG افتراضيًا، مع إتاحة JPEG أو WebP أيضًا. يُدعم ضغط من 0 إلى 100 لـ JPEG وWebP. يمكن أن تكون الخلفية معتمة أو تلقائية؛ ويصف المرجع الحالي المحدد دعم الشفافية في GPT Image 2 بأنه ميزة في مرحلة المعاينة (preview). وعند طلب الشفافية، استخدم PNG أو WebP كي تُحفظ قناة ألفا. يتيح سير عمل البث الموثّق ما يصل إلى ثلاث صور جزئية قبل الصورة المكتملة؛ احفظ المادة النهائية بدلًا من معاينة التقدم. وتدعم واجهة الشركة المصنّعة أيضًا المعالجة الدفعية.
قيّم وضوح النص ومواضع العناصر والحفاظ على تفاصيل المصدر في النتيجة الفعلية. قد يواجه GPT Image صعوبة في الحروف الدقيقة والتكوينات الحساسة للتخطيط والهوية البصرية المتكررة بين عمليات توليد منفصلة. ولتسلسل من التعديلات، استخدم النتيجة المختارة مصدرًا تاليًا وحدّد تغييرًا ملموسًا مرتبطًا بمشكلة مرئية. الإخراج المفيد لـ GPT Image 2 صورة مرتبطة بموجز توليد أو تحرير واضح، مع اختيار مدخلاتها عالية الأمانة وأبعادها وجودتها بما يناسب تلك المهمة تحديدًا.
", "aboutText": "GPT Image 2 هو نموذج OpenAI لتوليد الصور وتحريرها من النصوص والمدخلات البصرية. ينشئ صورة جديدة من موجز مكتوب، ويمكنه استخدام صور مصدرية للتعديلات أو للأعمال التي تقودها المراجع. تشمل المهام العملية الرسوم التوضيحية ومفاهيم المنتجات والتكوينات البصرية والتغييرات في مادة موجودة. وهو إصدار منفصل عن نموذجَي GPT Image 2.5 Sunburst وFlare، بنطاق جودة وسلوك أمانة مدخلات خاصَّين به.\n\nللتوليد، صِف الموضوع والمشهد والتكوين والضوء والأسلوب المقصود. ولتعديل، سمِّ ما ينبغي تغييره وما ينبغي أن يحتفظ بمظهره. يمكن لموجز منتج أن يطلب مصباحًا خزفيًا على سطح فاتح بهيئة مركزية ومساحة لعبارة توضيحية؛ ويمكن لتعديل لاحق أن يغير الخلفية مع الاحتفاظ بشكل المصباح وزاوية رؤيته. تقبل مسارات التوليد والتحرير المباشرة الموثّقة تعليمات حتى 32,000 محرف، ويمكنها إرجاع من صورة واحدة إلى عشر صور.\n\nيقبل التحرير المرجعي ما يصل إلى ست عشرة صورة إدخال. حدّد غرض كل مرجع كي لا يختلط الموضوع بالخلفية والمعالجة البصرية. يعالج GPT Image 2 كل صورة إدخال بأمانة عالية تلقائيًا؛ وينبغي حذف input_fidelity لأنه غير قابل للضبط في هذا الإصدار. ويختلف ذلك عن الاختيار بين high وlow في GPT Image 1، ونمط أمانة المدخلات low فقط في GPT Image 1 Mini. تدعم معالجة المدخلات بأمانة عالية تفاصيل المصدر دون ضمان إعادة إنتاج كل تفصيل دون تغيير.\n\nيمكن لقناع تحديد المنطقة المطلوب تحريرها. يجب أن تكون صورة المصدر والقناع من الصيغة والأبعاد نفسيهما وأقل من 50 MB وفق متطلبات الإعداد في الدليل؛ ويحتاج القناع أيضًا إلى قناة ألفا. وإذا قُدمت عدة صور إدخال، ينطبق القناع على الأولى. يتعامل النموذج مع القناع بوصفه توجيهًا قائمًا على التعليمات وليس حدًا هندسيًا صارمًا. صِف التغيير المحلي ومتطلبات الحفاظ، ثم افحص المنطقة المحيطة بحثًا عن فروق غير مقصودة.\n\nيدعم GPT Image 2 جودة low وmedium وhigh وauto، مع auto افتراضيًا. ولا تدخل إعدادات xhigh وmax لعائلة 2.5 ضمن نطاق جودة هذا الإصدار. يمكن أن يكون الحجم مربعًا أو أفقيًا أو عموديًا أو تلقائيًا أو عرضًا وارتفاعًا مخصصين صالحين. تشمل أمثلة المنتج 1024 × 1024 و1536 × 1024 و1024 × 1536 و2048 × 2048 و2048 × 1152 و3840 × 2160 و2160 × 3840 بكسل. اختر الاتجاه ومستوى التفاصيل للتخطيط الفعلي بدلًا من التعامل مع الجودة والأبعاد بوصفهما عنصر التحكم نفسه.\n\nيجب أن تكون الأبعاد المخصصة من مضاعفات ستة عشر بكسل، مع ضلع أقصى بطول 3840 بكسل، ونسبة الضلع الطويل إلى القصير لا تتجاوز 3:1، ومساحة من 655,360 إلى 8,294,400 بكسل. تسري هذه الشروط في الوقت نفسه. تُصنَّف الدقات الأعلى من 2560 × 1440 بأنها تجريبية. قد يستوفي إطار قاعدة ويفشل في أخرى، لذا اختر زوجًا مدعومًا من الأبعاد وصِف العناصر الحساسة للاقتصاص في الموجز.\n\nالإخراج PNG افتراضيًا، مع إتاحة JPEG أو WebP أيضًا. يُدعم ضغط من 0 إلى 100 لـ JPEG وWebP. يمكن أن تكون الخلفية معتمة أو تلقائية؛ ويصف المرجع الحالي المحدد دعم الشفافية في GPT Image 2 بأنه ميزة في مرحلة المعاينة (preview). وعند طلب الشفافية، استخدم PNG أو WebP كي تُحفظ قناة ألفا. يتيح سير عمل البث الموثّق ما يصل إلى ثلاث صور جزئية قبل الصورة المكتملة؛ احفظ المادة النهائية بدلًا من معاينة التقدم. وتدعم واجهة الشركة المصنّعة أيضًا المعالجة الدفعية.\n\nقيّم وضوح النص ومواضع العناصر والحفاظ على تفاصيل المصدر في النتيجة الفعلية. قد يواجه GPT Image صعوبة في الحروف الدقيقة والتكوينات الحساسة للتخطيط والهوية البصرية المتكررة بين عمليات توليد منفصلة. ولتسلسل من التعديلات، استخدم النتيجة المختارة مصدرًا تاليًا وحدّد تغييرًا ملموسًا مرتبطًا بمشكلة مرئية. الإخراج المفيد لـ GPT Image 2 صورة مرتبطة بموجز توليد أو تحرير واضح، مع اختيار مدخلاتها عالية الأمانة وأبعادها وجودتها بما يناسب تلك المهمة تحديدًا.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "1bbd19d1f66e776f6f9f3ee485e84dbec949fb9a9d564efffbf7601a80919863", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ar", "methods": [ { "html": "gpt-image-2يولّد GPT Image 2 الصور ويحرّرها من النصوص والمراجع البصرية. يدعم أبعاد إطار مرنة ويعالج مدخلات الصور تلقائيًا بأمانة عالية، مع عناصر تحكم منفصلة في الجودة والصيغة والخلفية للمادة المكتملة.
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
GPT Image 2 هو نموذج OpenAI لتوليد الصور وتحريرها من النصوص والمدخلات البصرية. ينشئ صورة جديدة من موجز مكتوب، ويمكنه استخدام صور مصدرية للتعديلات أو للأعمال التي تقودها المراجع. تشمل المهام العملية الرسوم التوضيحية ومفاهيم المنتجات والتكوينات البصرية والتغييرات في مادة موجودة. وهو إصدار منفصل عن نموذجَي GPT Image 2.5 Sunburst وFlare، بنطاق جودة وسلوك أمانة مدخلات خاصَّين به.
للتوليد، صِف الموضوع والمشهد والتكوين والضوء والأسلوب المقصود. ولتعديل، سمِّ ما ينبغي تغييره وما ينبغي أن يحتفظ بمظهره. يمكن لموجز منتج أن يطلب مصباحًا خزفيًا على سطح فاتح بهيئة مركزية ومساحة لعبارة توضيحية؛ ويمكن لتعديل لاحق أن يغير الخلفية مع الاحتفاظ بشكل المصباح وزاوية رؤيته. تقبل مسارات التوليد والتحرير المباشرة الموثّقة تعليمات حتى 32,000 محرف، ويمكنها إرجاع من صورة واحدة إلى عشر صور.
يقبل التحرير المرجعي ما يصل إلى ست عشرة صورة إدخال. حدّد غرض كل مرجع كي لا يختلط الموضوع بالخلفية والمعالجة البصرية. يعالج GPT Image 2 كل صورة إدخال بأمانة عالية تلقائيًا؛ وينبغي حذف input_fidelity لأنه غير قابل للضبط في هذا الإصدار. ويختلف ذلك عن الاختيار بين high وlow في GPT Image 1، ونمط أمانة المدخلات low فقط في GPT Image 1 Mini. تدعم معالجة المدخلات بأمانة عالية تفاصيل المصدر دون ضمان إعادة إنتاج كل تفصيل دون تغيير.
يمكن لقناع تحديد المنطقة المطلوب تحريرها. يجب أن تكون صورة المصدر والقناع من الصيغة والأبعاد نفسيهما وأقل من 50 MB وفق متطلبات الإعداد في الدليل؛ ويحتاج القناع أيضًا إلى قناة ألفا. وإذا قُدمت عدة صور إدخال، ينطبق القناع على الأولى. يتعامل النموذج مع القناع بوصفه توجيهًا قائمًا على التعليمات وليس حدًا هندسيًا صارمًا. صِف التغيير المحلي ومتطلبات الحفاظ، ثم افحص المنطقة المحيطة بحثًا عن فروق غير مقصودة.
يدعم GPT Image 2 جودة low وmedium وhigh وauto، مع auto افتراضيًا. ولا تدخل إعدادات xhigh وmax لعائلة 2.5 ضمن نطاق جودة هذا الإصدار. يمكن أن يكون الحجم مربعًا أو أفقيًا أو عموديًا أو تلقائيًا أو عرضًا وارتفاعًا مخصصين صالحين. تشمل أمثلة المنتج 1024 × 1024 و1536 × 1024 و1024 × 1536 و2048 × 2048 و2048 × 1152 و3840 × 2160 و2160 × 3840 بكسل. اختر الاتجاه ومستوى التفاصيل للتخطيط الفعلي بدلًا من التعامل مع الجودة والأبعاد بوصفهما عنصر التحكم نفسه.
يجب أن تكون الأبعاد المخصصة من مضاعفات ستة عشر بكسل، مع ضلع أقصى بطول 3840 بكسل، ونسبة الضلع الطويل إلى القصير لا تتجاوز 3:1، ومساحة من 655,360 إلى 8,294,400 بكسل. تسري هذه الشروط في الوقت نفسه. تُصنَّف الدقات الأعلى من 2560 × 1440 بأنها تجريبية. قد يستوفي إطار قاعدة ويفشل في أخرى، لذا اختر زوجًا مدعومًا من الأبعاد وصِف العناصر الحساسة للاقتصاص في الموجز.
الإخراج PNG افتراضيًا، مع إتاحة JPEG أو WebP أيضًا. يُدعم ضغط من 0 إلى 100 لـ JPEG وWebP. يمكن أن تكون الخلفية معتمة أو تلقائية؛ ويصف المرجع الحالي المحدد دعم الشفافية في GPT Image 2 بأنه ميزة في مرحلة المعاينة (preview). وعند طلب الشفافية، استخدم PNG أو WebP كي تُحفظ قناة ألفا. يتيح سير عمل البث الموثّق ما يصل إلى ثلاث صور جزئية قبل الصورة المكتملة؛ احفظ المادة النهائية بدلًا من معاينة التقدم. وتدعم واجهة الشركة المصنّعة أيضًا المعالجة الدفعية.
قيّم وضوح النص ومواضع العناصر والحفاظ على تفاصيل المصدر في النتيجة الفعلية. قد يواجه GPT Image صعوبة في الحروف الدقيقة والتكوينات الحساسة للتخطيط والهوية البصرية المتكررة بين عمليات توليد منفصلة. ولتسلسل من التعديلات، استخدم النتيجة المختارة مصدرًا تاليًا وحدّد تغييرًا ملموسًا مرتبطًا بمشكلة مرئية. الإخراج المفيد لـ GPT Image 2 صورة مرتبطة بموجز توليد أو تحرير واضح، مع اختيار مدخلاتها عالية الأمانة وأبعادها وجودتها بما يناسب تلك المهمة تحديدًا.
POST /v1/images/generationstextimage| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود gpt-image-2 | القيمة الافتراضية— |
الحقل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}
بُنى الطرق ومعرّفاتها دقيقة؛ قدرة المورد منفصلة عن السماح بالطلب.
POST /v1/images/generationsتحجز 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", "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\nfrom 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', '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])\nimport 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", "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نزّل كل صورة مُرجعة أو احفظ محتواها بصيغة Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /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
Ailoot Ultra gpt-image-2, openai/gpt-image-2
/v1/images
gpt-image-2يولّد GPT Image 2 الصور ويحرّرها من النصوص والمراجع البصرية. يدعم أبعاد إطار مرنة ويعالج مدخلات الصور تلقائيًا بأمانة عالية، مع عناصر تحكم منفصلة في الجودة والصيغة والخلفية للمادة المكتملة.
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
GPT Image 2 هو نموذج OpenAI لتوليد الصور وتحريرها من النصوص والمدخلات البصرية. ينشئ صورة جديدة من موجز مكتوب، ويمكنه استخدام صور مصدرية للتعديلات أو للأعمال التي تقودها المراجع. تشمل المهام العملية الرسوم التوضيحية ومفاهيم المنتجات والتكوينات البصرية والتغييرات في مادة موجودة. وهو إصدار منفصل عن نموذجَي GPT Image 2.5 Sunburst وFlare، بنطاق جودة وسلوك أمانة مدخلات خاصَّين به.
للتوليد، صِف الموضوع والمشهد والتكوين والضوء والأسلوب المقصود. ولتعديل، سمِّ ما ينبغي تغييره وما ينبغي أن يحتفظ بمظهره. يمكن لموجز منتج أن يطلب مصباحًا خزفيًا على سطح فاتح بهيئة مركزية ومساحة لعبارة توضيحية؛ ويمكن لتعديل لاحق أن يغير الخلفية مع الاحتفاظ بشكل المصباح وزاوية رؤيته. تقبل مسارات التوليد والتحرير المباشرة الموثّقة تعليمات حتى 32,000 محرف، ويمكنها إرجاع من صورة واحدة إلى عشر صور.
يقبل التحرير المرجعي ما يصل إلى ست عشرة صورة إدخال. حدّد غرض كل مرجع كي لا يختلط الموضوع بالخلفية والمعالجة البصرية. يعالج GPT Image 2 كل صورة إدخال بأمانة عالية تلقائيًا؛ وينبغي حذف input_fidelity لأنه غير قابل للضبط في هذا الإصدار. ويختلف ذلك عن الاختيار بين high وlow في GPT Image 1، ونمط أمانة المدخلات low فقط في GPT Image 1 Mini. تدعم معالجة المدخلات بأمانة عالية تفاصيل المصدر دون ضمان إعادة إنتاج كل تفصيل دون تغيير.
يمكن لقناع تحديد المنطقة المطلوب تحريرها. يجب أن تكون صورة المصدر والقناع من الصيغة والأبعاد نفسيهما وأقل من 50 MB وفق متطلبات الإعداد في الدليل؛ ويحتاج القناع أيضًا إلى قناة ألفا. وإذا قُدمت عدة صور إدخال، ينطبق القناع على الأولى. يتعامل النموذج مع القناع بوصفه توجيهًا قائمًا على التعليمات وليس حدًا هندسيًا صارمًا. صِف التغيير المحلي ومتطلبات الحفاظ، ثم افحص المنطقة المحيطة بحثًا عن فروق غير مقصودة.
يدعم GPT Image 2 جودة low وmedium وhigh وauto، مع auto افتراضيًا. ولا تدخل إعدادات xhigh وmax لعائلة 2.5 ضمن نطاق جودة هذا الإصدار. يمكن أن يكون الحجم مربعًا أو أفقيًا أو عموديًا أو تلقائيًا أو عرضًا وارتفاعًا مخصصين صالحين. تشمل أمثلة المنتج 1024 × 1024 و1536 × 1024 و1024 × 1536 و2048 × 2048 و2048 × 1152 و3840 × 2160 و2160 × 3840 بكسل. اختر الاتجاه ومستوى التفاصيل للتخطيط الفعلي بدلًا من التعامل مع الجودة والأبعاد بوصفهما عنصر التحكم نفسه.
يجب أن تكون الأبعاد المخصصة من مضاعفات ستة عشر بكسل، مع ضلع أقصى بطول 3840 بكسل، ونسبة الضلع الطويل إلى القصير لا تتجاوز 3:1، ومساحة من 655,360 إلى 8,294,400 بكسل. تسري هذه الشروط في الوقت نفسه. تُصنَّف الدقات الأعلى من 2560 × 1440 بأنها تجريبية. قد يستوفي إطار قاعدة ويفشل في أخرى، لذا اختر زوجًا مدعومًا من الأبعاد وصِف العناصر الحساسة للاقتصاص في الموجز.
الإخراج PNG افتراضيًا، مع إتاحة JPEG أو WebP أيضًا. يُدعم ضغط من 0 إلى 100 لـ JPEG وWebP. يمكن أن تكون الخلفية معتمة أو تلقائية؛ ويصف المرجع الحالي المحدد دعم الشفافية في GPT Image 2 بأنه ميزة في مرحلة المعاينة (preview). وعند طلب الشفافية، استخدم PNG أو WebP كي تُحفظ قناة ألفا. يتيح سير عمل البث الموثّق ما يصل إلى ثلاث صور جزئية قبل الصورة المكتملة؛ احفظ المادة النهائية بدلًا من معاينة التقدم. وتدعم واجهة الشركة المصنّعة أيضًا المعالجة الدفعية.
قيّم وضوح النص ومواضع العناصر والحفاظ على تفاصيل المصدر في النتيجة الفعلية. قد يواجه GPT Image صعوبة في الحروف الدقيقة والتكوينات الحساسة للتخطيط والهوية البصرية المتكررة بين عمليات توليد منفصلة. ولتسلسل من التعديلات، استخدم النتيجة المختارة مصدرًا تاليًا وحدّد تغييرًا ملموسًا مرتبطًا بمشكلة مرئية. الإخراج المفيد لـ GPT Image 2 صورة مرتبطة بموجز توليد أو تحرير واضح، مع اختيار مدخلاتها عالية الأمانة وأبعادها وجودتها بما يناسب تلك المهمة تحديدًا.
POST /v1/images/generationstextimage| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود gpt-image-2 | القيمة الافتراضية— |
الحقل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}
تقدّر التعرفات المعروضة التكلفة قبل التوليد. تُحسب الرسوم النهائية من التكلفة المسجّلة لعملية التوليد الأصلية. مدة المخرجات المقاسة والكميات المتوقعة ليست الكمية النهائية الخاضعة للفوترة.
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | جدول التعرفة | الكمية المتوقعة | الرسوم |
|---|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | الكمية المتوقعة— | الرسوم الإدخال · رموز الإدخال · تقدير للمقارنة فقط — / 1K من الرموز الإخراج · رموز الإخراج · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط — / 1K من الرموز |
| الإعداداتتكلفة التوليد التقديرية | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.24576 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة. |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'prompt': 'A cute baby sea otter', 'model': 'gpt-image-2', '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نزّل كل صورة مُرجعة أو احفظ محتواها بصيغة Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nاحفظ كل صورة مكتملة؛ نزّلها من كل URL مُرجع، أو فك ترميز محتواها بصيغة Base64.
احتفظ بالاستجابة كاملة وبجميع الترويسات، وبكل مخرج فعلي، وبالمعرّفات الأصلية المُعادة، وبجميع حقول الاستخدام. استعد العملية الأصلية دون إرسال طلب الإنشاء مجددًا.
احتفظ بقيمة X-Client-Request-ID المُعادة للمطابقة. اقرأ فقط قيم task_id/asset_id الفعلية المُعادة أو مكتبة الوسائط المملوكة لك؛ ولا تنشئ عنوان URL لمهمة من معرّف العملية، ولا تُعِد إرسال طلب الإنشاء مطلقًا.
| الحقل | النوع |
|---|---|
الحقلcreated | النوع |
الحقلdata[].url | النوع |
الحقلdata[].b64_json | النوع |
الحقلusage | النوع |
Ailoot gpt-image-2
Ailoot Ultra gpt-image-2, openai/gpt-image-2
/v1/images
openai/gpt-image-2يولّد GPT Image 2 الصور ويحرّرها من النصوص والمراجع البصرية. يدعم أبعاد إطار مرنة ويعالج مدخلات الصور تلقائيًا بأمانة عالية، مع عناصر تحكم منفصلة في الجودة والصيغة والخلفية للمادة المكتملة.
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
GPT Image 2 هو نموذج OpenAI لتوليد الصور وتحريرها من النصوص والمدخلات البصرية. ينشئ صورة جديدة من موجز مكتوب، ويمكنه استخدام صور مصدرية للتعديلات أو للأعمال التي تقودها المراجع. تشمل المهام العملية الرسوم التوضيحية ومفاهيم المنتجات والتكوينات البصرية والتغييرات في مادة موجودة. وهو إصدار منفصل عن نموذجَي GPT Image 2.5 Sunburst وFlare، بنطاق جودة وسلوك أمانة مدخلات خاصَّين به.
للتوليد، صِف الموضوع والمشهد والتكوين والضوء والأسلوب المقصود. ولتعديل، سمِّ ما ينبغي تغييره وما ينبغي أن يحتفظ بمظهره. يمكن لموجز منتج أن يطلب مصباحًا خزفيًا على سطح فاتح بهيئة مركزية ومساحة لعبارة توضيحية؛ ويمكن لتعديل لاحق أن يغير الخلفية مع الاحتفاظ بشكل المصباح وزاوية رؤيته. تقبل مسارات التوليد والتحرير المباشرة الموثّقة تعليمات حتى 32,000 محرف، ويمكنها إرجاع من صورة واحدة إلى عشر صور.
يقبل التحرير المرجعي ما يصل إلى ست عشرة صورة إدخال. حدّد غرض كل مرجع كي لا يختلط الموضوع بالخلفية والمعالجة البصرية. يعالج GPT Image 2 كل صورة إدخال بأمانة عالية تلقائيًا؛ وينبغي حذف input_fidelity لأنه غير قابل للضبط في هذا الإصدار. ويختلف ذلك عن الاختيار بين high وlow في GPT Image 1، ونمط أمانة المدخلات low فقط في GPT Image 1 Mini. تدعم معالجة المدخلات بأمانة عالية تفاصيل المصدر دون ضمان إعادة إنتاج كل تفصيل دون تغيير.
يمكن لقناع تحديد المنطقة المطلوب تحريرها. يجب أن تكون صورة المصدر والقناع من الصيغة والأبعاد نفسيهما وأقل من 50 MB وفق متطلبات الإعداد في الدليل؛ ويحتاج القناع أيضًا إلى قناة ألفا. وإذا قُدمت عدة صور إدخال، ينطبق القناع على الأولى. يتعامل النموذج مع القناع بوصفه توجيهًا قائمًا على التعليمات وليس حدًا هندسيًا صارمًا. صِف التغيير المحلي ومتطلبات الحفاظ، ثم افحص المنطقة المحيطة بحثًا عن فروق غير مقصودة.
يدعم GPT Image 2 جودة low وmedium وhigh وauto، مع auto افتراضيًا. ولا تدخل إعدادات xhigh وmax لعائلة 2.5 ضمن نطاق جودة هذا الإصدار. يمكن أن يكون الحجم مربعًا أو أفقيًا أو عموديًا أو تلقائيًا أو عرضًا وارتفاعًا مخصصين صالحين. تشمل أمثلة المنتج 1024 × 1024 و1536 × 1024 و1024 × 1536 و2048 × 2048 و2048 × 1152 و3840 × 2160 و2160 × 3840 بكسل. اختر الاتجاه ومستوى التفاصيل للتخطيط الفعلي بدلًا من التعامل مع الجودة والأبعاد بوصفهما عنصر التحكم نفسه.
يجب أن تكون الأبعاد المخصصة من مضاعفات ستة عشر بكسل، مع ضلع أقصى بطول 3840 بكسل، ونسبة الضلع الطويل إلى القصير لا تتجاوز 3:1، ومساحة من 655,360 إلى 8,294,400 بكسل. تسري هذه الشروط في الوقت نفسه. تُصنَّف الدقات الأعلى من 2560 × 1440 بأنها تجريبية. قد يستوفي إطار قاعدة ويفشل في أخرى، لذا اختر زوجًا مدعومًا من الأبعاد وصِف العناصر الحساسة للاقتصاص في الموجز.
الإخراج PNG افتراضيًا، مع إتاحة JPEG أو WebP أيضًا. يُدعم ضغط من 0 إلى 100 لـ JPEG وWebP. يمكن أن تكون الخلفية معتمة أو تلقائية؛ ويصف المرجع الحالي المحدد دعم الشفافية في GPT Image 2 بأنه ميزة في مرحلة المعاينة (preview). وعند طلب الشفافية، استخدم PNG أو WebP كي تُحفظ قناة ألفا. يتيح سير عمل البث الموثّق ما يصل إلى ثلاث صور جزئية قبل الصورة المكتملة؛ احفظ المادة النهائية بدلًا من معاينة التقدم. وتدعم واجهة الشركة المصنّعة أيضًا المعالجة الدفعية.
قيّم وضوح النص ومواضع العناصر والحفاظ على تفاصيل المصدر في النتيجة الفعلية. قد يواجه GPT Image صعوبة في الحروف الدقيقة والتكوينات الحساسة للتخطيط والهوية البصرية المتكررة بين عمليات توليد منفصلة. ولتسلسل من التعديلات، استخدم النتيجة المختارة مصدرًا تاليًا وحدّد تغييرًا ملموسًا مرتبطًا بمشكلة مرئية. الإخراج المفيد لـ GPT Image 2 صورة مرتبطة بموجز توليد أو تحرير واضح، مع اختيار مدخلاتها عالية الأمانة وأبعادها وجودتها بما يناسب تلك المهمة تحديدًا.
POST /v1/images/generationstext, imageimage| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود openai/gpt-image-2 | القيمة الافتراضية— |
الحقل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 | القيمة الافتراضية— |
الحقلbackground | النوعstring | المتطلباختياري | القيم والحدود auto, 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}
تقدّر التعرفات المعروضة التكلفة قبل التوليد. تُحسب الرسوم النهائية من التكلفة المسجّلة لعملية التوليد الأصلية. مدة المخرجات المقاسة والكميات المتوقعة ليست الكمية النهائية الخاضعة للفوترة.
مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | جدول التعرفة | الكمية المتوقعة | الرسوم |
|---|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | الكمية المتوقعة— | الرسوم الإدخال · رموز الإدخال · تقدير للمقارنة فقط — / 1K من الرموز الإخراج · رموز الإخراج · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط — / 1K من الرموز |
| الإعداداتتكلفة التوليد التقديرية | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.24576 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة. |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'openai/gpt-image-2', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nنزّل كل صورة مُرجعة أو احفظ محتواها بصيغة Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nاحفظ كل صورة مكتملة؛ نزّلها من كل URL مُرجع، أو فك ترميز محتواها بصيغة Base64.
احتفظ بالاستجابة كاملة وبجميع الترويسات، وبكل مخرج فعلي، وبالمعرّفات الأصلية المُعادة، وبجميع حقول الاستخدام. استعد العملية الأصلية دون إرسال طلب الإنشاء مجددًا.
احتفظ بقيمة X-Client-Request-ID المُعادة للمطابقة. اقرأ فقط قيم task_id/asset_id الفعلية المُعادة أو مكتبة الوسائط المملوكة لك؛ ولا تنشئ عنوان URL لمهمة من معرّف العملية، ولا تُعِد إرسال طلب الإنشاء مطلقًا.
| الحقل | النوع |
|---|---|
الحقلcreated | النوع |
الحقلdata[].url | النوع |
الحقلdata[].b64_json | النوع |
الحقلusage | النوع |
Ailoot gpt-image-2
Ailoot Ultra gpt-image-2, openai/gpt-image-2
/v1/images