1. الحصول على API Key
افتح قائمة تطبيقات Ace Data Cloud، وادخل إلى التطبيق المتاح وانسخ API Key.
2. التحرير باستخدام رابط الصورة URL
الصورة الأصلية:
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. رد الاتصال غير المتزامن واستكشاف الأخطاء وإصلاحها
يمكن للمهام الطويلة إضافة ما يلي في الطلب:{"task_id": "..."}؛ وبعد الإكمال يتم رد الاتصال بالنتيجة النهائية. أما الطلبات المتزامنة فتُرجع created وdata.
ستتضمن استجابة الخطأ
trace_id. عند الإبلاغ عن مشكلة، قدم هذا المعرّف، ولا تقدم مفتاح API.
للحصول على الحقول الكاملة والتعدادات الفورية، يُرجى الرجوع إلى صفحة OpenAI Images Edits API. لإنشاء الصور من النص فقط، يُرجى الاطلاع على توليد صور GPT Image 2 / 2.5.
