معاملات GPT Image 2 API: المقاس والدقة ونسبة العرض إلى الارتفاع والجودة
معاملات GPT Image 2 API التي تحدد شكل الصورة: اسم النموذج، والمقاس والدقة، ونسب الأبعاد، وحدود 4K، والجودة، والصيغ، والأخطاء التي تعيدها.
اقرأ بصيغة Markdownتأخذ GPT Image 2 API اسم النموذج في model، وأبعاد المخرجات في size بصيغة WIDTHxHEIGHT بالبكسل، والجودة في quality (low أو medium أو high أو auto). لا يوجد حقل resolution ولا aspect_ratio. وللحصول على صورة 16:9 بدقة 4K ترسل "size": "3840x2160". يجب أن تكون المقاسات من مضاعفات 16، وألا يتجاوز أي ضلع 3840 بكسل، وأن تبقى النسبة بين 1:3 و3:1، وأن يقع العدد الكلي للبكسلات بين 655,360 و8,294,400.
يغطي هذا الدليل كل معامل يغيّر الصورة، مع القيمة الدقيقة التي ترسلها والخطأ الذي تعيده القيمة الخاطئة. وقد جرى التحقق من كل خطأ أدناه على الـ API الحية.
ما اسم نموذج GPT Image 2 في الـ API؟
استخدم gpt-image-2 أو gpt-image-2-official. كلاهما النموذج نفسه بالحقول نفسها؛ يحتسب gpt-image-2 سعرًا ثابتًا واحدًا لكل صورة تُسلَّم، ويحتسب gpt-image-2-official التوكنات التي تبلّغ عنها كل عملية توليد.
الأسماء المأخوذة من العناوين لا تعمل معرّفاتٍ للنموذج. فكل من gpt-image-2.0 وGPT Image 2 وchatgpt-images-2 يعيد HTTP 400 مع رمز الخطأ 20002.
كيف تضبط الدقة ونسبة العرض إلى الارتفاع؟
عبر size، بالبكسل. اختر نسبة الأبعاد وعدد البكسلات الذي تريده، ثم أرسل العرض والارتفاع الناتجين:
| نسبة الأبعاد | نحو 1K | نحو 2K | 4K |
|---|---|---|---|
| 1:1 | 1024x1024 | 2048x2048 | 2880x2880 |
| 3:2 | 1248x832 | 2496x1664 | 3504x2336 |
| 2:3 | 832x1248 | 1664x2496 | 2336x3504 |
| 4:3 | 1152x864 | 2304x1728 | 3264x2448 |
| 3:4 | 864x1152 | 1728x2304 | 2448x3264 |
| 16:9 | 1280x720 | 2560x1440 | 3840x2160 |
| 9:16 | 720x1280 | 1440x2560 | 2160x3840 |
| 21:9 | 1456x624 | 3024x1296 | 3808x1632 |
| 3:1 | 1728x576 | 3504x1168 | 3840x1280 |
هذه هي التحويلات نفسها التي يستخدمها Playground عندما تختار نسبة وإعدادًا مسبقًا 1K أو 2K أو 4K. ويتوقف المربع بدقة 4K عند 2880x2880 لأن مربعًا بضلع 3840 بكسل سيتجاوز حد العدد الكلي للبكسلات.
تترك size: "auto" الأبعاد للنموذج. وهي القيمة الافتراضية، ومريحة، لكن اضبط مقاسًا صريحًا حين يجب أن تطابق المخرجات تخطيطًا ما أو يطابق بعضها بعضًا.
تصف OpenAI المخرجات الأكبر من 2560×1440 بأنها تجريبية. وهي مقبولة ضمن الحدود المذكورة هنا، لكن اللوحة الأكبر لا تعني وعدًا بتفاصيل أكثر.
ما قيم المقاس التي تُرفض؟
| القيمة المرسلة | سبب الفشل | الاستجابة |
|---|---|---|
"size": "16:9" | النسب ليست مقاسات | 400 20001، والرسالة تسمّي size |
"size": "4096x2304" | ضلع أكبر من 3840 | 400 20001، والرسالة تسمّي size |
"size": "1000x1000" | ليس من مضاعفات 16 | 400 20001، والرسالة تسمّي size |
"size": "3840x1024" | أعرض من 3:1 | 400 20001، والرسالة تسمّي size |
"resolution": "4k" | حقل غير معروف | 400 20001، دون تسمية حقل |
"aspect_ratio": "16:9" | حقل غير معروف | 400 20001، دون تسمية حقل |
انتبه إلى الصفين الأخيرين. يُرفض الحقل غير المعروف، لكن الخطأ لا يسمّيه. فإذا تلقيت 20001 مع الرسالة العامة “Check the parameters against the API documentation”، فابحث عن حقل لا تقبله الـ API، مثل resolution أو aspect_ratio أو response_format.
أي جودة تختار؟
يقبل quality القيم low وmedium وhigh وauto. المستويات الأعلى تستغرق وقتًا أطول وتحتفظ بتفاصيل أدق. أما xhigh وmax فتخصّان GPT Image 2.5 وحده؛ وإرسالهما إلى GPT Image 2 يعيد 20001 مع رسالة تسمّي quality.
روتين عملي: اصنع المسودات بـ low ما دام التكوين يتغيّر، وافحص الملمس والنص الصغير بـ medium، وأنتج النسخ النهائية بـ high. على gpt-image-2 يبقى السعر نفسه في كل مستوى. وعلى gpt-image-2-official تبلّغ المستويات الأعلى عن توكنات مخرجات أكثر، فتكلّف أكثر. ويعرض دليل الأسعار الأرقام.
تترك auto للنموذج اختيار المستوى. اضبط قيمة صريحة حين تقارن بين عمليات التشغيل، وإلا فقد يُولَّد طلبان "متطابقان" بمستويين مختلفين.
ما الذي يتحكم في الصيغة والخلفية؟
output_format:png(افتراضي) أوjpeg. لا تتوفر مخرجات WebP؛ ويعيدwebpالرمز20001مع رسالة تسمّيoutput_format.output_compression: من 0 إلى 100، معjpegفقط.background:autoأوopaqueأوtransparent. تتطلب الشفافيةpng؛ ويعيدtransparentمعjpegالرمز20001مع رسالة تسمّيbackground.n: من 1 إلى 10 صور لكل طلب. وتدفع مقابل الصور المُسلَّمة.moderation:autoأوlow.
كيف تُمرَّر الصور المرجعية والأقنعة؟
روابطَ، لا ملفات ولا base64 أبدًا. يأخذ images من 1 إلى 16 كائنًا بالشكل {"image_url": "https://..."}، وإرساله يحوّل الطلب إلى تحرير. ويأخذ mask كائنًا واحدًا بالشكل نفسه: صورة PNG بمقاس الصورة المرجعية الأولى، تحدد المنطقة الشفافة فيها ما يجب تغييره. ويسرد المرجع حدود الملفات.
الأسئلة الشائعة
هل يدعم GPT Image 2 دقة 4K؟
نعم، ضمن الحدود المذكورة أعلاه. فالمقاس 3840x2160 لنسبة 16:9 و2160x3840 لنسبة 9:16 هما أكبر إطارين، و2880x2880 هو أكبر مربع.
هل يمكنني إرسال نسبة أبعاد بدلًا من البكسلات؟
ليس إلى الـ API. حوّل النسبة أولًا إلى مقاس WIDTHxHEIGHT، باستخدام الجدول أعلاه أو Playground الذي يعرض المقاس الدقيق قبل الإرسال.
ما المقاس والجودة الافتراضيان؟
كلاهما auto افتراضيًا، ما يترك الاختيار للنموذج. أرسل قيمًا صريحة حين تحتاج إلى مخرجات يمكن توقعها.
أرسل البكسلات، واضبط الجودة، واقرأ رسالة الخطأ
تكاد كل مشكلة في المعاملات تكون واحدة من ثلاث: نسبة أُرسلت على أنها مقاس، أو حقل لا تقبله الـ API، أو قيمة خارج الحدود. في الأولى والثالثة تسمّي رسالة الخطأ الحقل؛ أما الرسالة العامة التي لا تسمّي أي حقل فتشير إلى الثانية. أبقِ هذه الصفحة بجانب مرجع GPT Image 2 API أثناء التكامل.
