دليل نانو بانانا 2 التقني لواجهة برمجة التطبيقات

وثائق تقنية متعمقة لخدمة الإنتاج المرئي نانو بانانا 2 باستخدام قدرات الذكاء الاصطناعي المتطورة

عرض الأسعاراستكشف خيارات الاشتراك في نانو بانانا 2

مقدمة API نانو بانانا 2

يمكّن API الإنتاج المرئي لنانو بانانا 2 من التكامل مع أنظمة الذكاء الاصطناعي المتطورة لإنشاء مرئيات عالية الجودة من الأوصاف النصية والرسوم التوضيحية. تقدم منصة نانو بانانا 2 هيكل REST بسيط مع إمكانيات واسعة لتنسيق المهام والإشعارات.

القدرات الأساسية لنانو بانانا 2

• تحويل نانو بانانا 2 من النص إلى المرئيات باستخدام أنظمة الذكاء الاصطناعي المتقدمة
• توافق نانو بانانا 2 مع الرسوم التوضيحية (حد أقصى 4 صور)
• تنفيذ مهام نانو بانانا 2 غير المحظورة مع مراقبة التقدم
• تكامل نانو بانانا 2 مع webhook للحصول على تحديثات فورية للحالة
• هيكل REST لنانو بانانا 2 الذي يقدم استجابات بتنسيق JSON
• نظام التحقق من بيانات اعتماد Bearer لنانو بانانا 2

overview.base_url

https://api.defapi.org

overview.api_version

v1.0.0

دليل تطبيق نانو بانانا 2

1. سجل للحصول على بيانات اعتماد API نانو بانانا 2 من خلال منصتنا الرئيسية
2. ضمّن رمز الوصول لنانو بانانا 2 في معامل Authorization
3. أرسل طلب POST إلى محطة إنشاء المرئيات لنانو بانانا 2
4. استخدم معرف المهمة المقدم من نانو بانانا 2 للتحقق من الحالة
5. احصل على المرئيات المنتجة من نانو بانانا 2 عند اكتمال المهمة

التحقق من الهوية

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

طريقة التحقق

نفذ التحقق من رمز HTTP Bearer من خلال تضمين بيانات الوصول الخاصة بك في معامل Authorization:

Authorization: Bearer <your-api-key>

هيكل مفتاح الوصول النموذجي

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"
  }'

التحقق الناجح

✅ بيانات الوصول محدثة
✅ تسجيل العميل يحتفظ بالحالة النشطة
✅ رصيد الخدمة الكافي متوفر

المشاكل الشائعة

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

واجهة إنتاج الصور Nano Banana 2

إنشاء الصور باستخدام Nano Banana 2 مع أنظمة ذكاء اصطناعي متطورة وتعليمات نصية قابلة للتخصيص بالإضافة إلى صور مرجعية.

نقطة الاتصال

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 2 الأساسي

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

إنتاج Nano Banana 2 المعتمد على المرجع مع رسوم عينة

{
  "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 2

تحقق من تقدم ونتائج مهام الإنتاج المرئي لـ Nano Banana 2 باستخدام معرف المهمة المقدم من طرف إنشاء الصور في Nano Banana 2.

طرف الاتصال

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 2

pending - اكتمل تهيئة مهمة Nano Banana 2 في انتظار بدء المعالجة

submitted - دخلت مهمة Nano Banana 2 في تسلسل الإنتاج

in_progress - مهمة Nano Banana 2 قيد المعالجة النشطة حاليًا

success - اكتملت مهمة Nano Banana 2 بنجاح مع إنتاج الصور

failed - توقفت مهمة Nano Banana 2 بسبب مضاعفات تقنية

استجابات المشاكل

404 - Task Not Found

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

401 - Unauthorized

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

هياكل معلومات Nano Banana 2

وثائق شاملة لجميع تكوينات وقوالب معلومات Nano Banana 2 المستخدمة في جميع اتصالات وطلبات واجهة برمجة التطبيقات.

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 2 المدعومة

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;
  }
}