الانتقال إلى المحتوى الرئيسي

1. الحصول على API Key

افتح قائمة تطبيقات Ace Data Cloud، وادخل إلى التطبيق المتاح وانسخ API Key. الحصول على Ace Data Cloud API Key

2. التحرير باستخدام رابط الصورة URL

الصورة الأصلية: الصورة الأصلية لتحرير GPT Image 2
استجابة ناجحة:
هذه هي نتيجة التحرير التي تم إكمالها فعليًا عبر Ace Data Cloud في 8 سبتمبر 2026، حيث أصبح الكوب برتقاليًا، وأصبحت الخلفية زرقاء كحلية داكنة، مع الحفاظ على التكوين الأصلي وأبعاد 1024×1536: نتيجة تحرير كوب برتقالي في GPT Image 2

3. رفع صورة محلية

استخدم multipart/form-data:
يمكن تمرير image بشكل متكرر، وتدعم سلسلة GPT Image حتى 16 صورة مرجعية. يمكن أن تكون image في طلب JSON رابط URL واحدًا أو مصفوفة من روابط URL؛ وتُرفع الملفات المحلية باستخدام multipart.

النماذج وطريقة الفوترة

سعر صفحة قناة API الرسمية هو تقدير قبل الطلب، ويعتمد السعر النهائي على استخدام Token الفعلي وسجل الاستخدام في الاستجابة.

4. استخدام القناع للتحرير الموضعي

تحدد واجهة Images Edit الرسمية المنطقة المسموح بتعديلها عبر mask. وتتبع نماذج :official في Ace Data Cloud نفس عقد multipart:
  • يجب أن يكون mask ملف PNG مع قناة Alpha، وألا يتجاوز حجمه 4MB؛
  • يجب أن تتطابق أبعاد القناع تمامًا مع أول image؛
  • تشير البكسلات الشفافة ذات Alpha بقيمة 0 إلى السماح بالتحرير، بينما تشير البكسلات غير الشفافة إلى وجوب الاحتفاظ بها؛
  • لا يمكن استخدام صور RGB التي تكون ألوانها بالأبيض والأسود فقط، ولكنها لا تحتوي على قناة شفافية، كقناع صالح؛
  • يجب أن يصف النص التوجيهي الصورة الكاملة المتوقعة، مع توضيح التعديل الموضعي والمحتوى الذي يجب أن يبقى دون تغيير.
فيما يلي، يتم أولًا إنشاء قناع من الصورة الأصلية. يضبط المثال المستطيل المركزي ليكون شفافًا، بحيث يُسمح للنموذج بتعديل تلك المنطقة فقط:
ثم ارفع الصورة الأصلية والقناع معًا:
يمكن أيضًا الاستمرار باستخدام طريقة استدعاء images.edit الخاصة بـ Python SDK الرسمي من OpenAI، ما عليك سوى توجيه base_url إلى Ace Data Cloud:
عند استخدام mask، يجب رفع الصورة الأصلية والقناع في طلب multipart نفسه بشكل منفصل عبر image=@input.png وmask=@mask.png. لا تخلط بين الصورة الأصلية عبر URL وملف القناع المحلي عند الإرسال؛ إذ لا تدعم طلبات التحرير التي تعتمد على URL فقط إرفاق ملف mask محلي إضافي. سيقيّد القناع منطقة التحرير، لكن نموذج التوليد قد يظل يجري دمجًا طبيعيًا عند الحواف؛ وعند الحاجة إلى حدود صارمة، يجب استخدام حواف Alpha واضحة وتكرار توضيح المحتوى الذي يجب أن يبقى دون تغيير في النص التوجيهي. تتوافق طريقة الاستدعاء أعلاه مع مثال القناع في OpenAI Image Edit API وGPT Image Cookbook الرسمي.

5. المعلمات الشائعة

تتوافق قواعد الأبعاد مع واجهة التوليد: يجب أن يكون العرض والارتفاع من مضاعفات 16، وألا يتجاوز الضلع الأطول 3840، وأن يكون إجمالي البكسلات بين 655,360–8,294,400، وألا تتجاوز نسبة العرض إلى الارتفاع 3:1. عند حذف size أو استخدام auto، سيختار النموذج أبعاد اللوحة بالاستناد إلى نص المطالبة وأول صورة مرجعية. يتم احتساب gpt-image-2 وgpt-image-2.5-flare وgpt-image-2.5-sunburst وgpt-image-2:reverse حسب عدد الصور الناجحة؛ بينما تتم تسوية gpt-image-2:official وgpt-image-2.5-flare:official وgpt-image-2.5-sunburst:official وفقًا لرموز Token الفعلية لإدخال النصوص وإدخال الصور المرجعية وإخراج الصور، ويُعتد بسجل الاستخدام النهائي.

6. رد الاتصال غير المتزامن واستكشاف الأخطاء وإصلاحها

يمكن للمهام الطويلة إضافة ما يلي في الطلب:
تكون استجابة 200 غير المتزامنة هي {"task_id": "..."}؛ وبعد الإكمال يتم رد الاتصال بالنتيجة النهائية. أما الطلبات المتزامنة فتُرجع created وdata. ستتضمن استجابة الخطأ trace_id. عند الإبلاغ عن مشكلة، قدم هذا المعرّف، ولا تقدم مفتاح API. للحصول على الحقول الكاملة والتعدادات الفورية، يُرجى الرجوع إلى صفحة OpenAI Images Edits API. لإنشاء الصور من النص فقط، يُرجى الاطلاع على توليد صور GPT Image 2 / 2.5.