API

Nano Banana 2.1 API

صورة

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

التفويضات

Bearerstringheaderمطلوب

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

النص

application/json

modelstringمطلوب

nano-banana-2-1

input.promptstringمطلوب

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

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

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

input.aspect_ratiostringاختياري

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

الافتراضي: auto

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

input.resolutionstringاختياري

مستوى دقة الصورة الناتجة. استخدم القيم 1k أو 2k أو 4k بأحرف صغيرة. عند حذف الحقل أو تركه فارغًا، تُستخدم القيمة الافتراضية 2k.

الافتراضي: 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-1",
  "input": {
    "prompt": "صورة منتج سينمائية لكاميرا مستقبلية على شكل موزة",
    "aspect_ratio": "1:1",
    "resolution": "2k"
  }
}'

POST /api/v1/create · HTTP 201

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

استعلم عن نقطة النهاية هذه باستخدام معرّف المهمة المُعاد حتى تكتمل المهمة أو تفشل. نوصي بالاستعلام كل 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-1",
    "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-1",
    "status": "failed",
    "data": null,
    "failed_reason": "Generation failed."
  }
}

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

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

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

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

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

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