مفاهيم المنتج ونمط الحياة
أنشئ مشاهد مرتبطة بالمنتج من الموجّهات أو عدّل صورة منتج واحدة لمعالجات بصرية بديلة.
Nano Banana API. إنشاء الصور وتحريرها.
أدخِل إنشاء صور Nano Banana وتحريرها إلى منتجك عبر Topview API. أنشئ صورًا بخمس نِسب مدعومة، وحرّر صورة إدخال واحدة، واستخدم تسعيرًا واضحًا لكل صورة دون مستوى دقة قابل للاختيار.
أقل من السعر الرسمي5 نِسب للعرض إلى الارتفاعحجم إخراج قياسي واحدتحرير صورة واحدة واحدة
جرّب Nano Banana API مجانًا
الإعدادات
Text to Image
الإعدادات هنا معاينة. يقوم Generate بنسخ الموجه وفتح Platform Playground المطابق حيث تؤكد الإعدادات النهائية.
مواصفات النموذج
تعرّف على الإعدادات قبل البناء.
مرجع سريع لإعدادات Nano Banana المدرجة في مستندات Topview API Platform. لكل وضع متطلبات إدخال خاصة به.
| المعلمة | القيمة |
|---|---|
| المزوّد / النموذج | Google / Nano Banana |
| مسار API | google/nano-banana |
| أوضاع الإنشاء | Text to Image · Image Editing |
| الدقة | Standard output (no resolution parameter) |
| نِسب العرض إلى الارتفاع | 1:1 · 16:9 · 9:16 · 4:3 · 3:4 |
| مدخلات Image Editing | 1 image |
| طول الموجه | Up to 4,000 characters |
| نمط المهمة | Async submission + polling + output retrieval |
| الأسعار | Per generated image; settlement follows actual usage |
بدء سريع للمطورين
من مفتاح API إلى صورتك الأولى.
أرسل تنبؤًا غير متزامن بمفتاح API الخاص بـ Platform، ثم استعلم عن معرّف المهمة المُعاد لاسترداد المخرجات.
# Set TOPVIEW_API_PLATFORM_KEY once. Preserve REQUEST_KEY and input for uncertain retries.
# For a NEW task only, unset REQUEST_KEY first. Save data.id to resume GET only.
: "${TOPVIEW_API_PLATFORM_KEY:?Set TOPVIEW_API_PLATFORM_KEY first}"
export REQUEST_KEY="${REQUEST_KEY:-$(uuidgen)}"
curl --fail-with-body 'https://platform-backend.topview.ai/api/v1/models/google/nano-banana/text-to-image/predictions' \
-H "Authorization: Bearer $TOPVIEW_API_PLATFORM_KEY" \
-H "Idempotency-Key: $REQUEST_KEY" \
-H 'Content-Type: application/json' \
--data '{
"prompt": "A blue ceramic cup on a wooden table",
"aspect_ratio": "1:1"
}'
# Poll data.id until completed or failed.
curl --fail-with-body 'https://platform-backend.topview.ai/api/v1/predictions/REQUEST_ID' \
-H "Authorization: Bearer $TOPVIEW_API_PLATFORM_KEY"يتوافق المثال مع طلب text-to-image لـ Nano Banana في مستندات Platform. احتفظ بـ TOPVIEW_API_PLATFORM_KEY على الخادم فقط.
الخطوة 1
احصل على مفتاح API
سجّل الدخول إلى Topview API Platform وأنشئ مفتاح API بأذونات النموذج المطلوبة. احفظ مفتاحك بأمان واستخدمه لمصادقة طلبات API.
الخطوة 2
أنشئ صورة أو حرّرها
أرسل موجّهًا نصيًا أو ارفع صورًا مرجعية للتحرير. اضبط إعدادات الصورة المدعومة، وأرسل طلب API، واحفظ معرّف المهمة المُعاد.
الخطوة 3
استرجع صورتك
تحقق من حالة المهمة حتى يكتمل الإنشاء. استرجع عناوين URL للصور، وراجع تكلفة الاستخدام النهائية، واحفظ الصور المُنشأة.
مبني لسير عمل الإنتاج
أضِف إنشاء الصور وتحريرها البسيط إلى تطبيقات يومية
تدعم واجهة Nano Banana API الأصلية مهام إنشاء الصور الشائعة بحجم إخراج قياسي واحد ومجموعة مركّزة من عناصر التحكم في التحرير بالمرجع.
رسومات اجتماعية بخمس نِسب
أنشئ مفاهيم مربعة أو أفقية أو عمودية عبر النِّسب الخمس المدعومة، بما في ذلك 4:3 و3:4.
تعديلات إبداعية لصورة واحدةة
اسمح للمستخدمين بإعادة تصميم صورة أو تغيير محيطها أو استكشاف تركيبات جديدة باستخدام إدخال تحرير واحد.
ميزات صور للمبتدئين
أضِف إنشاء text-to-image الأساسي وتحرير صورة واحدة إلى أدوات المبدعين أو سير العمل الداخلي أو تطبيقات التسويق الصغيرة.
لماذا TOPVIEW API
نقطة دخول بسيطة إلى Nano Banana API الأصلي
توفر Topview الأوضاع وخيارات التنسيق الموثَّقة للفرق التي تريد النموذج الأصلي بدلًا من متغير Nano Banana أحدث.
نموذج تسعير بالحجم القياسي
راجع السعر الحالي لكل صورة دون إضافة محددات دقة 2K أو 4K غير المدعومة.
خمس نِسب مدعومة للعرض إلى الارتفاع
اختبر 1:1 و16:9 و9:16 و4:3 و3:4 قبل تعيين إعدادات إخراج منتجك.
اختبر تحرير صورة واحدةة
استكشف تعديلات قائمة على الموجّه بصورة مصدر واحدة عبر مسار التحرير المخصص ومتطلبات الإدخال الموثَّقة.
قارن عائلة Nano Banana
استخدم مساحة عمل Topview واحدة لتقييم النموذج الأصلي مقابل Lite و2 و2.1 مع تغيّر احتياجات الإخراج والتحرير.
أسئلة شائعة حول Nano Banana API
يمكنك فتح Nano Banana Playground لاستكشاف إعداداته. يُدفع استخدام API من رصيد USD على Platform، وتختلف أرصدة الترويج بمرور الوقت. تحقق من أهلية مساحة العمل ورصيدها الحاليين على Topview API Platform.
تُدرج Topview API Platform وضعي Text to Image وImage Editing. يقبل Image Editing صورة إدخال واحدة مع الموجه.
يدعم Nano Banana نِسب 1:1 و16:9 و9:16 و4:3 و3:4. لا توجد معلمة دقة؛ يعيد كل طلب حجم إخراج قياسيًا واحدًا.
يقدّم Nano Banana وNano Banana 2 Lite تسعيرًا بسيطًا لكل صورة دون محدد دقة. اختر وفق النِّسب المدعومة ومدخلات التحرير والسعر الحالي. لإخراج 2K أو 4K قابل للاختيار، قارن Nano Banana 2 وNano Banana 2.1.
أنشئ مفتاح API لـ Platform، وأرسل prediction إلى نقطة نهاية Nano Banana مع Idempotency-Key، واحفظ معرّف المهمة المُعاد واستعلم حتى يكتمل. ثم نزّل الصور بسرعة لأن عناوين URL للنتائج قد تنتهي. احتفظ بالمفتاح على الخادم.
استكشف واجهات API ذات الصلة
المزيد من نماذج الصور AI، وجهة واحدة.
صورتك التالية تبدأ هنا
ابنِ باستخدام Nano Banana API
جرّب موجّهك الأول في Playground، أو قارن الأسعار الحالية، أو اتبع المستندات لدمج Nano Banana في تطبيقك.