مسارات عمل Nano Banana 2.1

شغّل Nano Banana 2.1 عبر واجهة Google Cloud للصور

يمكن لسكريبت محلي إرسال طلب مباشر إلى Google Cloud. أبقِ المصادقة واختيار النموذج وإعدادات الصور ومعالجة النتائج واضحة حتى لا تتحول استجابة صور فاشلة بصمت إلى تصدير ناجح.

ما الذي ستنشئه

طلب SDK مباشر وقائمة مراجعة لمشروع Google Cloud تتحكم به. وهذا ليس وصولًا إلى LlamaGen API عام.

أنشئ باستخدام Nano Banana 2.1

يتطلب Nano Banana 2.1 خطة LlamaGen مدفوعة. راجع تكلفة الأرصدة الحالية وخيارات التصدير قبل التوليد. ويتم احتساب فواتير Google Cloud API المباشرة بشكل منفصل. الخطط والأرصدة

مرئية مكتملة مولدة بالذكاء الاصطناعي معروضة في سياق إبداعي يومي.
مفهوم عرض بالذكاء الاصطناعي: مرئية مكتملة معروضة أثناء الاستخدام. هذا المشهد منفصل عن مخرجات النموذج المباشرة أدناه.

الصورة الرئيسية هي مفهوم عرض مُولَّد بالذكاء الاصطناعي يوضح النتيجة النهائية في سياقها. وهي ليست صورة عميل، ولا لقطة شاشة لتطبيق، ولا اختبارًا مستقلًا لأداء النموذج.

موارد LlamaGen التحريرية

تمت مراجعة المحتوى:

افحص مثالًا مُولّدًا

المثال أدناه هو مخرجات مباشرة من النموذج ضمن مسار التوليد الموثّق لدينا. راجع الصورة الفعلية بدلًا من افتراض أن النموذج التزم بكل التعليمات.

الصور المرجعية المستخدمة في مسار التوليد

هذه أصول مرجعية خيالية ومملوكة لنا. ووجودها لا يضمن تطابق الهوية أو تفاصيل المنتج بشكل دقيق في المخرجات.

مخرجات توليد الصور المباشرة من Nano Banana 2.1 لمسار العمل الموضح في هذه الصفحة.
مخرجات مباشرة من Nano Banana 2.1 ضمن مسار العمل الموثق. افحص الصورة وفق نقاط التحقق الموضحة في هذا الدليل.

أعِدّ وصولك الخاص إلى Google Cloud

تسمي وثائق Google الحالية المنصة Gemini Enterprise Agent Platform؛ ولا يزال كثير من المطورين يبحثون عنها باسمها السابق Vertex AI. يتبع المثال هنا الإصدار @google/genai 1.45.0، وهو الإصدار المثبّت في مسار التوليد المحلي لدينا، باستخدام vertexai: true. قد تعيد إصدارات SDK الأحدث تسمية بعض الخيارات؛ فاتبع وثائق الإصدار المثبّت لديك.

استخدم مشروعًا مفعّلًا عليه الدفع، مع تفعيل الخدمة المطلوبة وتفويض بيانات الاعتماد لهذا الطلب. احتفظ بملفات service-account ورموز الوصول خارج الشيفرة ومحتوى الصفحة وبرومبتات الصور. رسوم Cloud API منفصلة عن أي خطة من LlamaGen.

  • استخدم معرّف النموذج الدقيق gemini-nano-banana-2.1.
  • استخدم الموقع global الموثق لهذا النموذج.
  • اتبع تعليمات Google الخاصة بالمصادقة وإعداد المشروع لبيئتك.

أرسل الإعدادات التي تدعمها هذه النقطة النهائية

لهذا النموذج على Cloud، الأحجام الموثقة للمخرجات هي 1K و2K و4K. وتذكر صفحة النموذج الحالية في Cloud حدًا أقصى يبلغ 14 صورة إدخال لكل برومبت، وحدًّا قدره 7 MB لكل ملف لبيانات الصور المضمّنة؛ وتملك مدخلات Cloud Storage حدًا مختلفًا. هذه حدود خاصة بالنقطة النهائية، وليست وعدًا بأن كل توليفة ستكون ملخصًا إبداعيًا جيدًا.

تذكر وثائق Cloud صراحةً أن seed وtemperature وtopP وtopK وlogprobs غير مدعومة في Nano Banana 2.1. لا تنسخ هذه الإعدادات من مثال توليد نصي، ولا تصف seed كعنصر تحكم في قابلية إعادة الإنتاج لهذا النموذج.

  • اجعل البرومبت ومجموعة مرجعية صغيرة وذات صلة سهلة الفحص.
  • استخدم نوع MIME المطابق للبايتات الفعلية للمدخل.
  • سجّل النموذج وإعدادات المخرجات وبصمات المراجع مع نتيجتك الخاصة.

تحقق من وجود صورة مُعادة فعليًا

افحص أجزاء الاستجابة للتأكد من وجود بيانات صورة مضمنة قبل كتابة ملف مخرجات. يجب التعامل مع استجابة نصية أو نتيجة مفلترة أو استجابة من دون صورة كحالة تحتاج إلى فحص، لا كتوليد مكتمل.

لا تعِد المحاولة بشكل أعمى. احفظ بيانات وصفية غير حساسة عن الطلب وحالة الاستجابة، وتحقق من الحدود الموثقة، وابحث في السبب المعاد. إذا أعدت المحاولة بعد فشل غير واضح، فافهم أولًا سلوك الفوترة الحالي لدى مزودك.

  • لا تسجل بيانات الاعتماد أو صور الإدخال الخاصة كاملة.
  • حافظ على نوع MIME الخاص بالصورة المعادة عند اختيار امتداد الملف.
  • تعامل مع الصورة المعادة على أنها مرشحة لا تزال تحتاج إلى مراجعة بصرية.

افصل العناصر المتحركة

تصف هذه الفحوصات مسار Google Cloud المباشر. وهي لا تمنح وصولًا إلى API ولا تحل محل وثائق الإعداد الحالية من Google.

جزء من الطلباستخدم أو تحقّق منتجنّب الافتراض
المصادقةمشروع Google Cloud المصرح لك باستخدامه وبيانات اعتمادكأن اشتراك LlamaGen يتيح المصادقة على طلب Cloud API
النموذج والموقعgemini-nano-banana-2.1 في globalأن الاسم المستعار المشابه للنموذج يختار النموذج نفسه
إعدادات الصورنسبة الأبعاد المدعومة، وحجم المخرج، وصيغة المرجعأن seed أو معاملات العيّنة الخاصة بنموذج النص مدعومة
الاستجابةبايتات الصورة الفعلية، ونوع MIME، ونتيجة قابلة للمراجعةأن كل استجابة HTTP ناجحة تتضمن صورة قابلة للنشر

مسار عمل عملي

من طلب صغير إلى ملف قابل للمراجعة

ابدأ بطلب صورة أصلية واحد وغير معقد. يتبع المثال أدناه البنية المباشرة لـ SDK المستخدمة في مسار التوليد المحلي لدينا؛ استبدل بيئة المشروع وصادِق عبر إعدادك المعتمد الخاص.

برومبت بداية يمكنك تعديله

أنشئ ساعي توصيل مرسومًا أصيلًا يحمل فانوسًا في شارع ممطر. استخدم silhouette واضحة ومشهدًا مقروءًا. لا تضف نصًا أو شعارات.

هذا الملخص وصفة قابلة للتعديل، وليس سجل الطلب الحرفي للمخرجات المعروضة. ولا يَعِد بنتائج مطابقة أو بنجاح أول توليد. ويحافظ سجل التوليد على الطلب الأصلي.

جرّب المسار

  1. أعدّ بيانات الاعتماد ومشروعك خارج ملف المصدر.
  2. نفّذ طلبًا صغيرًا بإعدادات صور مدعومة.
  3. افحص أجزاء الصورة المعادة، واحفظها بنوع MIME الصحيح، وراجع الملف الفعلي.

ما الذي يجب فحصه

  • هل عادت جزء صورة فعلًا؟
  • هل يفتح الملف المحفوظ بشكل صحيح؟
  • هل تتوافق المرئية مع الملخص بما يكفي للاعتماد عليها؟

مثال مباشر على Google Cloud SDK

هذا طلب مباشر إلى Google Cloud باستخدام مشروعك وبيانات الاعتماد الخاصة بك. وهذا ليس نقطة نهاية عامة لـ LlamaGen API. لا تلصق المفاتيح الخاصة في برومبت أو صفحة عامة.

import { GoogleGenAI } from "@google/genai";
import { writeFile } from "node:fs/promises";

// @google/genai 1.45.0, matching the documented local workflow.
// Authenticate outside this file using Google Cloud credentials.
const ai = new GoogleGenAI({
  vertexai: true,
  project: process.env.GOOGLE_CLOUD_PROJECT,
  location: "global",
  httpOptions: { apiVersion: "v1" },
});
const response = await ai.models.generateContent({
  model: "gemini-nano-banana-2.1",
  contents: [{ role: "user", parts: [{
    text: "Create an original illustrated courier carrying a lantern in a rainy street. No text or logos.",
  }] }],
  config: {
    responseModalities: ["IMAGE"],
    candidateCount: 1,
    imageConfig: { aspectRatio: "3:2", imageSize: "2K" },
    thinkingConfig: { thinkingLevel: "HIGH" },
  },
});
const image = response.candidates?.[0]?.content?.parts?.find(
  (part) => part.inlineData?.data,
)?.inlineData;
if (!image?.data) throw new Error("No image returned; inspect the response before retrying.");
const extensions = { "image/png": "png", "image/jpeg": "jpg", "image/webp": "webp" };
const extension = extensions[image.mimeType];
if (!extension) throw new Error("Inspect the returned MIME type before saving.");
await writeFile(`nano-banana-2-1.${extension}`, Buffer.from(image.data, "base64"));

أسئلة قبل أن تبدأ

هل هذا LlamaGen API عام؟

لا. يستخدم الكود Google’s SDK للاتصال بـ Google Cloud مباشرةً عبر مشروعك وبيانات اعتمادك. صفحة نموذج LlamaGen هي إدخال منفصل في المنتج.

هل يمكنني ضبط seed أو temperature؟

توضح وثائق نموذج Cloud الحالية أن seed وtemperature وtopP وtopK وlogprobs غير مدعومة في Nano Banana 2.1. راجع وثائق نقطة النهاية المحددة قبل إضافة أي معلمات طلب.

هل يعني ردّ بلا صورة أن عليّ إعادة المحاولة فورًا؟

افحص الرد وإرشادات المزوّد الحالية أولًا. قد تؤدي المرشحات والقيود والأعطال المؤقتة إلى نتائج مختلفة. هذا الدليل لا يَعِد بأن إعادة المحاولة ستنجح أو ستكون مجانية.