الانتقال إلى المحتوى الرئيسي
POST
إنشاء تعديل صورة

التفويضات

Authorization
string
header
مطلوب

المصادقة باستخدام رمز Bearer

الجسم

multipart/form-data
model
string
مطلوب
image
مطلوب
prompt
string
مطلوب
models
string[]

نماذج احتياطية اختيارية ومرتبة تُجرَّب بعد model. الحقل model مطلوب وهو دائمًا النموذج الأساسي. عندما تفشل محاولة بالرمز 429 أو 500 أو 502 أو 503 أو 504، تُجرَّب الإدخالة التالية؛ وتُعاد الأخطاء الأخرى دون تغيير. يقبل ما يصل إلى 25 معرّف نموذج أو إعدادًا مسبقًا؛ وتُتجاهل الإدخالات المكررة والإدخالات المطابقة لـ model. يُتحقق من كل محاولة وتُسجَّل وتُحتسب تكلفتها كطلب مستقل، ويعرض الحقل model في الاستجابة وتتبّع التوجيه النموذج الذي خدم الطلب. لا تنتقل طلبات البث إلى نموذج احتياطي إلا قبل إرسال البايت الأول، ولا تنتقل مهام الفيديو والموسيقى إلا عند الإرسال. ترفض طلبات batch وrealtime وcouncil الحقل models. تكون الأولوية للنماذج الاحتياطية المحددة في مسار ديناميكي، ولا يمكن الجمع بين phaseo/auto وmodels.

Required array length: 1 - 25 elements
Minimum string length: 1
مثال:
mask
string
markup
string

طبقة تعليقات توضيحية بتنسيق PNG شفاف فوق الصورة الأولى، كملف مرفوع أو عنوان URL أو سلسلة base64. تتطلب GPT Image 2.5 أو أحدث، ولا يمكن دمجها مع mask.

complexity
enum<string>
الخيارات المتاحة:
low,
medium,
high
size
string
resolution
string
n
integer
النطاق المطلوب: 1 <= x <= 10
quality
enum<string>

جودة عرض الصور. تتوفر xhigh وmax لنماذج GPT Image 2.5 فقط.

الخيارات المتاحة:
standard,
low,
medium,
high,
xhigh,
max,
auto
stream
boolean
partial_images
integer
النطاق المطلوب: 0 <= x <= 3
output_format
enum<string>
الخيارات المتاحة:
png,
jpeg,
webp
output_compression
integer
النطاق المطلوب: 0 <= x <= 100
background
enum<string>
الخيارات المتاحة:
transparent,
opaque,
auto
moderation
enum<string>
الخيارات المتاحة:
auto,
low
input_fidelity
enum<string>
الخيارات المتاحة:
high,
low
user
string
meta
boolean
usage
boolean
provider
object

تفضيلات توجيه المزوّد لاختياره عبر البوابة.

الاستجابة

استجابة تعديل الصورة

created
integer
data
object[]
آخر تعديل في ١٦ نوفمبر ٢٠٢٦