نظرة عامة
يبقى هذا endpoint لعملاء variation القدامى المتوافقين مع OpenAI. ليس المسار الموصى به لتدفقات image-to-image الحالية؛ استخدم/v1/images/edits مع gpt-image-2 أو /v1/images/generations مع نموذج image-to-image مثل nano-banana-pro عندما يكون ذلك ممكنًا. يتطلب multipart/form-data.
جسم الطلب
مهلة الطلبات المتزامنة: قد يعيد بعض مزودي الصور الذين يتم التوجيه إليهم الصورة النهائية inline وينتظرون اكتمال التوليد. قد تستغرق طلبات الدقة العالية أو الجودة العالية ما يقارب دقيقة أو أكثر، لذا اضبط مهلة عميل HTTP على120s على الأقل. إذا احتوت استجابة الإنشاء على status: "pending" أو task_id أو poll_url، فاتبع poll_url المُعاد بدلًا من الانتظار.
الصورة المستخدمة كأساس للتنويع. يجب أن تكون ملف PNG صالح، أقل من 50MB، ومربعة.
معرّف نموذج مطلوب للمسارات القديمة المتوافقة مع variation. لا توجد قيمة افتراضية ضمنية؛ لتدفقات image-to-image الحالية، فضّل
/v1/images/edits أو /v1/images/generations مع نموذج حالي.عدد الصور المراد إنشاؤها. يجب أن يكون بين 1 و 10.
حجم الصور المُنشأة للمسارات القديمة المتوافقة مع variation. تعتمد القيم المدعومة على النموذج المحدد.
تنسيق إرجاع الصور المُنشأة. يجب أن يكون
url أو b64_json.معرف فريد يمثل المستخدم النهائي لمراقبة سوء الاستخدام.
الاستجابة
الطابع الزمني Unix لوقت إنشاء الصور.
مصفوفة تنويعات الصور المُنشأة.كل عنصر يحتوي على:
url(string): رابط صورة التنويع (إذا كان response_format هوurl)b64_json(string): الصورة بترميز Base64 (إذا كان response_format هوb64_json)
ملاحظات
هذا endpoint توافق قديم. لا يظهر في كتالوج نماذج الصور الموصى بها حاليًا. للتكاملات الجديدة استخدم
/v1/images/edits مع gpt-image-2، أو /v1/images/generations مع operation: "image-to-image" ونموذج image-to-image حالي.