ChatGPT Images 2.6 API
مرجع API الكامل لنماذج ChatGPT Images 2.6 Flare وSunburst.
إصدارات النماذج
تدعم واجهة API هذه أربعة إصدارات من النماذج:
مقارنة سريعة
يشترك Flare وSunburst في خيارات الطلب التالية.
نسب الأبعاد المدعومة
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
معلمات الطلب
مطلوبة
يجب أن تطابق نسبة width:height إحدى نسب الأبعاد المدعومة المذكورة أعلاه.
اختيارية
مثال على الطلب
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
معلمات الطلب
مطلوبة
يجب أن تطابق نسبة width:height إحدى نسب الأبعاد المدعومة المذكورة أعلاه.
اختيارية
مثال على الطلب
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
معلمات الطلب
مطلوبة
يجب أن تطابق نسبة width:height إحدى نسب الأبعاد المدعومة المذكورة أعلاه.
اختيارية
مثال على الطلب
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
معلمات الطلب
مطلوبة
يجب أن تطابق نسبة width:height إحدى نسب الأبعاد المدعومة المذكورة أعلاه.
اختيارية
مثال على الطلب
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 للاستعلام الدوري:
{
"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} للتحقق من الحالة:
{
"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؛ فقد لا تتضمن المهمة المُرسلة أو الجاري معالجتها نتائج صور بعد.
أفضل الممارسات
- وضّح التكوين بدقة: يحقق ChatGPT Images 2.6 أفضل النتائج عندما تصف النصوص الموضوع والتأطير والإضاءة والأسلوب المطلوب بوضوح.
- اضبط نسبة الأبعاد وفقًا لوجهة الاستخدام: حدّد النسبة مسبقًا لمنشورات التواصل الاجتماعي أو اللافتات أو صفحات المنتجات أو التخطيطات التحريرية.
- استخدم صورًا أصلية واضحة للتحرير: تساعد المدخلات الحادة والمضاءة جيدًا على الحفاظ على الهوية وتحسين جودة التعديلات الموضعية.
- اقتصر في الطلبات متعددة الصور على المراجع الملائمة: في طلبات التحرير، قدّم الصور المهمة فقط لتجنب التوجيهات البصرية المتعارضة.