واجهة API لنموذج Nano Banana 2.1

المرجع الكامل لواجهة API لنموذجي Nano Banana 2.1 لتوليد الصور من النصوص وتحرير الصور.

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

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

مقارنة سريعة

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

يدعم كلا النموذجين 14 نسبة عرض إلى ارتفاع:

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

حدّد النسبة باستخدام قيمتين رقميتين منفصلتين لـ width وheight؛ على سبيل المثال، تحدّد القيمتان width: 16 وheight: 9 النسبة 16:9. تعبّر هذه القيم عن نسبة، وليست أبعاد الصورة الناتجة بالبكسل.

Nano Banana 2.1 (توليد الصور من النصوص)

نقطة النهاية

POST /api/v1/image/task

المصادقة {#}

Authorization: Bearer YOUR_API_KEY

معلمات الطلب

مطلوبة

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

اختيارية

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

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: 'nano-banana-2.1',
    prompt: 'A serene mountain landscape at sunset',
    width: 16,
    height: 9,
    resolution: '2k',
    enable_web_search: true,
    enable_image_search: false
  })
});

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

Nano Banana 2.1 Edit (تحرير الصور)

نقطة النهاية

POST /api/v1/image/task

معلمات الطلب

مطلوبة

ملاحظة: يجب أن تكون نسبة width:height إحدى النسب الـ 14 المدعومة المذكورة أعلاه.

اختيارية

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

javascriptنسخ
{
  model_name: 'nano-banana-2.1-edit',
  prompt: 'Change the sky to sunset colors',
  width: 16,
  height: 9,
  resolution: '2k',
  image_url_list: ['https://example.com/image.jpg'],
  enable_web_search: false,
  enable_image_search: true
}

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

javascriptنسخ
{
  model_name: 'nano-banana-2.1-edit',
  prompt: 'Combine these images into a cohesive landscape',
  width: 16,
  height: 9,
  resolution: '2k',
  image_url_list: ['https://example.com/image1.jpg', 'https://example.com/image2.jpg', 'https://example.com/image3.jpg'],
  enable_web_search: false,
  enable_image_search: false
}

ملاحظة بشأن الفوترة: تُحتسب رسوم الصور المرجعية لكل صورة بدءًا من الصورة الأولى. يضيف كل خيار بحث مفعّل رسمًا ثابتًا منفصلًا لكل عملية توليد، بغض النظر عن عدد الصور. راجع الأسعار الحالية لمعرفة الرسوم.

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

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

jsonنسخ
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_status": "submitted"
  }
}

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

jsonنسخ
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_status": "processing",
    "task_status_msg": null,
    "task_result": null
  }
}

استجابة النجاح

jsonنسخ
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "credit": 0.074,
      "images": [
        {
          "url": "https://example.com/generated-image.png"
        }
      ]
    }
  }
}

قيم الحالة

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

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

نصائح لتوليد الصور من النصوص

1. صِف الصورة: ضمّن الموضوع والإضاءة والتكوين في المطالبة.
2. اختر الدقة: أرسل 1k أو 2k أو 4k في كل طلب.
3. اختر نسبة العرض إلى الارتفاع: أرسل قيمتي width وheight المطابقتين لإحدى النسب الـ 14 المدعومة.
4. اختر خيارات البحث: احذف أيًا من معلمتي البحث لاستخدام قيمتها الافتراضية false؛ واضبطها على true عند الحاجة.

نصائح لتحرير الصور

1. وفّر صورًا مرجعية: ضمّن من عنوان URL واحد إلى 14 عنوانًا لصور يمكن الوصول إليها في image_url_list.
2. صِف التعديل: وضّح في المطالبة ما ينبغي تغييره أو الحفاظ عليه.
3. اختر إعدادات المخرجات: أرسل القيم المطلوبة لـ resolution وwidth وheight.
4. اختر خيارات البحث: يمكن تفعيل البحث على الويب والبحث عن الصور بشكل مستقل.