Flux Kontext Max API

مرجع API كامل لـ Flux Kontext Max مع فهم محسّن لسياق الصور المتعددة.

نظرة عامة على النموذج

مقارنة سريعة

نسب العرض إلى الارتفاع المدعومة

يدعم كلا الوضعين 9 نسب عرض إلى ارتفاع:

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

التكلفة {#}

Flux Kontext Max (من النص إلى الصورة)

Endpoint

POST /api/v1/image/task

المصادقة

Authorization: Bearer YOUR_API_KEY

معاملات الطلب

مطلوبة

ملاحظة: يجب أن تكون نسبة width:height واحدة من: "1:1", "16:9", "9:16", "3:2", "2:3", "4:3", "3:4", "21:9", "9:21"

مثال طلب

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: 'flux-kontext-max',
    prompt: 'A futuristic cityscape at night with neon lights',
    width: 16,
    height: 9
  })
});

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);

Flux Kontext Max (من الصورة إلى الصورة)

Endpoint

POST /api/v1/image/task

معاملات الطلب

مطلوبة

ملاحظة: يجب أن تكون نسبة width:height واحدة من: "1:1", "16:9", "9:16", "3:2", "2:3", "4:3", "3:4", "21:9", "9:21"

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

javascriptنسخ
{
  model_name: 'flux-kontext-max',
  prompt: 'Enhance this portrait with cinematic lighting',
  width: 3,
  height: 4,
  image_url_list: ['https://example.com/portrait.jpg']
}

مثال تركيب صور متعددة

javascriptنسخ
{
  model_name: 'flux-kontext-max',
  prompt: 'Merge these architectural photos into a unified panorama',
  width: 21,
  height: 9,
  image_url_list: ['https://example.com/arch1.jpg', 'https://example.com/arch2.jpg', 'https://example.com/arch3.jpg']
}

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

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

يعيد كلا الوضعين 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"
}

استجابة الاستعلام الدوري

استعلم دوريًا عن /api/v1/image/{taskId} للتحقق من الحالة:

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.08,
      "images": [
        {
          "url": "https://example.com/generated-image.jpeg"
        }
      ]
    }
  },
  "message": "success"
}

قيم الحالة

• submitted: تم قبول المهمة
• processing: الإنشاء قيد التقدم
• succeed: اكتمل الإنشاء بنجاح
• failed: فشل الإنشاء

معالجة الأخطاء

الأخطاء الشائعة

نسبة عرض إلى ارتفاع غير صالحة

jsonنسخ
{
  "code": 400,
  "message": "Ratio must be one of: 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 21:9, 9:21"
}

رابط الصورة مفقود (وضع الصورة إلى الصورة)

jsonنسخ
{
  "code": 400,
  "message": "image_url_list is required for flux-kontext-max"
}

عدد الصور كبير جدًا

jsonنسخ
{
  "code": 400,
  "message": "Maximum 5 images allowed"
}

أفضل الممارسات

نصائح من النص إلى الصورة

1. Prompts مفصلة: قدم أوصافًا واضحة ومفصلة للحصول على أفضل النتائج
2. نسبة العرض إلى الارتفاع: اختر نسبة العرض إلى الارتفاع المناسبة لحالة الاستخدام لديك
3. المشاهد المعقدة: يتفوق Flux Kontext Max في المشاهد المعقدة والمفصلة
4. استعلام دوري فعال: تحقق من الحالة كل 2-3 ثوانٍ

نصائح من الصورة إلى الصورة

1. وعي بالسياق: استفد من إدخال الصور المتعددة لإنشاء غني بالسياق
2. إدخال عالي الجودة: استخدم صور مصدر عالية الدقة للحصول على أفضل النتائج
3. أهداف تحويل واضحة: صف النتيجة المطلوبة بدقة
4. تآزر الصور المتعددة: ادمج ما يصل إلى 5 صور للتركيبات المعقدة

أمثلة حالات الاستخدام

تصوير منتجات فاخرة

javascriptنسخ
{
  model_name: 'flux-kontext-max',
  prompt: 'Ultra-realistic product shot of diamond jewelry on black velvet',
  width: 4,
  height: 3
}

تصور معماري

javascriptنسخ
{
  model_name: 'flux-kontext-max',
  prompt: 'Modern minimalist interior with natural lighting',
  width: 16,
  height: 9
}

بانوراما متعددة الصور

javascriptنسخ
{
  model_name: 'flux-kontext-max',
  image_url_list: ['view1.jpg', 'view2.jpg', 'view3.jpg', 'view4.jpg'],
  prompt: 'Seamless 360-degree panorama of mountain landscape',
  width: 21,
  height: 9
}

نقل أسلوب متقدم

javascriptنسخ
{
  model_name: 'flux-kontext-max',
  image_url_list: ['photo.jpg'],
  prompt: 'Transform into oil painting with Van Gogh style brushwork',
  width: 1,
  height: 1
}