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

1. الحصول على مفتاح API

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

2. إرسال أول طلب

توجد الصورة في الاستجابة الناجحة ضمن data[].url۔ فيما يلي نتيجة 1024×1536 تم الحصول عليها عبر طلب فعلي من Ace Data Cloud في 8 سبتمبر 2026 (المهمة d56455e2-e7f7-4bcd-b935-475b0a1e0948، والتتبع eb938601-8192-407f-b539-1e0554b697ec): كوب أبيض تم إنشاؤه بواسطة GPT Image 2

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

الأحجام الشائعة: يختار size: "auto" أبعاد الصورة وفقاً للنسبة والبكسلات وقصد التخطيط في نص التوجيه؛ املأ الحجم مباشرة عند الحاجة إلى بكسلات دقيقة.

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

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

4. التوليد المتعدد

تُفوّت 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 الفعلي في الاستجابة. أسعار الصفحة هي تقديرات قبل الطلب، وتخضع القيمة النهائية لسجل الاستخدام.

5. الاستدعاء غير المتزامن

بعد إضافة callback_url إلى نص الطلب، ستعيد الواجهة أولاً {"task_id": "..."}، ثم سترسل النتيجة النهائية عبر POST إلى عنوان URL هذا عند الاكتمال؛ بينما تعيد الطلبات المتزامنة created وdata:
ينبغي على مستلِم الاستدعاء استخدام task_id لإزالة التكرار، والتحقق من مصدر الطلب وتنسيق البيانات.

6. استكشاف الأخطاء وإصلاحها

ستتضمن استجابة الخطأ error.code وerror.message وtrace_id۔ عند الإبلاغ عن مشكلة، قدّم trace_id، ولا تقدّم مفتاح API. للاطلاع على الحقول الكاملة والتعدادات الفورية، راجع صفحة OpenAI Images Generations API. ولتحرير الصور، راجع تحرير صور GPT Image 2 / 2.5.