واجهة Nano Banana البرمجية وMCP: كيف تضيف توليد الصور إلى مشروعك

Nano Banana عائلة من نماذج توليد الصور. تتوفر على NeuralSpace النماذج: Nano Banana, Nano Banana Pro, Nano Banana 2, Nano Banana 2 Lite. تعمل جميعها عبر واجهة برمجية عامة واحدة، وهناك خادم MCP جاهز لوكلاء الذكاء الاصطناعي. يُصدر المفتاح من صفحة مفاتيح API.

ماذا يستطيع Nano Banana فعله؟

تولّد Nano Banana صوراً من وصف نصي. النسخة الأساسية تخرج بدقة 1K، وتدعم Pro و2 دقات 1K و2K و4K، أما 2 Lite فهي نسخة خفيفة بإخراج 1K. تدعم النماذج التحرير والمراجع عبر معامل image_urls.

نقطة النهاية

يُرسل الطلب إلى POST /v1/images/generations. مثال: {"model": "nano-banana-2", "prompt": "قطة على حافة النافذة", "resolution": "1K"}. التفويض عبر مفتاح API في ترويسة x-api-key. معرّفات النماذج المتاحة: nano-banana, nano-banana-pro, nano-banana-2, nano-banana-2-lite.

أدوات MCP

يتوفر خادم MCP الخاص بـNeuralSpace على POST /mcp (Streamable HTTP). للعمل مع Nano Banana يستخدم الوكيل الأدوات: generate_image, list_models, get_balance. يتيح ذلك لـClaude Code وCursor وغيرها من عملاء MCP استخدام نماذج الموقع مباشرة.

كيف تربط

سجّل في NeuralSpace، وافتح صفحة مفاتيح API وأنشئ مفتاحاً بصيغة nsk-…. ثم مرّره في ترويسة الطلب أو في إعدادات عميل MCP. التوثيق الكامل على صفحة /v1/docs.

أسئلة شائعة

ما الدقات المتاحة؟

الأساسية وLite تخرجان 1K، وPro و2 تدعمان 1K و2K و4K.

هل يمكن تحرير الصورة؟

نعم، عبر تمرير الصور الأصلية بمعامل image_urls.

كم تكلف التوليدة؟

يعتمد السعر على النموذج والدقة، والمبلغ الدقيق في التوثيق.