الانتقال إلى المحتوى الرئيسي
POST
إنشاء صورة
ينشئ صورة واحدة أو أكثر من مطالبة نصية.

التفويضات

Authorization
string
header
مطلوب

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

الجسم

application/json
model
string
مطلوب
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
مثال:
size
string
resolution
string
n
integer
النطاق المطلوب: 1 <= x <= 10
quality
string
stream
boolean
partial_images
integer
النطاق المطلوب: 0 <= x <= 3
output_format
enum<string>

تنسيق الإخراج. يتطلب gif وsvg نموذج GPT Image 2.6 ولا يدعمان stream أو partial_images. ويتطلب svg أيضًا svg.model وn=1.

الخيارات المتاحة:
png,
jpeg,
webp,
gif,
svg
output_compression
integer
النطاق المطلوب: 0 <= x <= 100
background
enum<string>
الخيارات المتاحة:
transparent,
opaque,
auto
moderation
enum<string>
الخيارات المتاحة:
auto,
low
complexity
enum<string>
الخيارات المتاحة:
low,
medium,
high
frame_count
integer
النطاق المطلوب: 2 <= x <= 64
frame_duration_ms
integer
النطاق المطلوب: 20 <= x <= 2000
svg
object

مطلوب عندما تكون قيمة output_format هي svg. يحدد svg.model نموذج النص من OpenAI الذي يكتب ملف SVG من الصورة المرجعية. تُحتسب رموزه بأسعار النص لذلك النموذج، مع احتساب رموز الاستدلال كمخرجات، إضافةً إلى تكلفة الصورة.

response_format
string
style
string
user
string
provider
object

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

الاستجابة

استجابة الصورة

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