مقدمة API البدء السريع Nano Banana Pro Nano Banana 2 Nano Banana 2 Lite

البدء

البدء السريع

ابدأ استخدام Nano Banana API باستخدام رمز Bearer ونص طلب JSON ونقطتي الإنتاج create وcheck.

ما الذي تحتاج إليه

Aحساب Nano Banana يحتوي على رصيد متاح
مفتاح API تم إنشاؤه من لوحة مفاتيح API

احصل على مفتاح API

سجّل الدخول وافتح صفحة مفاتيح API، ثم أدخل اسمًا للمفتاح وانقر على إنشاء. انسخ المفتاح فورًا؛ إذ يتم عرض المفتاح الكامل مرة واحدة فقط.

إعداد ترويسة طلب HTTP

عنوان URL الأساسي

HTTPS

https://nanobanana.io

HTTP

Authorization: Bearer sk_live_your_api_key
Content-Type: application/json

البدء السريع

أرسل حمولة JSON لإنشاء مهمة توليد غير متزامنة. احفظ task_id الذي تم إرجاعه واستخدمه للتحقق من حالة المهمة.

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": "1k"
  }
}'

الاستجابة

{
  "data": {
    "task_id": "d0a8d9f2-5e01-4c5d-9f40-38d197a1c617",
    "model": "nano-banana-2",
    "status": "processing",
    "credits": 20
  }
}

إنشاء مهمة

أرسل معرّف نموذج وكائن إدخال لإنشاء مهمة توليد غير متزامنة. تؤكد نقطة النهاية هذه أن المهمة أضيفت إلى قائمة الانتظار، ولا تنتظر نتيجة الوسائط النهائية.

POST/api/v1/create

التفويضات

الحقل

النوع

مطلوب

الوصف والقيود

Authorizationstringمطلوب

يتم تمرير مفتاح API كرمز Bearer في ترويسة الطلب. مثال: Authorization: Bearer sk_live_your_api_key

نص الطلب

application/json

الحقل

النوع

مطلوب

الوصف والقيود

modelstringمطلوب

المعرّف العام للنموذج. استخدم نموذجًا مدرجًا في قسم API، مثل nano-banana-2.

inputobjectمطلوب

مدخلات التوليد. يجب أن تتضمن prompt غير فارغ. تعتمد حقول الإدخال الأخرى على النموذج؛ راجع وثائق النموذج المقابل قبل إرسال حقول مثل الصور أو نسبة الأبعاد أو المدة أو الدقة أو العدد.

JSON

{
  "model": "nano-banana-2",
  "input": {
    "prompt": "صورة منتج سينمائية لكاميرا مستقبلية على شكل موزة",
    "aspect_ratio": "1:1",
    "resolution": "1k"
  }
}

استجابة الإنشاء

application/json

تعيد الاستجابة الناجحة معرّف المهمة ومعرّف النموذج وحالة قائمة الانتظار وعدد الأرصدة المحجوزة لهذه المهمة.

HTTP 201

{
  "data": {
    "task_id": "d0a8d9f2-5e01-4c5d-9f40-38d197a1c617",
    "model": "nano-banana-2",
    "status": "processing",
    "credits": 20
  }
}

الحصول على حالة المهمة

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

POST/api/v1/check

نص الطلب

application/json

الحقل

النوع

مطلوب

الوصف والقيود

task_idstringمطلوب

معرّف المهمة الذي تعيده POST /api/v1/create. استخدم هذا المعرّف لجلب حالة المهمة وعناوين URL للنتائج النهائية.

JSON

{
  "task_id": "d0a8d9f2-5e01-4c5d-9f40-38d197a1c617"
}

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

application/json

عند اكتمال المعالجة، تتضمن الاستجابة عناوين URL للنتائج النهائية وبيانات التوقيت. أثناء استمرار المهمة، data يتم إرجاعه على أنه null.

HTTP 200

{
  "id": "adc0e6ec-9c12-44fc-b45f-112187766c3",
  "created_at": 1788652800,
  "model": "nano-banana-2",
  "status": "completed",
  "data": {
    "results": [
      "https://cdn.nanobanana.io/api/predictions/example.mp4"
    ],
    "processing_time": 48
  }
}