API

Nano Banana 2 API

صورة

يجمع Nano Banana 2 API بين المعرفة العالمية في الوقت الفعلي والاستدلال المتقدم لتقديم فهم أقوى للأوامر النصية ونتائج بصرية أكثر دقة. أنشئ صورًا متسقة متعددة العناصر بدقة 4K أصلية، مع نسب أبعاد مرنة وطباعة عالمية عالية الجودة داخل التكوينات المعقدة. ادمج Nano Banana 2 API لبناء تدفقات عمل صور أكثر ذكاءً وقابلية للتوسع وعالية الجودة.

التفويضات

Bearerstringheaderمطلوب

مفتاح API لتفويض الطلبات

النص

application/json

modelstringمطلوب

nano-banana-2

input.promptstringمطلوب

صف الصورة التي تريد إنشاءها أو التغييرات التي تريد تطبيقها على الصور المرجعية. تتم إزالة المسافات الزائدة من الأطراف.

الحد الأقصى للطول: 5,000 حرف

input.imagesstring[]اختياري

عناوين URL اختيارية للصور المرجعية. استخدم فقط عناوين HTTPS متاحة للعامة. احذف هذا الحقل عند إنشاء صور من النص.

الحد الأقصى للعناصر: 14

input.aspect_ratiostringاختياري

نسبة عرض الناتج إلى ارتفاعه. يتيح Auto للنموذج اختيار النسبة.

الافتراضي: auto

auto1:12:33:23:44:34:55:49:1616:921:91:44:11:88:1

input.resolutionstringاختياري

مستوى دقة الإخراج؛ القيم غير حساسة لحالة الأحرف. اترك الحقل أو دعه فارغًا لاستخدام القيمة الافتراضية.

الافتراضي: 2k

1k2k4k

أمثلة الطلبات

POST /api/v1/create

curl -X POST https://nanobanana.io/api/v1/create \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "nano-banana-2",
  "input": {
    "prompt": "صورة منتج سينمائية لكاميرا مستقبلية على شكل موزة",
    "aspect_ratio": "1:1",
    "resolution": "2k"
  }
}'

POST /api/v1/create · HTTP 201

{
  "data": {
    "task_id": "task_example",
    "model": "nano-banana-2",
    "status": "processing",
    "credits": 30
  }
}

استعلم عن نقطة النهاية هذه باستخدام معرّف المهمة المُعاد حتى تكتمل المهمة أو تفشل. نوصي بالاستعلام كل 5 ثوانٍ للتحقق من أحدث حالة للمهمة.

POST /api/v1/check

{
  "task_id": "task_example"
}

الاستجابة

حالة المهمة التي يعيدها POST /api/v1/check. المعرّفات والروابط والطوابع الزمنية التالية أمثلة توضيحية.

idstringمطلوب

معرّف المهمة في data.id يطابق task_id المُرسل في طلب الاستعلام.

statusstringمطلوب

تعني completed نجاح الإنشاء وتحتوي data.data على النتائج. تكون data.data بقيمة null في الحالات الأخرى.

failed_reasonstringاختياري

يُعاد فقط عندما تكون status بقيمة failed لشرح سبب الفشل. لا يظهر هذا الحقل في completed أو processing.

مكتملة · completed

روابط التنزيل موجودة في data.data.results.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "nano-banana-2",
    "status": "completed",
    "data": {
      "results": [
        "https://example.com/generated.png"
      ],
      "processing_time": 18
    }
  }
}

الحالات الأخرى

تكون data.data بقيمة null في processing أو failed. يوضح هذا المثال failed: تظهر failed_reason في failed فقط. تابع الاستعلام في processing وأوقفه في failed.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "nano-banana-2",
    "status": "failed",
    "data": null,
    "failed_reason": "Generation failed."
  }
}

استهلاك النقاط

النقاط المستهلكة لطلب يولّد صورة واحدة.

النقاط المستهلكة لطلب يولّد صورة واحدة.
الدقة	1K	2K	4K
صورة واحدة	20	30	40

بدون المعلمات الاختيارية: 20 نقطة

أرسل معلمات input المدرجة صراحةً لاستخدام السعر المقابل. قد تستهلك الطلبات التي تولّد عدة صور نقاطًا أكثر.

يوضح حقل credits في استجابة POST /api/v1/create عدد النقاط المخصومة للمهمة.