# ChatGPT Images 2.6 API مرجع API الكامل لنماذج ChatGPT Images 2.6 Flare وSunburst. ## إصدارات النماذج تدعم واجهة API هذه أربعة إصدارات من النماذج: | النموذج | ID | الوصف | |-------|-----|-------------| | **ChatGPT Images 2.6 Flare** | `gpt-image-2.6-flare` | توليد الصور من النص مع التحكم في الدقة والجودة | | **ChatGPT Images 2.6 Flare Edit** | `gpt-image-2.6-flare-edit` | تحرير الصور ودمج صور متعددة في تكوين واحد | | **ChatGPT Images 2.6 Sunburst** | `gpt-image-2.6-sunburst` | توليد الصور من النص مع التحكم في الدقة والجودة | | **ChatGPT Images 2.6 Sunburst Edit** | `gpt-image-2.6-sunburst-edit` | تحرير الصور ودمج صور متعددة في تكوين واحد | ## مقارنة سريعة يشترك Flare وSunburst في خيارات الطلب التالية. | الميزة | Flare / Sunburst | Flare Edit / Sunburst Edit | |---------|-----------------|---------------------------| | المدخلات | وصف نصي | صورة أو صور + وصف نصي | | خيارات الدقة | `1k`, `2k`, `4k` | `1k`, `2k`, `4k` | | خيارات الجودة | `low`, `medium`, `high`, `xhigh`, `max` | `low`, `medium`, `high`, `xhigh`, `max` | | الجودة الافتراضية | `medium` | `medium` | | نسب الأبعاد | 10 خيارات | 10 خيارات | | الصور المدخلة | لا | مطلوبة (1–16 صورة) | | تنسيقات الإخراج | `png`, `jpeg`, `webp`, `gif`, `svg` | `png`, `jpeg`, `webp` | | تنسيق الإخراج الافتراضي | `png` | `png` | ### نسب الأبعاد المدعومة `16:9`, `9:16`, `1:1`, `3:2`, `2:3`, `3:4`, `4:3`, `5:4`, `4:5`, `21:9` ## ChatGPT Images 2.6 Flare (توليد الصور من النص) ### نقطة النهاية ``` POST /api/v1/image/task ``` ### المصادقة ``` Authorization: Bearer YOUR_API_KEY ``` ### معلمات الطلب #### مطلوبة | المعلمة | النوع | الوصف | |-----------|------|-------------| | `model_name` | string | يجب أن تكون القيمة `"gpt-image-2.6-flare"` | | `prompt` | string | الوصف النصي لتوليد الصورة | | `width` | integer | قيمة العرض في نسبة الأبعاد، مثل `16` للنسبة `16:9`؛ وليست بُعدًا بالبكسل | | `height` | integer | قيمة الارتفاع في نسبة الأبعاد، مثل `9` للنسبة `16:9`؛ وليست بُعدًا بالبكسل | | `resolution` | string | `"1k"`, `"2k"`, أو `"4k"` | يجب أن تطابق نسبة width:height إحدى نسب الأبعاد المدعومة المذكورة أعلاه. #### اختيارية | المعلمة | النوع | القيمة الافتراضية | الوصف | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"`, أو `"max"` | | `output_format` | string | `"png"` | تنسيق الإخراج: `"png"` أو `"jpeg"` أو `"webp"` أو `"gif"` أو `"svg"`. استخدم `"gif"` للرسوم المتحركة بصيغة GIF أو `"svg"` للإخراج المتجهي بصيغة SVG | | `frame_count` | integer | `9` | عدد إطارات GIF، من `2` إلى `16`. ينطبق فقط عندما تكون قيمة `output_format` هي `"gif"` | | `frame_duration_ms` | integer | `200` | مدة إطار GIF بالمللي ثانية، من `20` إلى `2000`. ينطبق فقط عندما تكون قيمة `output_format` هي `"gif"` | ### مثال على الطلب ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'gpt-image-2.6-flare', prompt: 'A looping animation of steam rising from a ceramic mug on a pale stone table, warm studio lighting', width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'gif', frame_count: 9, frame_duration_ms: 200 }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## ChatGPT Images 2.6 Flare Edit (تحرير الصور) ### نقطة النهاية ``` POST /api/v1/image/task ``` ### معلمات الطلب #### مطلوبة | المعلمة | النوع | الوصف | |-----------|------|-------------| | `model_name` | string | يجب أن تكون القيمة `"gpt-image-2.6-flare-edit"` | | `prompt` | string | وصف التعديلات المطلوبة | | `image_url_list` | string[] | عناوين URL للصور المدخلة؛ من صورة واحدة إلى 16 صورة، على أن يكون حجم كل صورة أقل من 50 ميغابايت | | `width` | integer | قيمة العرض في نسبة الأبعاد، مثل `16` للنسبة `16:9`؛ وليست بُعدًا بالبكسل | | `height` | integer | قيمة الارتفاع في نسبة الأبعاد، مثل `9` للنسبة `16:9`؛ وليست بُعدًا بالبكسل | | `resolution` | string | `"1k"`, `"2k"`, أو `"4k"` | يجب أن تطابق نسبة width:height إحدى نسب الأبعاد المدعومة المذكورة أعلاه. #### اختيارية | المعلمة | النوع | القيمة الافتراضية | الوصف | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"`, أو `"max"` | | `output_format` | string | `"png"` | تنسيق الإخراج: `"png"` أو `"jpeg"` أو `"webp"` | ### مثال على الطلب ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'gpt-image-2.6-flare-edit', prompt: 'Replace the background with a warm studio setting while keeping the product unchanged', image_url_list: ['https://example.com/product-photo.jpg'], width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'png' }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## ChatGPT Images 2.6 Sunburst (توليد الصور من النص) ### نقطة النهاية ``` POST /api/v1/image/task ``` ### معلمات الطلب #### مطلوبة | المعلمة | النوع | الوصف | |-----------|------|-------------| | `model_name` | string | يجب أن تكون القيمة `"gpt-image-2.6-sunburst"` | | `prompt` | string | الوصف النصي لتوليد الصورة | | `width` | integer | قيمة العرض في نسبة الأبعاد، مثل `16` للنسبة `16:9`؛ وليست بُعدًا بالبكسل | | `height` | integer | قيمة الارتفاع في نسبة الأبعاد، مثل `9` للنسبة `16:9`؛ وليست بُعدًا بالبكسل | | `resolution` | string | `"1k"`, `"2k"`, أو `"4k"` | يجب أن تطابق نسبة width:height إحدى نسب الأبعاد المدعومة المذكورة أعلاه. #### اختيارية | المعلمة | النوع | القيمة الافتراضية | الوصف | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"`, أو `"max"` | | `output_format` | string | `"png"` | تنسيق الإخراج: `"png"` أو `"jpeg"` أو `"webp"` أو `"gif"` أو `"svg"`. استخدم `"gif"` للرسوم المتحركة بصيغة GIF أو `"svg"` للإخراج المتجهي بصيغة SVG | | `frame_count` | integer | `9` | عدد إطارات GIF، من `2` إلى `16`. ينطبق فقط عندما تكون قيمة `output_format` هي `"gif"` | | `frame_duration_ms` | integer | `200` | مدة إطار GIF بالمللي ثانية، من `20` إلى `2000`. ينطبق فقط عندما تكون قيمة `output_format` هي `"gif"` | ### مثال على الطلب ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'gpt-image-2.6-sunburst', prompt: 'A looping animation of steam rising from a ceramic mug on a pale stone table, warm studio lighting', width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'gif', frame_count: 9, frame_duration_ms: 200 }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## ChatGPT Images 2.6 Sunburst Edit (تحرير الصور) ### نقطة النهاية ``` POST /api/v1/image/task ``` ### معلمات الطلب #### مطلوبة | المعلمة | النوع | الوصف | |-----------|------|-------------| | `model_name` | string | يجب أن تكون القيمة `"gpt-image-2.6-sunburst-edit"` | | `prompt` | string | وصف التعديلات المطلوبة | | `image_url_list` | string[] | عناوين URL للصور المدخلة؛ من صورة واحدة إلى 16 صورة، على أن يكون حجم كل صورة أقل من 50 ميغابايت | | `width` | integer | قيمة العرض في نسبة الأبعاد، مثل `16` للنسبة `16:9`؛ وليست بُعدًا بالبكسل | | `height` | integer | قيمة الارتفاع في نسبة الأبعاد، مثل `9` للنسبة `16:9`؛ وليست بُعدًا بالبكسل | | `resolution` | string | `"1k"`, `"2k"`, أو `"4k"` | يجب أن تطابق نسبة width:height إحدى نسب الأبعاد المدعومة المذكورة أعلاه. #### اختيارية | المعلمة | النوع | القيمة الافتراضية | الوصف | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"`, أو `"max"` | | `output_format` | string | `"png"` | تنسيق الإخراج: `"png"` أو `"jpeg"` أو `"webp"` | ### مثال على الطلب ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'gpt-image-2.6-sunburst-edit', prompt: 'Replace the background with a warm studio setting while keeping the product unchanged', image_url_list: ['https://example.com/product-photo.jpg'], width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'png' }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## تنسيق الاستجابة ### الاستجابة الأولية تعيد إصدارات ChatGPT Images 2.6 الأربعة جميعها معرّف `task_id` للاستعلام الدوري: ```json { "code": 0, "data": { "task_id": "{task_id}", "task_status": "submitted", "response_url": "https://api.flaq.ai/api/v1/image/{task_id}" }, "message": "success" } ``` ### استجابة الاستعلام الدوري استعلم دوريًا باستخدام `GET /api/v1/image/{task_id}` للتحقق من الحالة: ```json { "code": 0, "data": { "task_id": "{task_id}", "task_status": "succeed", "task_status_msg": null, "response_url": "https://api.flaq.ai/api/v1/image/{task_id}", "task_result": { "credit": 0.0997, "images": [ { "url": "https://example.com/generated-image.jpeg" } ] } }, "message": "success" } ``` ### قيم الحالة - `submitted`: تم قبول المهمة - `processing`: جارٍ توليد الصورة أو تحريرها - `succeed`: اكتملت المهمة بنجاح - `failed`: فشلت المهمة ## مدة المعالجة تختلف مدة المعالجة حسب النموذج وإعدادات الإخراج وتعقيد الوصف النصي وعدد الصور المرجعية. واصل الاستعلام الدوري حتى تصبح حالة المهمة `succeed` أو `failed`؛ فقد لا تتضمن المهمة المُرسلة أو الجاري معالجتها نتائج صور بعد. ## أفضل الممارسات 1. **وضّح التكوين بدقة**: يحقق ChatGPT Images 2.6 أفضل النتائج عندما تصف النصوص الموضوع والتأطير والإضاءة والأسلوب المطلوب بوضوح. 2. **اضبط نسبة الأبعاد وفقًا لوجهة الاستخدام**: حدّد النسبة مسبقًا لمنشورات التواصل الاجتماعي أو اللافتات أو صفحات المنتجات أو التخطيطات التحريرية. 3. **استخدم صورًا أصلية واضحة للتحرير**: تساعد المدخلات الحادة والمضاءة جيدًا على الحفاظ على الهوية وتحسين جودة التعديلات الموضعية. 4. **اقتصر في الطلبات متعددة الصور على المراجع الملائمة**: في طلبات التحرير، قدّم الصور المهمة فقط لتجنب التوجيهات البصرية المتعارضة.