دليل مطوري Nano Banana Pro API

دليل المطورين الكامل لمنصة Nano Banana Pro API للإنتاج المرئي المدعومة بتقنيات التعلم الآلي المتقدمة

عرض الأسعاراكتشف خطط الاشتراك لـ Nano Banana Pro API

نظرة عامة على Nano Banana Pro API

تتيح خدمة الإنتاج البصري في Nano Banana Pro API للمطورين الاتصال بمحركات تعلم آلي متقدمة لإنتاج صور عالية الجودة من التوجيهات النصية وصور مرجعية. توفر حل Nano Banana Pro API واجهة REST بسيطة مع إدارة مهام كاملة وإشعارات في الوقت الحقيقي.

الميزات الرئيسية لـ Nano Banana Pro API

• تحويل النص إلى صورة باستخدام محركات تعلم آلي متقدمة
• دعم الصور المرجعية (حتى 4 صور)
• معالجة مهام غير متزامنة مع تتبع التقدم في الوقت الحقيقي
• إشعارات webhook لتحديثات الحالة الفورية
• واجهة REST تُعيد بيانات JSON منظمة
• آلية مصادقة بواسطة رمز Bearer

overview.base_url

https://api.defapi.org

overview.api_version

v1.0.0

البدء السريع لـ Nano Banana Pro API

1. أنشئ حساب Nano Banana Pro API واحصل على بيانات الدخول من موقعنا الرسمي
2. أدرج رمز المصادقة في ترويسة Authorization
3. أرسل طلب POST إلى نقطة نهاية توليد الصور في Nano Banana Pro API
4. استخدم معرف المهمة (task ID) المستلم للتحقق من حالة المعالجة
5. استرجع الصور المولدة بعد اكتمال المعالجة

مصادقة الوصول

يجب أن تتضمن جميع طلبات API مصادقة صالحة باستخدام رمز Bearer. ضمّن مفتاح API في ترويسة Authorization لكل طلب.

طريقة المصادقة

استخدم مصادقة HTTP Bearer عبر تضمين بيانات اعتماد API في ترويسة Authorization:

Authorization: Bearer <your-api-key>

مثال تنسيق مفتاح API

Authorization: Bearer dk-1234567890abcdef

مثال للطلب

curl -X POST "https://api.defapi.org/api/image/gen" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key-here" \
  -d '{
    "model": "google/gempix2",
    "prompt": "A beautiful landscape"
  }'

مصادقة صالحة

✅ بيانات اعتماد API لم تنتهِ صلاحيتها
✅ تسجيل الحساب بحالة جيدة
✅ رصيد الحساب كافٍ

مشاكل شائعة

❌ بيانات اعتماد API مفقودة في الطلب
❌ مفتاح API غير صالح أو بتنسيق خاطئ
❌ تم تعطيل الحساب أو إلغاء صلاحية الوصول

توليد الصور عبر Nano Banana Pro API

إنشاء صور باستخدام Nano Banana Pro API بتقنيات تعلم آلي متقدمة ونص الموجه المرن مع صور مرجعية.

نقطة نهاية API

POST /api/image/gen

معلمات الطلب

Parameter	Type	Required	Description
model	string	Yes	Model identifier (e.g., "google/gempix2")
prompt	string	Yes	Text prompt describing the image
images	array	No	Reference image URLs (max 4)
callback_url	string	No	Webhook URL for completion notifications

أمثلة الاستخدام

مثال أساسي لإنشاء صور بـ Nano Banana Pro API

{
  "model": "google/gempix2",
  "prompt": "A beautiful girl dancing in a garden"
}

توليد مرجعي مع صور نموذجية - Nano Banana Pro API

{
  "model": "google/gempix2",
  "prompt": "Put them in a basket",
  "images": [
    "https://cdn.openai.com/API/docs/images/body-lotion.png",
    "https://cdn.openai.com/API/docs/images/soap.png"
  ],
  "callback_url": "https://example.com/webhook/image-callback"
}

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

{
  "code": 0,
  "message": "ok",
  "data": {
    "task_id": "ta12345678-1234-1234-1234-123456789abc"
  }
}

التعامل مع الأخطاء

400 - Bad Request

{"code": 1, "message": "failed", "detail": "prompt is required"}

401 - Unauthorized

{"code": 1, "message": "Invalid API key"}

حالة مهمة Nano Banana Pro API

استعلام عن حالة ونتائج مهام توليد الصور في Nano Banana Pro API باستخدام معرف المهمة.

نقطة نهاية API

GET /api/task/query?task_id=<task_id>

معلمات الاستعلام

Parameter	Type	Required	Description
task_id	string	Yes	Unique task identifier returned from generation endpoint

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

curl -X GET "https://api.defapi.org/api/task/query?task_id=ta823dfb-eaac-44fd-aec2-3e2c7ba8e071" \
  -H "Authorization: Bearer your-api-key-here"

أنواع حالات مهام Nano Banana Pro API

pending - تم إنشاء مهمة Nano Banana Pro API وتنتظر بدء المعالجة

submitted - وُضعت المهمة في طابور التنفيذ

in_progress - المهمة قيد المعالجة

success - اكتملت المهمة بنجاح والصور المولدة جاهزة

failed - واجهت المهمة خطأ ولم تكتمل

استجابات الخطأ

404 - Task Not Found

{"code": 1, "message": "task not found"}

401 - Unauthorized

{"code": 401, "message": "Invalid API key"}

هياكل بيانات Nano Banana Pro API

مرجع كامل لصيغ وهياكل بيانات Nano Banana Pro API المستخدمة في الطلبات والاستجابات.

ImageGenResult

Represents a generated image result.

{
  "image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
}

Field	Type	Description
image	string	Image URL or base64 data URI

CallbackPayload

Payload sent to the callback_url when task status changes to final states.

{
  "result": [
    {
      "image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
    }
  ],
  "status": "success",
  "task_id": "ta5c9705-b8ae-4cb9-aa6f-97c4fee88c8d",
  "consumed": "0.500000",
  "status_reason": {
    "message": null
  }
}

Field	Type	Description
result	array	Array of ImageGenResult objects (null if failed)
status	string	Final task status (success/failed)
task_id	string	Unique task identifier
consumed	string	Credits consumed by the task
status_reason	object	Status details including error message if failed

النماذج المدعومة في Nano Banana Pro API

google/gempix2Nano Banana image generation model

google/gemini-2.5-flash-imageGemini 2.5 Flash image model

إدارة الأخطاء

دليل كامل للتعامل مع الأخطاء وتفسير رموز استجابة API. جميع رسائل الخطأ لها صيغة موحدة لتسهيل الاستكشاف والإصلاح.

رموز حالة HTTP

200

OK

Request was successful

400

Bad Request

Invalid request parameters or malformed JSON

401

Unauthorized

Invalid, missing, or expired API key

404

Not Found

Task not found or endpoint doesn't exist

500

Internal Server Error

Server-side error occurred

أفضل ممارسات التعامل مع الأخطاء

تحقق دائماً من رموز حالة HTTP قبل معالجة بيانات الاستجابة
طبق استراتيجية تراجع أُسِّي لإعادة المحاولة عند مواجهة أخطاء 500
سجِّل رسائل الخطأ مع السياق الكامل لتسهيل التصحيح
تحقق من صحة المعلمات قبل الإرسال لتجنب أخطاء 400
حل مشاكل المصادقة بطلب من العملاء لتحديث بيانات اعتماد API
راقب تقدم المهام بفواصل زمنية مناسبة بدل الاستعلام المفرط عن الحالة
استخدم إشعارات webhook عند الإمكان لتجنب الاستعلام المستمر عن إتمام المهام

مثال معالجة الأخطاء (JavaScript)

async function generateImage(prompt, apiKey) {
  try {
    const response = await fetch('https://api.defapi.org/api/image/gen', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${apiKey}`
      },
      body: JSON.stringify({
        model: 'google/gempix2',
        prompt: prompt
      })
    });

    if (!response.ok) {
      const errorData = await response.json();
      throw new Error(`API Error ${response.status}: ${errorData.message}`);
    }

    const data = await response.json();
    return data.data.task_id;

  } catch (error) {
    console.error('Image generation failed:', error.message);
    throw error;
  }
}