API

Nano Banana Pro API

صورة

يوفر Nano Banana Pro API توليد صور عالية الجودة بدقة 2K مع دعم الارتقاء إلى 4K، إلى جانب فهم أقوى للأوامر النصية، وعرض دقيق للنصوص، وإضاءة محسّنة، وتحكم أكبر في التكوين. ادمج API لإضافة توليد صور أكثر دقة وجاهزية للإنتاج إلى تطبيقاتك.

التفويضات

Bearerstringheaderمطلوب

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

النص

application/json

modelstringمطلوب

nano-banana-pro

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

POST /api/v1/create · HTTP 201

{
  "data": {
    "task_id": "task_example",
    "model": "nano-banana-pro",
    "status": "processing",
    "credits": 50
  }
}

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

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

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

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

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

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

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