ChatGPT Images 2.5 API

مرجع API الكامل لنماذج ChatGPT Images 2.5 Client وFlare وSunburst.

إصدارات النماذج

تدعم واجهة API هذه ستة إصدارات متاحة من النماذج:

مقارنة سريعة

يشترك Flare وSunburst في خيارات الطلب التالية. وتحتفظ إصدارات Client بخياراتها الحالية الموضحة في الجدول الثاني.

نسب الأبعاد المدعومة

16:9, 9:16, 1:1, 3:2, 2:3, 3:4, 4:3, 5:4, 4:5, 21:9

ChatGPT Images 2.5 Client (توليد الصور من النص)

نقطة النهاية

POST /api/v1/image/task

المصادقة {#}

Authorization: Bearer YOUR_API_KEY

معلمات الطلب

المعلمات المطلوبة

ملاحظة: يجب أن تكون نسبة العرض إلى الارتفاع إحدى النسب التالية: 16:9, 9:16, 1:1, 3:2, 2:3, 3:4, 4:3, 5:4, 4:5, 21:9

مثال على الطلب

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: 'chatgpt-images-2.5-client',
    prompt: 'A minimalist product shot of a ceramic mug on marble, soft studio light',
    width: 1,
    height: 1,
    resolution: '1k'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

// Poll for results
const pollResponse = await fetch(
  `https://api.flaq.ai/api/v1/image/${taskId}`,
  {
    headers: { Authorization: 'Bearer YOUR_API_KEY' }
  }
);

const result = await pollResponse.json();
console.log(result.data.task_result.images[0].url);

ChatGPT Images 2.5 Edit Client (تحرير الصور)

نقطة النهاية

POST /api/v1/image/task

معلمات الطلب

المعلمات المطلوبة

ملاحظة: يجب أن تكون نسبة العرض إلى الارتفاع إحدى النسب التالية: 16:9, 9:16, 1:1, 3:2, 2:3, 3:4, 4:3, 5:4, 4:5, 21:9

مثال على تحرير صورة واحدة

javascriptنسخ
{
  model_name: 'chatgpt-images-2.5-edit-client',
  prompt: 'Replace the background with a clean studio scene and brighten the product lighting',
  image_url_list: ['https://example.com/product-photo.jpg'],
  width: 16,
  height: 9,
  resolution: '1k'
}

مثال على دمج عدة صور في تكوين واحد

javascriptنسخ
{
  model_name: 'chatgpt-images-2.5-edit-client',
  prompt: 'Blend these reference images into a polished campaign composition while keeping the main subject identity consistent',
  image_url_list: [
    'https://example.com/image1.jpg',
    'https://example.com/image2.jpg',
    'https://example.com/image3.jpg'
  ],
  width: 16,
  height: 9,
  resolution: '1k'
}

ChatGPT Images 2.5 Flare (توليد الصور من النص)

نقطة النهاية

POST /api/v1/image/task

معلمات الطلب

المعلمات المطلوبة

يجب أن تتطابق نسبة العرض إلى الارتفاع مع إحدى نسب الأبعاد المدعومة المذكورة أعلاه.

المعلمات الاختيارية

مثال على الطلب

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.5-flare',
    prompt: 'A ceramic mug on a pale stone table, warm studio lighting, minimal composition',
    width: 1,
    height: 1,
    resolution: '1k',
    quality: 'medium'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

ChatGPT Images 2.5 Flare Edit (تحرير الصور)

نقطة النهاية

POST /api/v1/image/task

معلمات الطلب

المعلمات المطلوبة

يجب أن تتطابق نسبة العرض إلى الارتفاع مع إحدى نسب الأبعاد المدعومة المذكورة أعلاه.

المعلمات الاختيارية

مثال على الطلب

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.5-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'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

ChatGPT Images 2.5 Sunburst (توليد الصور من النص)

نقطة النهاية

POST /api/v1/image/task

معلمات الطلب

المعلمات المطلوبة

يجب أن تتطابق نسبة العرض إلى الارتفاع مع إحدى نسب الأبعاد المدعومة المذكورة أعلاه.

المعلمات الاختيارية

مثال على الطلب

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.5-sunburst',
    prompt: 'A ceramic mug on a pale stone table, warm studio lighting, minimal composition',
    width: 1,
    height: 1,
    resolution: '1k',
    quality: 'medium'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

ChatGPT Images 2.5 Sunburst Edit (تحرير الصور)

نقطة النهاية

POST /api/v1/image/task

معلمات الطلب

المعلمات المطلوبة

يجب أن تتطابق نسبة العرض إلى الارتفاع مع إحدى نسب الأبعاد المدعومة المذكورة أعلاه.

المعلمات الاختيارية

مثال على الطلب

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.5-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'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

تنسيق الاستجابة

الاستجابة الأولية

تُرجع جميع إصدارات ChatGPT Images 2.5 الستة حقل 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.5 أفضل النتائج عندما يصف النص الموضوع والتأطير والإضاءة والأسلوب المطلوب بوضوح.
2. اختر نسبة الأبعاد المناسبة للاستخدام النهائي: اضبط النسبة مسبقًا بما يناسب منشورات التواصل الاجتماعي أو اللافتات أو صفحات المنتجات أو التصاميم التحريرية.
3. استخدم صورًا أصلية واضحة للتحرير: تساعد المدخلات الحادة والمضاءة جيدًا على الحفاظ على هوية الموضوع وتحسين جودة التعديلات الموضعية.
4. اقتصر على صور مرجعية مناسبة في الطلبات متعددة الصور: في طلبات التحرير، أرفق الصور الضرورية فقط لتجنب التوجيهات البصرية المتعارضة.