GPT Image 2.6

ولّد الصور وحرّرها وأنشئ GIF متحركًا واطلب إخراج SVG باستخدام GPT Image 2.6 عبر واجهة SeedRouter غير المتزامنة للصور.

يقبل ⁦GPT Image 2.6⁩ موجّهات نصية وصورًا مرجعية اختيارية. أرسل مرة واحدة إلى POST /v1/images/generations، واحتفظ بمعرّف المهمة، واستعلم عبر GET /v1/tasks/{id} عن النتيجة. تُعاد الملفات المكتملة على شكل روابط.

معرّفات النماذج والأسعار

استخدم GET /v1/models لاكتشاف النماذج المتاحة لمفتاحك. معرّفا ⁦Sunburst⁩ المهيّآن هما gpt-image-2.6-sunburst-official وgpt-image-2.6-sunburst. تستخدم معرّفات ⁦Flare⁩، عند إدراجها، عقد المعاملات نفسه. يستخدم معرّف النموذج المجرّد مجموعته ⁦Default⁩؛ وتستخدم المجموعات الإضافية معرّف model:group الظاهر في الاكتشاف.

راجع الأسعار الحالية و⁦Playground⁩. تُسوّى النماذج المحتسبة بالتوكنات وفق الاستخدام الفعلي؛ وتستخدم النماذج المحتسبة لكل صورة سعر الصورة المهيّأ. تبلّغ استجابات ⁦SVG⁩ توكنات نموذج كتابة الشفرة على نحو منفصل في svg_usage، وتُحتسب بسعر ذلك النموذج نفسه على ⁦SeedRouter⁩.

توليد صورة

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-sunburst-official",
    "prompt": "A red paper crane on a pale blue table, soft daylight",
    "size": "1024x1024",
    "quality": "low",
    "complexity": "high"
  }'

تحتوي الاستجابة على id. استعلم عن ذلك المعرّف بدل إرسال طلب التوليد مجددًا:

curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

عند الاكتمال، يحتوي output.data على كائنات تتضمن url. نزّل الرابط للاحتفاظ بصيغة الملف الأصلية وبكل إطار حركة في ⁦GIF⁩. تتضمن المهمة الفاشلة error ولا تُحتسب رسوم عليها. راجع حالات المهمة والاستعلام.

المعاملات

يوجد 18 حقلًا من المستوى الأعلى. المطلوبان فقط هما model وprompt. تقبل الحقول الاختيارية null التي تعادل الإغفال. تُهمَل الحقول غير المعروفة. ولا تجتاز القيم المدعومة غير الصالحة التحقق قبل توليد الصور.

الحقل	النوع	القيمة الافتراضية والقيود
`model`	⁦string⁩	مطلوب؛ استخدم معرّفًا متاحًا لمفتاحك.
`prompt`	⁦string⁩	مطلوب وغير فارغ، بحد أقصى 32,000 حرف ⁦Unicode⁩.
`n`	⁦integer⁩	1؛ النطاق 1–10. يتطلب ⁦SVG⁩ القيمة 1.
`size`	⁦string⁩	`auto` أو `WIDTHxHEIGHT`. راجع قواعد المقاس أدناه.
`quality`	⁦string⁩	`auto`؛ وكذلك `low` و`medium` و`high` و`xhigh` و`max`.
`background`	⁦string⁩	`auto`؛ وكذلك `opaque` و`transparent`. لا يمكن أن يكون ⁦JPEG⁩ شفافًا.
`output_format`	⁦string⁩	`png`؛ وكذلك `jpeg` و`gif` و`svg`. لا يُتاح إخراج ⁦WebP⁩.
`output_compression`	⁦integer⁩	100 مع ⁦JPEG⁩؛ من 0–100. أرسله فقط مع `output_format: "jpeg"`.
`moderation`	⁦string⁩	`auto`؛ وكذلك `low`. يُبقي ⁦Playground⁩ العام `low` متاحًا عبر ⁦API⁩ فقط.
`complexity`	⁦string⁩	`high`؛ وكذلك `low` و`medium`. جهد التخطيط، دون رسم إضافي منفصل.
`frame_count`	⁦integer⁩	9؛ النطاق 2–16. مع ⁦GIF⁩ فقط.
`frame_duration_ms`	⁦integer⁩	200؛ بحد أدنى 20 ملّي ثانية، دون حد أقصى. مع ⁦GIF⁩ فقط؛ يقرّب المرمّز إلى أقرب 10 ملّي ثانية ويحدّ كل إطار بـ655,350 ملّي ثانية.
`svg`	⁦object⁩	مُغفل. اختيار نموذج كتابة الشفرة اختياري؛ انظر أدناه.
`images`	⁦array⁩	1–16 كائنًا بالشكل `{"image_url":"https://..."}`؛ يفعّل التحرير.
`mask`	⁦object⁩	`{"image_url":"https://..."}`. يتطلب `images`؛ ولا يجتمع مع `markup`.
`markup`	⁦object⁩	`{"image_url":"https://..."}`. يتطلب `images`؛ ولا يجتمع مع `mask`.
`safety_identifier`	⁦string⁩	معرّف ثابت اختياري للمستخدم النهائي، بحد أقصى 128 حرفًا. تتقدّم القيمة غير الفارغة على `user`.
`user`	⁦string⁩	معرّف اختياري مهجور للمستخدم النهائي؛ لا يظهر في ⁦Playground⁩ ولا يُملأ تلقائيًا أبدًا.

يجب أن تستخدم الروابط المرجعية ⁦HTTP⁩ أو ⁦HTTPS⁩ وألا تحتوي بيانات اعتماد. لا تُقبل معرّفات الملفات ولا ⁦base64⁩ المضمّن ولا رفع ⁦multipart⁩؛ ارفع الملفات أولًا وقدّم روابطها العامة. تستخدم الطلبات الاستعلام عن مهام غير متزامنة بدل stream أو partial_images. لا يتيح هذا العقد input_fidelity ولا response_format ولا prompt_rewriter.

مقاس الصورة

لتوليد ⁦PNG⁩ و⁦JPEG⁩ والصورة المرجعية لـ⁦SVG⁩، يجب أن يقبل كل بُعد القسمة على 16 وألا يتجاوز 3840 بكسل. يجب أن يكون مجموع البكسلات 655,360–8,294,400 وأن تكون نسبة الأبعاد بين 1:3 و3:1. أمثلة: 1024x1024، 1536x1024، 2160x3840، 2880x2880.

يجب أن تكون أبعاد ⁦GIF⁩ مضاعفات موجبة لـ16، أو استخدم auto. لـ⁦GIF⁩ ميزانية بكسلات إجمالية منفصلة يشترك فيها عدد الإطارات وأبعادها وn؛ ولم تنشر ⁦OpenAI⁩ حدّها العددي. لا يخضع ⁦GIF⁩ بمقاس 512x512 لقاعدة الحد الأدنى للبكسلات في الصور الثابتة.

⁦GIF⁩ متحرك

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A red paper crane flapping its wings in a seamless loop on pale blue",
  "output_format": "gif",
  "size": "512x512",
  "quality": "low",
  "frame_count": 4,
  "frame_duration_ms": 200
}

يمكن توليد ⁦GIF⁩ من موجّه أو طلبه من صور مرجعية. لا تجمعه مع قناع أو ضغط. قد يعتمد توفر المعاينة على صلاحية الوصول إلى النموذج المختار.

اختلاف في التوثيق، تم التحقق في 5 نوفمبر 2026: يحدّد دليل توليد الصور لدى ⁦OpenAI⁩ نطاق 2–64 إطارًا و20–2000 ملّي ثانية، ويقول إن نقطة نهاية التحرير لا تعيد ⁦GIF⁩. يحدّد مرجع ⁦Images API⁩ نطاق 2–16 إطارًا دون حد أقصى للمدة، ويدرج إخراج ⁦GIF⁩ عند التحرير. طابقت الطلبات إلى المصدر في 5 نوفمبر 2026 المرجع: رُفض 17 إطارًا، وقُبل إطار بمدة 3,000 ملّي ثانية. تتبع هذه ⁦API⁩ المرجع.

⁦SVG⁩

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A simple geometric red paper-crane logo, clean editable vector paths",
  "output_format": "svg",
  "n": 1
}

⁦SVG⁩ للتوليد فقط ويتطلب n: 1. لا ترسل صورًا أو قناعًا أو علامات توجيه التحرير أو ضغطًا. الملف ⁦XML⁩ ثابت بترميز ⁦UTF-8⁩ يحتوي أشكالًا متجهة؛ ولا تُدعم البرامج النصية ولا الموارد الخارجية ولا الصور النقطية المضمّنة.

عندما يتاح اختيار نموذج كتابة الشفرة، أضف svg: {"model":"YOUR_AUTHOR_MODEL_ID"}. يتطلب كائن svg المرسل صراحةً قيمة model غير فارغة. يمكنك أيضًا ضبط svg.reasoning.effort على none أو minimal أو low أو medium أو high أو xhigh أو max؛ ويحدّد النموذج المختار القيم التي يدعمها. أغفل reasoning لاستخدام افتراضيه. لا تنشر ⁦OpenAI⁩ قائمة سماح لنماذج كتابة الشفرة ولا قيمة افتراضية عامة. إذا لم يتوفر الاختيار، فأغفل كائن svg بالكامل.

قد تتضمن النتيجة المكتملة svg_usage مع model وinput_tokens وoutput_tokens وreasoning_tokens وtotal_tokens. وهو منفصل عن usage الخاص بالصورة، وليس عددًا إضافيًا لتوكنات الصورة.

الصور المرجعية والقناع وعلامات توجيه التحرير

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "Replace the marked background with a pale blue studio backdrop",
  "images": [{"image_url":"https://example.com/reference.png"}],
  "markup": {"image_url":"https://example.com/transparent-markup.png"},
  "output_format": "png",
  "complexity": "low"
}

تدعم الصور المرجعية ⁦PNG⁩ و⁦JPEG⁩ و⁦WebP⁩، بحد أقصى 50 ⁦MB⁩ لكل صورة. يجب أن يكون القناع وعلامات توجيه التحرير بصيغة ⁦PNG⁩ وأن يطابقا أبعاد الصورة المرجعية الأولى بعد تصحيح الاتجاه. يجب أن تحتوي علامات توجيه التحرير بكسلات شفافة؛ ويمكن أن يحتوي كل من ملف العلامات والصورة المرجعية الأولى بحد أقصى 16,777,216 بكسل، وألا يتجاوز ملف العلامات 50 ⁦MB⁩. لا يمكن الجمع بين القناع والعلامات.

حقول الاستجابة

تحتوي مخرجات الصورة المكتملة على created وdata: [{url}]، وعند الإبلاغ عنها، size وquality وbackground وoutput_format وusage وsvg_usage وsafety_identifier. قد يفصل usage توكنات مدخلات ومخرجات النصوص والصور والمدخلات المخزّنة مؤقتًا. لا تتضمن المخرجات العامة بايتات صور ⁦base64⁩ ولا حقول التكلفة.

مخطط ⁦OpenAPI⁩ · مرجع التوليد لدى ⁦OpenAI⁩ · مرجع التحرير لدى ⁦OpenAI⁩ · دليل الصور لدى ⁦OpenAI⁩

On this page