تولید تصویر نانو موز

قبل از نوشتن حتی یک خط کد، از شما خواسته می‌شود تا نمونه‌های اولیه برنامه‌های کاملاً کاربردی و با رابط کاربری کامل را بسازید و ببینید که Nano Banana 2 چگونه با ابزارها، داده‌ها و اکوسیستم Gemini در دنیای واقعی ادغام شده است.
  • یا از روی دستورالعمل‌ها، خودتان بسازید:
    • مجلهلندنبازیابیموزکافهمقالهسگایزومتریک
    • مجله
      تولید شده توسط نانو موز ۲
      نکته: «عکسی از جلد یک مجله براق، روی جلد آبی مینیمال، کلمات بزرگ و پررنگ Nano Banana نوشته شده است. متن با فونت serif نوشته شده و تمام صفحه را پر کرده است. هیچ متن دیگری وجود ندارد. جلوی متن، پرتره‌ای از شخصی با لباسی شیک و مینیمال وجود دارد. او با حالتی بازیگوشانه عدد ۲ را که نقطه کانونی است، در دست گرفته است.
      شماره شماره و تاریخ «فوریه ۲۰۲۶» را به همراه یک بارکد در گوشه قرار دهید. مجله روی قفسه‌ای روبروی دیوار گچ‌کاری شده نارنجی، در یک فروشگاه طراحان مد است.
    • لندن
      تولید شده توسط نانو موز پرو
      پیشنهاد: «یک صحنه کارتونی سه بعدی مینیاتوری ایزومتریک با زاویه دید ۴۵ درجه از بالا به پایین از لندن را به تصویر بکشید که شامل نمادین‌ترین بناهای تاریخی و عناصر معماری آن باشد. از بافت‌های نرم و اصلاح‌شده با مواد PBR واقع‌گرایانه و نورپردازی و سایه‌های ملایم و زنده استفاده کنید. شرایط آب و هوایی فعلی را مستقیماً در محیط شهر ادغام کنید تا یک حال و هوای جوی فراگیر ایجاد کنید. از یک ترکیب‌بندی تمیز و مینیمالیستی با پس‌زمینه‌ای نرم و تک‌رنگ استفاده کنید. در مرکز بالا، عنوان «لندن» را با متن بزرگ و پررنگ، یک نماد آب و هوای برجسته در زیر آن، سپس تاریخ (متن کوچک) و دما (متن متوسط) قرار دهید. تمام متن باید با فاصله ثابت در مرکز قرار گیرد و می‌تواند به طور نامحسوسی با بالای ساختمان‌ها همپوشانی داشته باشد.»
    • کتزال
      تولید شده توسط نانو موز ۲
      پیشنهاد: «از جستجوی تصویر برای یافتن تصاویر دقیق از یک پرنده‌ی باشکوه quetzal استفاده کنید. یک تصویر زمینه‌ی زیبا با نسبت تصویر ۳:۲ از این پرنده، با یک گرادیان طبیعی از بالا به پایین و ترکیب‌بندی مینیمال، ایجاد کنید.»
    • موز
      تولید شده توسط نانو موز پرو
      پیشنهاد: «این لوگو را روی یک تبلیغ گران‌قیمت برای یک عطر با رایحه موز قرار دهید. لوگو کاملاً با بطری ادغام شده است.»
    • کافه
      تولید شده توسط نانو موز پرو
      پیشنهاد: «عکسی از یک صحنه روزمره در یک کافه شلوغ که صبحانه سرو می‌کند. در پیش‌زمینه یک مرد انیمه‌ای با موهای آبی دیده می‌شود، یکی از افراد یک طرح مدادی است و دیگری یک هنرمند خمیربازی است.»
    • مقاله
      تولید شده توسط نانو موز پرو
      درخواست: «از جستجو برای یافتن بازخوردهای مربوط به عرضه Gemini 3 Flash استفاده کنید. از این اطلاعات برای نوشتن یک مقاله کوتاه در مورد آن (همراه با سرتیترها) استفاده کنید. عکسی از مقاله را همانطور که در یک مجله براق با محوریت طراحی منتشر شده است، برگردانید. این عکسی از یک صفحه تا شده است که مقاله مربوط به Gemini 3 Flash را نشان می‌دهد. یک عکس اصلی. تیتر با حروف سریف.
    • سگ
      تولید شده توسط نانو موز پرو
      پیشنهاد: «آیکونی که نمایانگر یک سگ بامزه است. پس‌زمینه سفید است. آیکن‌ها را به سبک سه‌بعدی رنگارنگ و لمسی طراحی کنید. بدون متن.»
    • ایزومتریک
      تولید شده توسط نانو موز ۲
      سوال: «عکسی بگیرید که کاملاً ایزومتریک باشد. این یک عکس مینیاتوری نیست، بلکه عکسی است که اتفاقاً کاملاً ایزومتریک گرفته شده است. این عکسی از یک باغ مدرن زیبا است. یک استخر بزرگ دو شکل وجود دارد و روی آن نوشته شده است: نانو موز ۲.»

    نانو موز نام قابلیت‌های تولید تصویر بومی Gemini است. Gemini می‌تواند تصاویر را به صورت محاوره‌ای با متن، تصاویر یا ترکیبی از هر دو تولید و پردازش کند. این به شما امکان می‌دهد تا با کنترل بی‌سابقه‌ای، تصاویر را ایجاد، ویرایش و تکرار کنید.

    نانو موز به چهار مدل متمایز موجود در Gemini API اشاره دارد:

    • نانو موز ۲ لایت ( تصویر فلش لایت Gemini 3.1 ) ( gemini-3.1-flash-lite-image ): سریع‌ترین و ارزان‌ترین مدل تصویر Gemini ما، که برای سرعت و مقیاس‌پذیری مهندسی شده است، جایی که سرعت و هزینه محدودیت‌های عملیاتی اصلی هستند. برای ورودی‌های مرجع چندگانه یا ویرایش متوالی چند مرحله‌ای بهینه نشده است.
    • نانو موز ۲ ( تصویر فلش Gemini 3.1 ) ( gemini-3.1-flash-image ): به عنوان متنوع‌ترین مدل، مدلی کارآمد و عمومی برای همه کارها عمل می‌کند. این مدل، سرعت را با تولید 4K پیشرفته، دانش جهانی و رندر متن قابل اعتماد متعادل می‌کند. در پردازش تصویر چند مرجع و سازگاری عالی عمل می‌کند.
    • نانو موز پرو ( Gemini 3 Pro Image ) ( gemini-3-pro-image ): انتخابی ممتاز برای پیچیده‌ترین وظایف بصری، با ارائه بالاترین سطح دانش جهانی، بومی‌سازی پیشرفته، ثبات دقیق برند و کنترل خلاقانه دقیق.
    • نانو موز ( تصویر فلش Gemini 2.5 ) ( gemini-2.5-flash-image ): پیشگام قدیمی سری نانو موز. اگرچه این دستگاه یک دستگاه قابل اعتماد بوده است، اما اکیداً توصیه می‌کنیم مشتریان برای تجربه کیفیت بهتر، سرعت تولید بالاتر و قیمت API پایین‌تر، به نانو موز ۲ لایت روی آورند.

    تمام تصاویر تولید شده شامل واترمارک SynthID هستند.

    تولید تصویر (تبدیل متن به تصویر)

    پایتون

    from google import genai
    from PIL import Image
    import base64
    
    client = genai.Client()
    
    interaction = client.interactions.create(
        model="gemini-3.1-flash-image",
        input="Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme",
    )
    
    with open("generated_image.png", "wb") as f:
    
        f.write(base64.b64decode(interaction.output_image.data))
    

    جاوا اسکریپت

    import { GoogleGenAI } from "@google/genai";
    import * as fs from "node:fs";
    
    async function main() {
    
      const ai = new GoogleGenAI({});
    
      const prompt =
        "Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme";
    
      const interaction = await ai.interactions.create({
        model: "gemini-3.1-flash-image",
        input: prompt,
      });
      const generatedImage = interaction.output_image;
      if (generatedImage) {
        const buffer = Buffer.from(generatedImage.data, "base64");
        fs.writeFileSync("gemini-native-image.png", buffer);
        console.log("Image saved as gemini-native-image.png");
      }
    }
    
    main();
    

    استراحت

    curl -s -X POST \
      "https://generativelanguage.googleapis.com/v1beta/interactions" \
      -H "x-goog-api-key: $GEMINI_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "gemini-3.1-flash-image",
        "input": [
          {"type": "text", "text": "Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme"}
        ]
      }'
    

    شما می‌توانید داده‌های تصویر تولید شده را با استفاده از ویژگی interaction.output_image بازیابی کنید، که آخرین بلوک تصویر تولید شده را برمی‌گرداند. برای جزئیات بیشتر در مورد ویژگی‌های مناسب، به نمای کلی Interactions مراجعه کنید.

    ویرایش تصویر (تبدیل متن و تصویر به تصویر)

    یادآوری : مطمئن شوید که از حقوق لازم برای هر تصویری که آپلود می‌کنید، برخوردار هستید. محتوایی تولید نکنید که حقوق دیگران را نقض کند، از جمله ویدیوها یا تصاویری که فریب، آزار یا آسیب می‌رسانند. استفاده شما از این سرویس هوش مصنوعی مولد، تابع سیاست استفاده ممنوعه ما است.

    یک تصویر ارائه دهید و از متن‌های راهنما برای اضافه کردن، حذف کردن یا تغییر عناصر، تغییر سبک یا تنظیم درجه‌بندی رنگ استفاده کنید.

    مثال زیر آپلود تصاویر کدگذاری شده با base64 را نشان می‌دهد. برای تصاویر متعدد، بارهای داده بزرگتر و انواع MIME پشتیبانی شده، صفحه درک تصویر را بررسی کنید.

    پایتون

    from google import genai
    from PIL import Image
    import base64
    
    client = genai.Client()
    
    with open("/path/to/cat_image.png", "rb") as f:
        image_bytes = f.read()
    
    interaction = client.interactions.create(
        model="gemini-3.1-flash-image",
        input=[
            {
              "type": "text",
              "text": "Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme"
            },
            {
                "type": "image",
                "data": base64.b64encode(image_bytes).decode('utf-8'),
                "mime_type": "image/png"
            }
        ],
    )
    
    with open("generated_image.png", "wb") as f:
    
        f.write(base64.b64decode(interaction.output_image.data))
    

    جاوا اسکریپت

    import { GoogleGenAI } from "@google/genai";
    import * as fs from "node:fs";
    
    async function main() {
    
      const ai = new GoogleGenAI({});
    
      const imagePath = "path/to/cat_image.png";
      const imageData = fs.readFileSync(imagePath);
      const base64Image = imageData.toString("base64");
    
      const prompt = [
        { type: "text", text: "Create a picture of my cat eating a nano-banana in a" +
                "fancy restaurant under the Gemini constellation" },
        {
          type: "image",
          mime_type: "image/png",
          data: base64Image
        },
      ];
    
      const interaction = await ai.interactions.create({
        model: "gemini-3.1-flash-image",
        input: prompt,
      });
      const generatedImage = interaction.output_image;
      if (generatedImage) {
        const buffer = Buffer.from(generatedImage.data, "base64");
        fs.writeFileSync("gemini-native-image.png", buffer);
        console.log("Image saved as gemini-native-image.png");
      }
    }
    
    main();
    

    استراحت

    curl -s -X POST \
      "https://generativelanguage.googleapis.com/v1beta/interactions" \
        -H "x-goog-api-key: $GEMINI_API_KEY" \
        -H 'Content-Type: application/json' \
        -d "{
          \"model\": \"gemini-3.1-flash-image\",
          \"input\": [
            {\"type\": \"text\", \"text\": \"Create a picture of my cat eating a nano-banana in a fancy restaurant under the Gemini constellation\"},
            {
              \"type\": \"image\",
              \"mime_type\": \"image/jpeg\",
              \"data\": \"<BASE64_IMAGE_DATA>\"
            }
          ]
        }"
    

    ویرایش تصویر چند مرحله‌ای

    به تولید و ویرایش تصاویر به صورت محاوره‌ای ادامه دهید. مکالمه چند نوبتی روش پیشنهادی برای تکرار روی تصاویر است. مثال زیر درخواستی برای تولید یک اینفوگرافیک در مورد فتوسنتز را نشان می‌دهد.

    پایتون

    from google import genai
    import base64
    
    client = genai.Client()
    
    interaction = client.interactions.create(
        model="gemini-3.1-flash-image",
        input="Create a vibrant infographic that explains photosynthesis as if it were a recipe for a plant's favorite food. Show the \"ingredients\" (sunlight, water, CO2) and the \"finished dish\" (sugar/energy). The style should be like a page from a colorful kids' cookbook, suitable for a 4th grader.",
        tools=[{"type": "google_search"}],
    )
    
    with open("photosynthesis.png", "wb") as f:
    
        f.write(base64.b64decode(interaction.output_image.data))
    

    جاوا اسکریپت

    import { GoogleGenAI } from "@google/genai";
    import * as fs from "node:fs";
    
    const ai = new GoogleGenAI({});
    
    async function main() {
      const interaction = await ai.interactions.create({
        model: "gemini-3.1-flash-image",
        input: "Create a vibrant infographic that explains photosynthesis as if it were a recipe for a plant's favorite food. Show the \"ingredients\" (sunlight, water, CO2) and the \"finished dish\" (sugar/energy). The style should be like a page from a colorful kids' cookbook, suitable for a 4th grader.",
        tools: [{"type": "google_search"}],
      });
    
      const generatedImage = interaction.output_image;
      if (generatedImage) {
        const buffer = Buffer.from(generatedImage.data, "base64");
        fs.writeFileSync("photosynthesis.png", buffer);
        console.log("Image saved as photosynthesis.png");
      }
    }
    
    await main();
    

    استراحت

    curl -s -X POST \
      "https://generativelanguage.googleapis.com/v1beta/interactions" \
      -H "x-goog-api-key: $GEMINI_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "gemini-3.1-flash-image",
        "input": [
          {"type": "text", "text": "Create a vibrant infographic that explains photosynthesis as if it were a recipe for a plants favorite food. Show the \"ingredients\" (sunlight, water, CO2) and the \"finished dish\" (sugar/energy). The style should be like a page from a colorful kids cookbook, suitable for a 4th grader."}
        ],
        "tools": [{"type": "google_search"}]
      }'
    
    اینفوگرافیک تولید شده توسط هوش مصنوعی در مورد فتوسنتز
    اینفوگرافیک تولید شده توسط هوش مصنوعی در مورد فتوسنتز

    سپس می‌توانید از previous_interaction_id برای تغییر زبان روی گرافیک به اسپانیایی استفاده کنید.

    پایتون

    interaction_2 = client.interactions.create(
        model="gemini-3.1-flash-image",
        input="Update this infographic to be in Spanish. Do not change any other elements of the image.",
        previous_interaction_id=interaction.id,
        response_format={
            "type": "image",
            "mime_type": "image/jpeg",
            "aspect_ratio": "16:9",
            "image_size": "2K"
        },
    )
    
    generated_image = interaction_2.output_image
    if generated_image:
        with open("photosynthesis_spanish.png", "wb") as f:
            f.write(base64.b64decode(generated_image.data))
    

    جاوا اسکریپت

    const interaction2 = await ai.interactions.create({
      model: "gemini-3.1-flash-image",
      input: "Update this infographic to be in Spanish. Do not change any other elements of the image.",
      previous_interaction_id: interaction.id,
      response_format: {
        type: "image",
        mime_type: "image/png",
        aspect_ratio: "16:9",
        image_size: "2K"
      },
    });
    
    const generatedImage = interaction2.output_image;
    if (generatedImage) {
      const buffer = Buffer.from(generatedImage.data, "base64");
      fs.writeFileSync("photosynthesis_spanish.png", buffer);
    }
    

    استراحت

    curl -s -X POST \
      "https://generativelanguage.googleapis.com/v1beta/interactions" \
      -H "x-goog-api-key: $GEMINI_API_KEY" \
      -H 'Content-Type: application/json' \
      -d '{
        "model": "gemini-3.1-flash-image",
        "input": "Update this infographic to be in Spanish. Do not change any other elements of the image.",
        "previous_interaction_id": "<PREVIOUS_INTERACTION_ID>",
        "response_format": {
          "type": "image",
          "mime_type": "image/jpeg",
          "aspect_ratio": "16:9",
          "image_size": "2K"
        }
      }'
    
    اینفوگرافیک تولید شده توسط هوش مصنوعی از فتوسنتز به زبان اسپانیایی
    اینفوگرافیک تولید شده توسط هوش مصنوعی از فتوسنتز به زبان اسپانیایی

    جدید با مدل‌های تصویر Gemini 3

    Gemini 3 مدل‌های پیشرفته تولید و ویرایش تصویر را ارائه می‌دهد. Gemini 3.1 Flash Image برای سرعت و موارد استفاده با حجم بالا بهینه شده است و Gemini 3 Pro Image برای تولید دارایی‌های حرفه‌ای بهینه شده است. این نرم‌افزارها که برای مقابله با چالش‌برانگیزترین گردش‌های کاری از طریق استدلال پیشرفته طراحی شده‌اند، در کارهای پیچیده و چند مرحله‌ای ایجاد و اصلاح، برتری دارند.

    • خروجی با وضوح بالا : قابلیت‌های تولید داخلی برای تصاویر 1K، 2K و 4K.
      • تصویر فلش Gemini 3.1 وضوح کوچکتر 512 پیکسل (0.5K) را اضافه می‌کند.
      • نرم‌افزار Gemini 3.1 Flash Lite Image فقط از رزولوشن 1K پشتیبانی می‌کند.
    • رندر متن پیشرفته : قادر به تولید متن خوانا و استایل‌دار برای اینفوگرافیک‌ها، منوها، نمودارها و محتوای بازاریابی است.
    • پایه‌گذاری با جستجوی گوگل : این مدل می‌تواند از جستجوی گوگل به عنوان ابزاری برای تأیید حقایق و تولید تصاویر بر اساس داده‌های بلادرنگ (مثلاً نقشه‌های آب و هوای فعلی، نمودارهای سهام، رویدادهای اخیر) استفاده کند.
      • توسط مدل تصویر Gemini 3.1 Flash Lite پشتیبانی نمی‌شود.
      • نرم‌افزار Gemini 3.1 Flash Image، جستجوی تصویر گوگل (Google Image Search Grounding) را در کنار جستجوی وب اضافه می‌کند.
    • حالت تفکر : این مدل از یک فرآیند «تفکر» برای استدلال از طریق دستورالعمل‌های پیچیده استفاده می‌کند. این مدل «تصاویر فکری» موقت (که در پشت صحنه قابل مشاهده هستند اما شارژ نمی‌شوند) تولید می‌کند تا ترکیب را قبل از تولید خروجی نهایی با کیفیت بالا اصلاح کند.
    • حداکثر ۱۴ تصویر مرجع : اکنون می‌توانید حداکثر ۱۴ تصویر مرجع را برای تولید تصویر نهایی با هم ترکیب کنید.
    • نسبت‌های تصویر جدید : نرم‌افزار Gemini 3.1 Flash Lite Image نسبت‌های تصویر 1:1 ، 3:2 ، 2:3 3:4 ، 4:3 ، 4:5 ، 5:4 ، 9:16 ، 16:9 و 21:9 را اضافه می‌کند.

    استفاده از حداکثر ۱۴ تصویر مرجع

    مدل‌های تصویر Gemini 3 به شما امکان می‌دهند تا ۱۴ تصویر مرجع را با هم ترکیب کنید. این ۱۴ تصویر می‌توانند شامل موارد زیر باشند:

    ایمیج فلش لایت Gemini 3.1 تصویر فلش Gemini 3.1 تصویر Gemini 3 Pro
    حداکثر ۱۴ تصویر از اشیاء با وضوح بالا برای گنجاندن در تصویر نهایی حداکثر ۱۰ تصویر از اشیاء با وضوح بالا برای گنجاندن در تصویر نهایی حداکثر ۶ تصویر از اشیاء با وضوح بالا برای گنجاندن در تصویر نهایی
    ناموجود حداکثر ۴ تصویر از شخصیت‌ها برای حفظ انسجام شخصیت حداکثر ۵ تصویر از شخصیت‌ها برای حفظ انسجام شخصیت
    ناموجود ناموجود حداکثر ۳ تصویر برای استفاده به عنوان مرجع سبک

    پایتون

    from google import genai
    from google.genai import types
    from PIL import Image
    import base64
    
    prompt = "An office group photo of these people, they are making funny faces."
    
    client = genai.Client()
    
    interaction = client.interactions.create(
        model="gemini-3.1-flash-image",
        input=[
            {
                "type": "text",
                "text": prompt,
            },
            {
                "type": "image",
                "data": base64.b64encode(image_bytes).decode('utf-8'),
                "mime_type": "image/png"
            },
            {
                "type": "image",
                "data": base64.b64encode(image_bytes).decode('utf-8'),
                "mime_type": "image/png"
            },
            {
                "type": "image",
                "data": base64.b64encode(image_bytes).decode('utf-8'),
                "mime_type": "image/png"
            },
            {
                "type": "image",
                "data": base64.b64encode(image_bytes).decode('utf-8'),
                "mime_type": "image/png"
            },
            {
                "type": "image",
                "data": base64.b64encode(image_bytes).decode('utf-8'),
                "mime_type": "image/png"
            },
        ],
        response_format={
            "type": "image",
            "aspect_ratio": "5:4",
            "image_size": "2K"
        },
    )
    
    with open("office.png", "wb") as f:
    
        f.write(base64.b64decode(interaction.output_image.data))
    

    جاوا اسکریپت

    import { GoogleGenAI } from "@google/genai";
    import * as fs from "node:fs";
    
    async function main() {
      const ai = new GoogleGenAI({});
    
      const input = [
        {
          type: "text",
          text: "An office group photo of these people, they are making funny faces.",
        },
        { type: "image", mime_type: "image/jpeg", data: base64ImageFile1 },
        { type: "image", mime_type: "image/jpeg", data: base64ImageFile2 },
        { type: "image", mime_type: "image/jpeg", data: base64ImageFile3 },
        { type: "image", mime_type: "image/jpeg", data: base64ImageFile4 },
        { type: "image", mime_type: "image/jpeg", data: base64ImageFile5 },
      ];
    
      const interaction = await ai.interactions.create({
        model: "gemini-3.1-flash-image",
        input: input,
        response_format: {
          type: "image",
          aspect_ratio: "5:4",
          image_size: "2K",
        },
      });
    
      const buffer = Buffer.from(interaction.output_image.data, 'base64');
    
      fs.writeFileSync('office.png', buffer);
    }
    
    main();
    

    استراحت

    curl -s -X POST \
      "https://generativelanguage.googleapis.com/v1beta/interactions" \
        -H "x-goog-api-key: $GEMINI_API_KEY" \
        -H 'Content-Type: application/json' \
        -d "{
          \"model\": \"gemini-3.1-flash-image\",
          \"input\": [
            {\"type\": \"text\", \"text\": \"An office group photo of these people, they are making funny faces.\"},
            {\"type\": \"image\", \"mime_type\": \"image/png\", \"data\": \"<BASE64_DATA_IMG_1>\"},
            {\"type\": \"image\", \"mime_type\": \"image/png\", \"data\": \"<BASE64_DATA_IMG_2>\"},
            {\"type\": \"image\", \"mime_type\": \"image/png\", \"data\": \"<BASE64_DATA_IMG_3>\"},
            {\"type\": \"image\", \"mime_type\": \"image/png\", \"data\": \"<BASE64_DATA_IMG_4>\"},
            {\"type\": \"image\", \"mime_type\": \"image/png\", \"data\": \"<BASE64_DATA_IMG_5>\"}
          ],
          \"response_format\": {
            \"type\": \"image\",
            \"aspect_ratio\": \"5:4\",
            \"image_size\": \"2K\"
          }
        }"
    
    عکس گروهی اداری تولید شده توسط هوش مصنوعی
    عکس گروهی اداری تولید شده توسط هوش مصنوعی

    اتصال به زمین با جستجوی گوگل

    از ابزار جستجوی گوگل برای تولید تصاویر بر اساس اطلاعات لحظه‌ای، مانند پیش‌بینی آب و هوا، نمودار سهام یا رویدادهای اخیر، استفاده کنید.

    توجه داشته باشید که هنگام استفاده از Grounding with Google Search به همراه تولید تصویر، نتایج جستجوی مبتنی بر تصویر به مدل تولید ارسال نمی‌شوند و از پاسخ حذف می‌شوند (به Grounding with Google Image Search مراجعه کنید).

    پایتون

    from google import genai
    from google.genai import types
    import base64
    prompt = "Visualize the current weather forecast for the next 5 days in San Francisco as a clean, modern weather chart. Add a visual on what I should wear each day"
    
    client = genai.Client()
    
    interaction = client.interactions.create(
        model="gemini-3.1-flash-image",
        input=prompt,
        tools=[{"type": "google_search"}],
        response_format={
            "type": "image",
            "mime_type": "image/jpeg",
            "aspect_ratio": "16:9"
        },
    )
    
    with open("weather.png", "wb") as f:
    
        f.write(base64.b64decode(interaction.output_image.data))
    

    جاوا اسکریپت

    import { GoogleGenAI } from "@google/genai";
    import * as fs from "node:fs";
    
    async function main() {
      const ai = new GoogleGenAI({});
    
      const interaction = await ai.interactions.create({
        model: "gemini-3.1-flash-image",
        input: "Visualize the current weather forecast for the next 5 days in San Francisco as a clean, modern weather chart. Add a visual on what I should wear each day",
        tools: [{"type": "google_search"}],
        response_format: {
          type: "image",
          mime_type: "image/png",
          aspect_ratio: "16:9",
          image_size: "2K"
        },
      });
    
      const buffer = Buffer.from(interaction.output_image.data, 'base64');
    
      fs.writeFileSync('weather.png', buffer);
    }
    
    main();
    

    استراحت

    curl -s -X POST \
      "https://generativelanguage.googleapis.com/v1beta/interactions" \
      -H "x-goog-api-key: $GEMINI_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "gemini-3.1-flash-image",
        "input": [
          {"type": "text", "text": "Visualize the current weather forecast for the next 5 days in San Francisco as a clean, modern weather chart. Add a visual on what I should wear each day"}
        ],
        "tools": [{"type": "google_search"}],
        "response_format": {
          "type": "image",
          "mime_type": "image/jpeg",
          "aspect_ratio": "16:9"
        }
      }'
    
    نمودار آب و هوای پنج روزه سانفرانسیسکو که توسط هوش مصنوعی تولید شده است
    نمودار آب و هوای پنج روزه سانفرانسیسکو که توسط هوش مصنوعی تولید شده است

    این پاسخ شامل مراحل google_search_call و google_search_result به همراه حاشیه‌نویسی‌های درون‌خطی url_citation در مرحله متن است:

    • google_search_result : شامل search_suggestions است، یک قطعه کد HTML برای رندر کردن پیشنهادات جستجو در رابط کاربری شما.
    • حاشیه‌نویسی‌های url_citation : ارجاعات درون‌خطی در مرحله متن که بخش‌هایی از پاسخ را به منابع وب آنها پیوند می‌دهد.

    اتصال به زمین با جستجوی تصویر گوگل به مدل‌ها اجازه می‌دهد تا از تصاویر وب بازیابی شده از طریق جستجوی تصویر گوگل به عنوان زمینه بصری برای تولید تصویر استفاده کنند. جستجوی تصویر یک نوع جستجوی جدید در ابزار موجود اتصال به زمین با جستجوی گوگل است که در کنار جستجوی وب استاندارد عمل می‌کند.

    برای فعال کردن جستجوی تصویر، ابزار google_search را در درخواست API خود پیکربندی کنید و image_search در آرایه search_types مشخص کنید. جستجوی تصویر می‌تواند به صورت مستقل یا همراه با جستجوی وب استفاده شود.

    پایتون

    from google import genai
    
    client = genai.Client()
    
    interaction = client.interactions.create(
        model="gemini-3.1-flash-image",
        input="A detailed painting of a Timareta butterfly resting on a flower",
        tools=[{
          "type": "google_search",
          "search_types": ["web_search", "image_search"]
        }]
    )
    

    جاوا اسکریپت

    import { GoogleGenAI } from "@google/genai";
    
    async function main() {
      const ai = new GoogleGenAI({});
    
      const interaction = await ai.interactions.create({
        model: "gemini-3.1-flash-image",
        input: "A detailed painting of a Timareta butterfly resting on a flower",
        tools: [{
          "type": "google_search",
          "search_types": ["web_search", "image_search"]
        }]
      });
    }
    
    main();
    

    استراحت

    curl -s -X POST \
      "https://generativelanguage.googleapis.com/v1beta/interactions" \
      -H "x-goog-api-key: $GEMINI_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "gemini-3.1-flash-image",
        "input": "A detailed painting of a Timareta butterfly resting on a flower",
        "tools": [{"type": "google_search", "search_types": ["web_search", "image_search"]}]
      }'
    

    الزامات نمایش

    وقتی از جستجوی تصویر در Grounding with Google Search استفاده می‌کنید، باید پیشنهادات search_suggestions از مرحله google_search_result نمایش دهید. شرایط کامل استفاده در شرایط خدمات به تفصیل شرح داده شده است.

    پاسخ

    برای پاسخ‌های مستدل با استفاده از جستجوی تصویر، API استنادهای درون‌خطی و فراداده‌های انتساب را به عنوان بخشی از مراحل پاسخ برمی‌گرداند:

    • حاشیه‌نویسی‌های url_citation : ارجاعات درون‌خطی در بلوک محتوای متنی درون model_output ، که محتوای تولید شده را به منبع آن پیوند می‌دهد.

    • google_search_result : شامل search_suggestions است، یک قطعه کد HTML برای رندر کردن پیشنهادات جستجو در رابط کاربری شما.

    تبدیل ویدیو به تصویر (فلش ۳.۱)

    تولید ویدیو به تصویر به شما امکان می‌دهد تصاویر جدیدی را با استفاده از متن یک ویدیو به عنوان یک مرجع چندوجهی تولید کنید. این قابلیت برای ایجاد تصاویر کوچک ویدیویی با کیفیت بالا، پوسترهای سینمایی، اینفوگرافیک‌های خلاصه یا آثار هنری جدید با الهام از صحنه‌های ویدیویی مفید است.

    در طول تولید، مدل، فریم‌های ویدیویی را در متن تجزیه و تحلیل می‌کند تا مضامین بصری و رویدادهای کلیدی را استخراج کند، سپس از آنها در کنار پیام متنی شما برای ترکیب تصویر خروجی استفاده می‌کند.

    شما می‌توانید URL های عمومی یوتیوب را مستقیماً در درخواست API خود ارسال کنید یا فایل‌های ویدیویی محلی را با استفاده از API فایل‌ها آپلود کنید.

    پایتون

    from google import genai
    from google.genai import types
    import base64
    
    client = genai.Client()
    
    interaction = client.interactions.create(
        model="gemini-3.1-flash-image",
        input=[
            {
                "type": "video",
                "uri": "https://www.youtube.com/watch?v=UTdfxFyOQTI",
                "mime_type": "video/mp4"
            },
            {"type": "text", "text": "Generate a poster image that captures the key themes of this video."}
        ],
        response_format={"type": "image", "aspect_ratio": "16:9"}
    )
    
    # Save the generated image part
    for step in interaction.steps:
        if step.type == "model_output":
            for content_block in step.content:
                if content_block.type == "text":
                    print(content_block.text)
                elif content_block.type == "image":
                    with open("video_poster.png", "wb") as f:
                        f.write(base64.b64decode(content_block.data))
                    print("Image saved as video_poster.png")
    

    جاوا اسکریپت

    import { GoogleGenAI } from "@google/genai";
    import * as fs from "node:fs";
    
    async function main() {
      const ai = new GoogleGenAI({});
    
      const interaction = await ai.interactions.create({
        model: "gemini-3.1-flash-image",
        input: [
          {
            type: "video",
            uri: "https://www.youtube.com/watch?v=UTdfxFyOQTI",
            mime_type: "video/mp4"
          },
          { type: "text", text: "Generate a poster image that captures the key themes of this video." }
        ],
        response_format: {
          type: "image",
          aspect_ratio: "16:9"
        }
      });
    
      for (const step of interaction.steps) {
        if (step.type === "model_output") {
          for (const contentBlock of step.content) {
            if (contentBlock.type === "text") {
              console.log(contentBlock.text);
            } else if (contentBlock.type === "image") {
              const buffer = Buffer.from(contentBlock.data, "base64");
              fs.writeFileSync("video_poster.png", buffer);
              console.log("Image saved as video_poster.png");
            }
          }
        }
      }
    }
    
    main();
    

    استراحت

    curl -s -X POST \
      "https://generativelanguage.googleapis.com/v1beta/interactions" \
      -H "x-goog-api-key: $GEMINI_API_KEY" \
      -H 'Content-Type: application/json' \
      -d '{
        "model": "gemini-3.1-flash-image",
        "input": [
          {
            "type": "video",
            "uri": "https://www.youtube.com/watch?v=UTdfxFyOQTI",
            "mime_type": "video/mp4"
          },
          {
            "type": "text",
            "text": "Generate a poster image that captures the key themes of this video."
          }
        ],
        "response_format": {
          "type": "image",
          "aspect_ratio": "16:9"
        }
      }'
    
    اینفوگرافیک تولید شده توسط هوش مصنوعی از یک ویدیوی یوتیوب
    اینفوگرافیک تولید شده توسط هوش مصنوعی از یک ویدیوی یوتیوب

    تولید تصاویر تا وضوح 4K

    مدل‌های تصویر Gemini 3 به طور پیش‌فرض تصاویر ۱K تولید می‌کنند، اما می‌توانند تصاویر ۲K، ۴K و ۵۱۲px (05.K) (فقط تصاویر فلش Gemini 3.1) را نیز خروجی دهند. برای تولید تصاویر با وضوح بالاتر، image_size در response_format مشخص کنید.

    شما باید از حرف بزرگ «K» استفاده کنید (مثلاً 512px (05.K)، 1K، 2K، 4K). پارامترهای با حروف کوچک (مثلاً 1k) پذیرفته نخواهند شد.

    پایتون

    from google import genai
    from google.genai import types
    import base64
    
    prompt = "Da Vinci style anatomical sketch of a dissected Monarch butterfly. Detailed drawings of the head, wings, and legs on textured parchment with notes in English."
    
    client = genai.Client()
    
    interaction = client.interactions.create(
        model="gemini-3.1-flash-image",
        input=prompt,
        response_format={
            "type": "image",
            "mime_type": "image/jpeg",
            "aspect_ratio": "1:1",
            "image_size": "1K"
        },
    )
    
    print(interaction.output_text)
    
    with open("butterfly.png", "wb") as f:
    
        f.write(base64.b64decode(interaction.output_image.data))
    

    جاوا اسکریپت

    import { GoogleGenAI } from "@google/genai";
    import * as fs from "node:fs";
    
    async function main() {
      const ai = new GoogleGenAI({});
    
      const interaction = await ai.interactions.create({
        model: "gemini-3.1-flash-image",
        input: "Da Vinci style anatomical sketch of a dissected Monarch butterfly. Detailed drawings of the head, wings, and legs on textured parchment with notes in English.",
        response_format: {
          type: "image",
          mime_type: "image/png",
          aspect_ratio: "1:1",
          image_size: "1K",
        },
      });
    
      console.log(interaction.output_text);
    
      const buffer = Buffer.from(interaction.output_image.data, 'base64');
    
      fs.writeFileSync('butterfly.png', buffer);
    }
    
    main();
    

    استراحت

    curl -s -X POST \
      "https://generativelanguage.googleapis.com/v1beta/interactions" \
      -H "x-goog-api-key: $GEMINI_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "gemini-3.1-flash-image",
        "input": "Da Vinci style anatomical sketch of a dissected Monarch butterfly. Detailed drawings of the head, wings, and legs on textured parchment with notes in English.",
        "response_format": {
          "type": "image",
          "mime_type": "image/jpeg",
          "aspect_ratio": "1:1",
          "image_size": "1K"
        }
      }'
    

    تصویر زیر نمونه‌ای از تصویری است که از این دستور تولید شده است:

    طرح آناتومیک تشریح شده یک پروانه مونارک به سبک داوینچی که توسط هوش مصنوعی تولید شده است.
    طرح آناتومیک تشریح شده یک پروانه مونارک به سبک داوینچی که توسط هوش مصنوعی تولید شده است.

    فرآیند تفکر

    مدل‌های تصویر Gemini 3، مدل‌های تفکری هستند که از یک فرآیند استدلال ("تفکر") برای دستورات پیچیده استفاده می‌کنند. این ویژگی به طور پیش‌فرض فعال است و نمی‌توان آن را در API غیرفعال کرد. برای کسب اطلاعات بیشتر در مورد فرآیند تفکر، به راهنمای تفکر Gemini مراجعه کنید.

    این مدل تا دو تصویر موقت برای آزمایش ترکیب‌بندی و منطق تولید می‌کند. آخرین تصویر درون Thinking، تصویر رندر شده نهایی نیز هست.

    می‌توانید افکاری را که منجر به تولید تصویر نهایی می‌شوند، بررسی کنید.

    پایتون

    for step in interaction.steps:
        if step.type == "thought":
            for content_block in step.summary:
                if content_block.type == "text":
                    print(content_block.text)
                elif content_block.type == "image":
                    image = Image.open(io.BytesIO(base64.b64decode(content_block.data)))
                    image.show()
    

    جاوا اسکریپت

    for (const step of interaction.steps) {
      if (step.type === "thought") {
        for (const contentBlock of step.summary) {
          if (contentBlock.type === "text") {
            console.log(contentBlock.text);
          } else if (contentBlock.type === "image") {
            const buffer = Buffer.from(contentBlock.data, 'base64');
            fs.writeFileSync('thought_image.png', buffer);
          }
        }
      }
    }
    

    متن و تصاویر درهم تنیده

    در حالی که مدل‌های استاندارد تولید تصویر فقط تصاویر را خروجی می‌دهند، برخی از مدل‌های پیشرفته Gemini 3 (مانند gemini-3-pro-image ) می‌توانند محتوای درهم‌تنیده - مانند داستان‌ها یا راهنماهای آموزشی - تولید کنند که شامل بلوک‌های متنی و تصاویر در داخل یک پاسخ واحد هستند.

    از آنجا که خروجی پیچیده و لایه لایه است، ویژگی‌های راحتی مانند .output_image یا .output_text توالی کامل را ثبت نمی‌کنند. برای دسترسی و ذخیره محتوای لایه لایه، باید steps زیر را به صورت دستی تکرار کنید:

    پایتون

    interaction = client.interactions.create(
        model="gemini-3-pro-image",
        input="Write the story of the lifecycle of a monarch butterfly, interleave illustrations",
    )
    
    image_counter = 1
    for step in interaction.steps:
        if step.type == "model_output":
            for content_block in step.content:
                if content_block.type == "text":
                    print(content_block.text)
                elif content_block.type == "image":
                    filename = f"butterfly_lifecycle_{image_counter}.png"
                    with open(filename, "wb") as f:
                        f.write(base64.b64decode(content_block.data))
                    print(f"\n[Saved illustration: {filename}]\n")
                    image_counter += 1
    

    جاوا اسکریپت

    const interaction = await ai.interactions.create({
        model: "gemini-3-pro-image",
        input: "Write the story of the lifecycle of a monarch butterfly, interleave illustrations",
    });
    
    let imageCounter = 1;
    for (const step of interaction.steps) {
      if (step.type === "model_output") {
        for (const contentBlock of step.content) {
          if (contentBlock.type === "text") {
            console.log(contentBlock.text);
          } else if (contentBlock.type === "image") {
            const buffer = Buffer.from(contentBlock.data, "base64");
            const filename = `butterfly_lifecycle_${imageCounter}.png`;
            fs.writeFileSync(filename, buffer);
            console.log(`\n[Saved illustration: ${filename}]\n`);
            imageCounter++;
          }
        }
      }
    }
    

    کنترل سطوح تفکر

    با استفاده از Gemini 3.1 Flash Image، می‌توانید میزان تفکری که مدل استفاده می‌کند را کنترل کنید تا کیفیت و تأخیر را متعادل کنید. سطح thinking_level پیش‌فرض minimal است و سطوح پشتیبانی شده minimal و high هستند.

    پایتون

    from google import genai
    from PIL import Image
    import base64
    import io
    
    client = genai.Client()
    
    interaction = client.interactions.create(
        model="gemini-3.1-flash-image",
        input="A futuristic city built inside a giant glass bottle floating in space",
        generation_config={"thinking_level": "high"},
    )
    
    print(interaction.output_text)
    
    image = Image.open(io.BytesIO(base64.b64decode(interaction.output_image.data)))
    
    image.show()
    
    

    جاوا اسکریپت

    import { GoogleGenAI } from "@google/genai";
    import * as fs from "node:fs";
    
    async function main() {
      const ai = new GoogleGenAI({});
    
      const interaction = await ai.interactions.create({
        model: "gemini-3.1-flash-image",
        input: "A futuristic city built inside a giant glass bottle floating in space",
        generation_config: { thinking_level: "high" },
      });
    
      console.log(interaction.output_text);
    
      const buffer = Buffer.from(interaction.output_image.data, 'base64');
    
      fs.writeFileSync('image.png', buffer);
    }
    main();
    

    استراحت

    curl -s -X POST \
      "https://generativelanguage.googleapis.com/v1beta/interactions" \
      -H "x-goog-api-key: $GEMINI_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "gemini-3.1-flash-image",
        "input": "A futuristic city built inside a giant glass bottle floating in space",
        "generation_config": {
          "thinking_level": "high"
        }
      }'
    

    توجه داشته باشید که توکن‌های تفکر به طور پیش‌فرض برای مدل‌های تفکر هزینه دریافت می‌کنند، زیرا فرآیند تفکر همیشه به طور پیش‌فرض اتفاق می‌افتد، چه شما این فرآیند را ببینید و چه نبینید.

    سایر حالت‌های تولید تصویر

    اگرچه مدل‌های تولید تصویر Nano Banana برای اکثر موارد استفاده توصیه می‌شوند، می‌توانید مدل‌های تولید تصویر اختصاصی را نیز بررسی کنید:

    • Imagen : مدل‌های تبدیل متن به تصویر گوگل که برای تولید تصاویر با کیفیت بالا بهینه شده‌اند.
    • وئو : مدل تولید ویدیوی گوگل.

    تولید تصاویر به صورت دسته‌ای

    تمام قابلیت‌های تولید تصویر که در این صفحه توضیح داده شده است، می‌توانند به صورت دسته‌ای با استفاده از Batch API نیز اجرا شوند، که در صورت نیاز به تولید تصاویر زیاد، ایده‌آل است. در ازای زمان تحویل تا ۲۴ ساعت، محدودیت‌های سرعت بالاتری دریافت می‌کنید.

    راهنمای تشویق و استراتژی‌ها

    این بخش مثال‌ها و قالب‌های آماده برای گردش‌های کاری رایج تولید و ویرایش تصویر را ارائه می‌دهد. هر مثال شامل یک قالب قابل استفاده مجدد و یک نمونه آماده برای Interactions API است.

    دستورالعمل‌های تولید تصاویر

    مثال‌های زیر نحوه استفاده از دستورات متنی برای تولید انواع مختلف تصاویر را نشان می‌دهند.

    ۱. صحنه‌های واقع‌گرایانه

    یک صحنه را با جزئیات کامل توصیف کنید. هرچه دقیق‌تر باشید، کنترل بیشتری بر نتایج خواهید داشت.

    الگو

    A photorealistic [type of shot] of a [subject description] in a [setting
    description]. [Description of the light]. Shot from a [camera angle]
    with a [lens type].
    

    سریع

    A photorealistic wide-angle shot of a vibrant coral reef teeming with tropical fish. Crystal-clear turquoise water with sunbeams filtering down from the surface, illuminating a sea turtle gliding gracefully over the coral. Shot from a low perspective with a wide-angle lens. Aspect ratio 16:9.
    

    پایتون

    from google import genai
    from google.genai import types
    import base64
    
    client = genai.Client()
    
    interaction = client.interactions.create(
        model="gemini-3.1-flash-image",
        input="A photorealistic wide-angle shot of a vibrant coral reef teeming with tropical fish. Crystal-clear turquoise water with sunbeams filtering down from the surface, illuminating a sea turtle gliding gracefully over the coral. Shot from a low perspective with a wide-angle lens. Aspect ratio 16:9.",
        response_format=[
            {
                "type": "image",
                "mime_type": "image/jpeg",
                "aspect_ratio": "16:9",
            }
        ],
    )
    
    print(interaction.output_text)
    
    with open("coral_reef.png", "wb") as f:
    
        f.write(base64.b64decode(interaction.output_image.data))
    

    جاوا اسکریپت

    import { GoogleGenAI } from "@google/genai";
    import * as fs from "node:fs";
    
    async function main() {
      const ai = new GoogleGenAI({});
    
      const interaction = await ai.interactions.create({
        model: "gemini-3.1-flash-image",
        input: "A photorealistic wide-angle shot of a vibrant coral reef teeming with tropical fish. Crystal-clear turquoise water with sunbeams filtering down from the surface, illuminating a sea turtle gliding gracefully over the coral. Shot from a low perspective with a wide-angle lens. Aspect ratio 16:9.",
        response_format: [
          {
            type: "image",
            mime_type: "image/jpeg",
            aspect_ratio: "16:9",
          }
        ],
      });
      console.log(interaction.output_text);
    
      const buffer = Buffer.from(interaction.output_image.data, 'base64');
    
      fs.writeFileSync('coral_reef.png', buffer);
    }
    
    main();
    

    استراحت

    curl -s -X POST \
      "https://generativelanguage.googleapis.com/v1beta/interactions" \
      -H "x-goog-api-key: $GEMINI_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "gemini-3.1-flash-image",
        "input": "A photorealistic wide-angle shot of a vibrant coral reef teeming with tropical fish. Crystal-clear turquoise water with sunbeams filtering down from the surface, illuminating a sea turtle gliding gracefully over the coral. Shot from a low perspective with a wide-angle lens. Aspect ratio 16:9.",
        "response_format": {
          "type": "image",
          "mime_type": "image/png",
          "aspect_ratio": "16:9"
        }
      }'
    

    ۲. تصاویر و برچسب‌های سبک‌دار

    سبک هنری، موضوع و رسانه را شرح دهید. برای نتایج منسجم، در مورد جزئیات بصری (خطوط پررنگ، رنگ‌ها و غیره) دقیق باشید.

    الگو

    A [style] of a [subject, with details about accessories or actions]
    doing [activity]. The design features [visual qualities, e.g., bold outlines,
    cel-shading, etc.] and [color/background preference].
    

    سریع

    A kawaii-style sticker of a happy red panda wearing a tiny bamboo hat. It's munching on a green bamboo leaf. The design features bold, clean outlines, simple cel-shading, and a vibrant color palette. The background must be white.
    

    پایتون

    from google import genai
    import base64
    
    client = genai.Client()
    
    interaction = client.interactions.create(
        model="gemini-3.1-flash-image",
        input="A kawaii-style sticker of a happy red panda wearing a tiny bamboo hat. It's munching on a green bamboo leaf. The design features bold, clean outlines, simple cel-shading, and a vibrant color palette. The background must be white.",
    )
    
    for step in interaction.steps:
        if step.type == "model_output":
            for content_block in step.content:
                if content_block.type == "text":
                    print(content_block.text)
                elif content_block.type == "image":
                    with open("red_panda_sticker.png", "wb") as f:
                        f.write(base64.b64decode(content_block.data))
    

    جاوا اسکریپت

    import { GoogleGenAI } from "@google/genai";
    import * as fs from "node:fs";
    
    async function main() {
      const ai = new GoogleGenAI({});
    
      const interaction = await ai.interactions.create({
        model: "gemini-3.1-flash-image",
        input: "A kawaii-style sticker of a happy red panda wearing a tiny bamboo hat. It's munching on a green bamboo leaf. The design features bold, clean outlines, simple cel-shading, and a vibrant color palette. The background must be white.",
      });
      for (const step of interaction.steps) {
        if (step.type === "model_output") {
          for (const contentBlock of step.content) {
            if (contentBlock.type === "text") {
              console.log(contentBlock.text);
            } else if (contentBlock.type === "image") {
              const buffer = Buffer.from(contentBlock.data, "base64");
              fs.writeFileSync("red_panda_sticker.png", buffer);
            }
          }
        }
      }
    }
    
    main();
    

    استراحت

    curl -s -X POST \
      "https://generativelanguage.googleapis.com/v1beta/interactions" \
      -H "x-goog-api-key: $GEMINI_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "gemini-3.1-flash-image",
        "input": "A kawaii-style sticker of a happy red panda wearing a tiny bamboo hat. It is munching on a green bamboo leaf. The design features bold, clean outlines, simple cel-shading, and a vibrant color palette. The background must be white."
      }'
    
    یک استیکر به سبک کاوایی از یک قرمز شاد...
    یک استیکر به سبک کاوایی از یک پاندای قرمز خوشحال...

    ۳. متن دقیق در تصاویر

    Gemini در رندر کردن متن عالی است. در مورد متن، سبک فونت (به صورت توصیفی) و طراحی کلی، واضح باشید. از Gemini 3 Pro Image برای تولید حرفه‌ای تصاویر استفاده کنید.

    الگو

    Create a [image type] for [brand/concept] with the text "[text to render]"
    in a [font style]. The design should be [style description], with a
    [color scheme].
    

    سریع

    Create a modern, minimalist logo for a coffee shop called 'The Daily Grind'. The text should be in a clean, bold, sans-serif font. The color scheme is black and white. Put the logo in a circle. Use a coffee bean in a clever way.
    

    پایتون

    from google import genai
    import base64
    
    client = genai.Client()
    
    interaction = client.interactions.create(
        model="gemini-3.1-flash-image",
        input="Create a modern, minimalist logo for a coffee shop called 'The Daily Grind'. The text should be in a clean, bold, sans-serif font. The color scheme is black and white. Put the logo in a circle. Use a coffee bean in a clever way.",
        response_format={"type": "image", "aspect_ratio": "1:1"},
    )
    
    for step in interaction.steps:
        if step.type == "model_output":
            for content_block in step.content:
                if content_block.type == "text":
                    print(content_block.text)
                elif content_block.type == "image":
                    with open("logo_example.jpg", "wb") as f:
                        f.write(base64.b64decode(content_block.data))
    

    جاوا اسکریپت

    import { GoogleGenAI } from "@google/genai";
    import * as fs from "node:fs";
    
    async function main() {
      const ai = new GoogleGenAI({});
    
      const interaction = await ai.interactions.create({
        model: "gemini-3.1-flash-image",
        input: "Create a modern, minimalist logo for a coffee shop called 'The Daily Grind'. The text should be in a clean, bold, sans-serif font. The color scheme is black and white. Put the logo in a circle. Use a coffee bean in a clever way.",
        response_format: { type: "image", aspect_ratio: "1:1" },
      });
      for (const step of interaction.steps) {
        if (step.type === "model_output") {
          for (const contentBlock of step.content) {
            if (contentBlock.type === "text") {
              console.log(contentBlock.text);
            } else if (contentBlock.type === "image") {
              const buffer = Buffer.from(contentBlock.data, "base64");
              fs.writeFileSync("logo_example.jpg", buffer);
            }
          }
        }
      }
    }
    
    main();
    

    استراحت

    curl -s -X POST \
      "https://generativelanguage.googleapis.com/v1beta/interactions" \
      -H "x-goog-api-key: $GEMINI_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "gemini-3.1-flash-image",
        "input": "Create a modern, minimalist logo for a coffee shop called The Daily Grind. The text should be in a clean, bold, sans-serif font. The color scheme is black and white. Put the logo in a circle. Use a coffee bean in a clever way.",
        "response_format": {
          "type": "image",
          "aspect_ratio": "1:1"
        }
      }'
    
    یک لوگوی مدرن و مینیمالیستی برای یک کافی‌شاپ به نام «The Daily Grind» طراحی کنید...
    یک لوگوی مدرن و مینیمالیستی برای یک کافی‌شاپ به نام «The Daily Grind» طراحی کنید...

    ۴. ماکت‌های محصول و عکاسی تجاری

    ایده‌آل برای ایجاد عکس‌های تمیز و حرفه‌ای از محصولات برای تجارت الکترونیک، تبلیغات یا برندسازی.

    الگو

    A high-resolution, studio-lit product photograph of a [product description]
    on a [background surface/description]. The lighting is a [lighting setup,
    e.g., three-point softbox setup] to [lighting purpose]. The camera angle is
    a [angle type] to showcase [specific feature]. Ultra-realistic, with sharp
    focus on [key detail]. [Aspect ratio].
    

    سریع

    A high-resolution, studio-lit product photograph of a minimalist ceramic
    coffee mug in matte black, presented on a polished concrete surface. The
    lighting is a three-point softbox setup designed to create soft, diffused
    highlights and eliminate harsh shadows. The camera angle is a slightly
    elevated 45-degree shot to showcase its clean lines. Ultra-realistic, with
    sharp focus on the steam rising from the coffee. Square image.
    

    پایتون

    from google import genai
    import base64
    
    client = genai.Client()
    
    interaction = client.interactions.create(
        model="gemini-3.1-flash-image",
        input="A high-resolution, studio-lit product photograph of a minimalist ceramic coffee mug in matte black, presented on a polished concrete surface. The lighting is a three-point softbox setup designed to create soft, diffused highlights and eliminate harsh shadows. The camera angle is a slightly elevated 45-degree shot to showcase its clean lines. Ultra-realistic, with sharp focus on the steam rising from the coffee. Square image.",
    )
    
    for step in interaction.steps:
        if step.type == "model_output":
            for content_block in step.content:
                if content_block.type == "text":
                    print(content_block.text)
                elif content_block.type == "image":
                    with open("product_mockup.png", "wb") as f:
                        f.write(base64.b64decode(content_block.data))
    

    جاوا اسکریپت

    import { GoogleGenAI } from "@google/genai";
    import * as fs from "node:fs";
    
    async function main() {
      const ai = new GoogleGenAI({});
    
      const interaction = await ai.interactions.create({
        model: "gemini-3.1-flash-image",
        input: "A high-resolution, studio-lit product photograph of a minimalist ceramic coffee mug in matte black, presented on a polished concrete surface. The lighting is a three-point softbox setup designed to create soft, diffused highlights and eliminate harsh shadows. The camera angle is a slightly elevated 45-degree shot to showcase its clean lines. Ultra-realistic, with sharp focus on the steam rising from the coffee. Square image.",
      });
      for (const step of interaction.steps) {
        if (step.type === "model_output") {
          for (const contentBlock of step.content) {
            if (contentBlock.type === "text") {
              console.log(contentBlock.text);
            } else if (contentBlock.type === "image") {
              const buffer = Buffer.from(contentBlock.data, "base64");
              fs.writeFileSync("product_mockup.png", buffer);
            }
          }
        }
      }
    }
    
    main();
    

    استراحت

    curl -s -X POST \
      "https://generativelanguage.googleapis.com/v1beta/interactions" \
      -H "x-goog-api-key: $GEMINI_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "gemini-3.1-flash-image",
        "input": "A high-resolution, studio-lit product photograph of a minimalist ceramic coffee mug in matte black, presented on a polished concrete surface. The lighting is a three-point softbox setup designed to create soft, diffused highlights and eliminate harsh shadows. The camera angle is a slightly elevated 45-degree shot to showcase its clean lines. Ultra-realistic, with sharp focus on the steam rising from the coffee. Square image."
      }'
    
    یک عکس محصول با وضوح بالا و نورپردازی استودیویی از یک لیوان قهوه سرامیکی مینیمالیستی...
    یک عکس محصول با وضوح بالا و نورپردازی استودیویی از یک لیوان قهوه سرامیکی مینیمالیستی...

    ۵. طراحی مینیمالیستی و فضای منفی

    عالی برای ایجاد پس‌زمینه برای وب‌سایت‌ها، ارائه‌ها یا مطالب بازاریابی که در آن‌ها متن روی چیزی قرار می‌گیرد.

    الگو

    A minimalist composition featuring a single [subject] positioned in the
    [bottom-right/top-left/etc.] of the frame. The background is a vast, empty
    [color] canvas, creating significant negative space. Soft, subtle lighting.
    [Aspect ratio].
    

    سریع

    A minimalist composition featuring a single, delicate red maple leaf
    positioned in the bottom-right of the frame. The background is a vast, empty
    off-white canvas, creating significant negative space for text. Soft,
    diffused lighting from the top left. Square image.
    

    پایتون

    from google import genai
    import base64
    
    client = genai.Client()
    
    interaction = client.interactions.create(
        model="gemini-3.1-flash-image",
        input="A minimalist composition featuring a single, delicate red maple leaf positioned in the bottom-right of the frame. The background is a vast, empty off-white canvas, creating significant negative space for text. Soft, diffused lighting from the top left. Square image.",
    )
    
    for step in interaction.steps:
        if step.type == "model_output":
            for content_block in step.content:
                if content_block.type == "text":
                    print(content_block.text)
                elif content_block.type == "image":
                    with open("minimalist_design.png", "wb") as f:
                        f.write(base64.b64decode(content_block.data))
    

    جاوا اسکریپت

    import { GoogleGenAI } from "@google/genai";
    import * as fs from "node:fs";
    
    async function main() {
      const ai = new GoogleGenAI({});
    
      const interaction = await ai.interactions.create({
        model: "gemini-3.1-flash-image",
        input: "A minimalist composition featuring a single, delicate red maple leaf positioned in the bottom-right of the frame. The background is a vast, empty off-white canvas, creating significant negative space for text. Soft, diffused lighting from the top left. Square image.",
      });
      for (const step of interaction.steps) {
        if (step.type === "model_output") {
          for (const contentBlock of step.content) {
            if (contentBlock.type === "text") {
              console.log(contentBlock.text);
            } else if (contentBlock.type === "image") {
              const buffer = Buffer.from(contentBlock.data, "base64");
              fs.writeFileSync("minimalist_design.png", buffer);
            }
          }
        }
      }
    }
    
    main();
    

    استراحت

    curl -s -X POST \
      "https://generativelanguage.googleapis.com/v1beta/interactions" \
      -H "x-goog-api-key: $GEMINI_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "gemini-3.1-flash-image",
        "input": "A minimalist composition featuring a single, delicate red maple leaf positioned in the bottom-right of the frame. The background is a vast, empty off-white canvas, creating significant negative space for text. Soft, diffused lighting from the top left. Square image."
      }'
    
    یک ترکیب مینیمالیستی با یک برگ افرای قرمز ظریف و تک...
    یک ترکیب مینیمالیستی با یک برگ افرای قرمز ظریف و تک...

    ۶. هنر ترتیبی (پانل کمیک / استوری‌بورد)

    بر اساس ثبات شخصیت و توصیف صحنه، پنل‌هایی برای داستان‌سرایی بصری ایجاد می‌کند. برای دقت در متن و توانایی داستان‌سرایی، این دستورالعمل‌ها با Gemini 3 Pro و Gemini 3.1 Flash Image بهترین عملکرد را دارند.

    الگو

    Make a 3 panel comic in a [style]. Put the character in a [type of scene].
    

    سریع

    Make a 3 panel comic in a gritty, noir art style with high-contrast black and white inks. Put the character in a humurous scene.
    

    پایتون

    from google import genai
    from PIL import Image
    import base64
    
    client = genai.Client()
    
    with open('/path/to/your/man_in_white_glasses.jpg', 'rb') as f:
        image_bytes = f.read()
    text_input = "Make a 3 panel comic in a gritty, noir art style with high-contrast black and white inks. Put the character in a humurous scene."
    
    interaction = client.interactions.create(
        model="gemini-3.1-flash-image",
        input=[
            {"type": "text", "text": text_input},
            {
                "type": "image",
                "data": base64.b64encode(image_bytes).decode('utf-8'),
                "mime_type": "image/jpeg"
            }
        ],
    )
    
    for step in interaction.steps:
        if step.type == "model_output":
            for content_block in step.content:
                if content_block.type == "text":
                    print(content_block.text)
                elif content_block.type == "image":
                    with open("comic_panel.jpg", "wb") as f:
                        f.write(base64.b64decode(content_block.data))
    

    جاوا اسکریپت

    import { GoogleGenAI } from "@google/genai";
    import * as fs from "node:fs";
    
    async function main() {
      const ai = new GoogleGenAI({});
    
      const imagePath = "/path/to/your/man_in_white_glasses.jpg";
      const imageData = fs.readFileSync(imagePath);
      const base64Image = imageData.toString("base64");
    
      const input = [
        { type: "text", text: "Make a 3 panel comic in a gritty, noir art style with high-contrast black and white inks. Put the character in a humurous scene." },
        {
          type: "image",
          mime_type: "image/jpeg",
          data: base64Image
        },
      ];
    
      const interaction = await ai.interactions.create({
        model: "gemini-3.1-flash-image",
        input: input,
      });
      for (const step of interaction.steps) {
        if (step.type === "model_output") {
          for (const contentBlock of step.content) {
            if (contentBlock.type === "text") {
              console.log(contentBlock.text);
            } else if (contentBlock.type === "image") {
              const buffer = Buffer.from(contentBlock.data, "base64");
              fs.writeFileSync("comic_panel.jpg", buffer);
            }
          }
        }
      }
    }
    
    main();
    

    استراحت

    curl -s -X POST \
      "https://generativelanguage.googleapis.com/v1beta/interactions" \
      -H "x-goog-api-key: $GEMINI_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "gemini-3.1-flash-image",
        "input": [
          {"type": "text", "text": "Make a 3 panel comic in a gritty, noir art style with high-contrast black and white inks. Put the character in a humurous scene."},
          {"type": "image", "data": "<BASE64_IMAGE_DATA>", "mime_type": "image/jpeg"}
        ]
      }'
    

    ورودی

    خروجی

    مرد با عینک سفید
    تصویر ورودی
    یک کمیک سه قسمتی به سبک هنری خشن و نوآر بسازید...
    یک کمیک سه قسمتی به سبک هنری خشن و نوآر بسازید...

    از جستجوی گوگل برای تولید تصاویر بر اساس اطلاعات اخیر یا اطلاعات لحظه‌ای استفاده کنید. این قابلیت برای اخبار، آب و هوا و سایر موضوعات حساس به زمان مفید است.

    سریع

    Make a simple but stylish graphic of last night's Arsenal game in the Champion's League
    

    پایتون

    from google import genai
    from google.genai import types
    import base64
    
    client = genai.Client()
    
    interaction = client.interactions.create(
        model="gemini-3.1-flash-image",
        input="Make a simple but stylish graphic of last night's Arsenal game in the Champion's League",
        tools=[{"type": "google_search"}],
        response_format={"type": "image", "aspect_ratio": "16:9"},
    )
    
    for step in interaction.steps:
        if step.type == "model_output":
            for content_block in step.content:
                if content_block.type == "text":
                    print(content_block.text)
                elif content_block.type == "image":
                    with open("football-score.jpg", "wb") as f:
                        f.write(base64.b64decode(content_block.data))
    

    جاوا اسکریپت

    import { GoogleGenAI } from "@google/genai";
    import * as fs from "node:fs";
    
    async function main() {
      const ai = new GoogleGenAI({});
    
      const interaction = await ai.interactions.create({
        model: "gemini-3.1-flash-image",
        input: "Make a simple but stylish graphic of last night's Arsenal game in the Champion's League",
        tools: [{ type: "google_search" }],
        response_format: { type: "image", aspect_ratio: "16:9", image_size: "2K" },
      });
    
      for (const step of interaction.steps) {
        if (step.type === "model_output") {
          for (const contentBlock of step.content) {
            if (contentBlock.type === "text") {
              console.log(contentBlock.text);
            } else if (contentBlock.type === "image") {
              const buffer = Buffer.from(contentBlock.data, "base64");
              fs.writeFileSync("football-score.jpg", buffer);
            }
          }
        }
      }
    }
    
    main();
    

    استراحت

    curl -s -X POST \
      "https://generativelanguage.googleapis.com/v1beta/interactions" \
      -H "x-goog-api-key: $GEMINI_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "gemini-3.1-flash-image",
        "input": "Make a simple but stylish graphic of last nights Arsenal game in the Champions League",
        "tools": [{"type": "google_search"}],
        "response_format": {
          "type": "image",
          "aspect_ratio": "16:9"
        }
      }'
    
    گرافیک تولید شده توسط هوش مصنوعی از نتیجه بازی فوتبال آرسنال
    گرافیک تولید شده توسط هوش مصنوعی از نتیجه بازی فوتبال آرسنال

    دستورالعمل‌های ویرایش تصاویر

    این مثال‌ها نشان می‌دهند که چگونه می‌توانید در کنار متن‌های خود، تصاویر را برای ویرایش، ترکیب‌بندی و انتقال سبک ارائه دهید.

    ۱. اضافه کردن و حذف کردن عناصر

    یک تصویر ارائه دهید و تغییر خود را شرح دهید. مدل با سبک، نورپردازی و پرسپکتیو تصویر اصلی مطابقت خواهد داشت.

    الگو

    Using the provided image of [subject], please [add/remove/modify] [element]
    to/from the scene. Ensure the change is [description of how the change should
    integrate].
    

    سریع

    "Using the provided image of my cat, please add a small, knitted wizard hat
    on its head. Make it look like it's sitting comfortably and matches the soft
    lighting of the photo."
    

    پایتون

    from google import genai
    from PIL import Image
    import base64
    
    client = genai.Client()
    
    with open('/path/to/your/cat_photo.png', 'rb') as f:
        image_bytes = f.read()
    text_input = """Using the provided image of my cat, please add a small, knitted wizard hat on its head. Make it look like it's sitting comfortably and not falling off."""
    
    interaction = client.interactions.create(
        model="gemini-3.1-flash-image",
        input=[
            {"type": "text", "text": text_input},
            {
                "type": "image",
                "data": base64.b64encode(image_bytes).decode('utf-8'),
                "mime_type": "image/png"
            }
        ],
    )
    
    for step in interaction.steps:
        if step.type == "model_output":
            for content_block in step.content:
                if content_block.type == "text":
                    print(content_block.text)
                elif content_block.type == "image":
                    with open("cat_with_hat.png", "wb") as f:
                        f.write(base64.b64decode(content_block.data))
    

    جاوا اسکریپت

    import { GoogleGenAI } from "@google/genai";
    import * as fs from "node:fs";
    
    async function main() {
      const ai = new GoogleGenAI({});
    
      const imagePath = "/path/to/your/cat_photo.png";
      const imageData = fs.readFileSync(imagePath);
      const base64Image = imageData.toString("base64");
    
      const input = [
        { type: "text", text: "Using the provided image of my cat, please add a small, knitted wizard hat on its head. Make it look like it's sitting comfortably and not falling off." },
        {
          type: "image",
          mime_type: "image/png",
          data: base64Image
        },
      ];
    
      const interaction = await ai.interactions.create({
        model: "gemini-3.1-flash-image",
        input: input,
      });
      for (const step of interaction.steps) {
        if (step.type === "model_output") {
          for (const contentBlock of step.content) {
            if (contentBlock.type === "text") {
              console.log(contentBlock.text);
            } else if (contentBlock.type === "image") {
              const buffer = Buffer.from(contentBlock.data, "base64");
              fs.writeFileSync("cat_with_hat.png", buffer);
            }
          }
        }
      }
    }
    
    main();
    

    استراحت

    curl -s -X POST \
      "https://generativelanguage.googleapis.com/v1beta/interactions" \
        -H "x-goog-api-key: $GEMINI_API_KEY" \
        -H 'Content-Type: application/json' \
        -d "{
          \"model\": \"gemini-3.1-flash-image\",
          \"input\": [
                {\"type\": \"text\", \"text\": \"Using the provided image of my cat, please add a small, knitted wizard hat on its head. Make it look like it's sitting comfortably and not falling off.\"},
                {\"type\": \"image\", \"mime_type\":\"image/png\", \"data\": \"<BASE64_IMAGE_DATA>\"}
            ]
        }"
    

    ورودی

    خروجی

    تصویری واقع‌گرایانه از یک گربه مو قرمز پشمالو..
    تصویری واقع‌گرایانه از یک گربه مو قرمز پشمالو...
    با استفاده از تصویر گربه من که در اختیارتان قرار داده شده، لطفاً یک کلاه جادوگری کوچک و بافتنی اضافه کنید...
    با استفاده از تصویر گربه من که در اختیارتان قرار داده شده، لطفاً یک کلاه جادوگری کوچک و بافتنی اضافه کنید...

    ۲. رنگ‌آمیزی (پوشش معنایی)

    به صورت محاوره‌ای یک «ماسک» تعریف کنید تا بخش خاصی از تصویر را ویرایش کنید و بقیه را دست‌نخورده باقی بگذارید.

    الگو

    Using the provided image, change only the [specific element] to [new
    element/description]. Keep everything else in the image exactly the same,
    preserving the original style, lighting, and composition.
    

    سریع

    "Using the provided image of a living room, change only the blue sofa to be
    a vintage, brown leather chesterfield sofa. Keep the rest of the room,
    including the pillows on the sofa and the lighting, unchanged."
    

    پایتون

    from google import genai
    from PIL import Image
    import base64
    
    client = genai.Client()
    
    with open('/path/to/your/living_room.png', 'rb') as f:
        image_bytes = f.read()
    text_input = """Using the provided image of a living room, change only the blue sofa to be a vintage, brown leather chesterfield sofa. Keep the rest of the room, including the pillows on the sofa and the lighting, unchanged."""
    
    interaction = client.interactions.create(
        model="gemini-3.1-flash-image",
        input=[
            {
                "type": "image",
                "data": base64.b64encode(image_bytes).decode('utf-8'),
                "mime_type": "image/png"
            },
            {"type": "text", "text": text_input}
        ],
    )
    
    for step in interaction.steps:
        if step.type == "model_output":
            for content_block in step.content:
                if content_block.type == "text":
                    print(content_block.text)
                elif content_block.type == "image":
                    with open("living_room_edited.png", "wb") as f:
                        f.write(base64.b64decode(content_block.data))
    

    جاوا اسکریپت

    import { GoogleGenAI } from "@google/genai";
    import * as fs from "node:fs";
    
    async function main() {
      const ai = new GoogleGenAI({});
    
      const imagePath = "/path/to/your/living_room.png";
      const imageData = fs.readFileSync(imagePath);
      const base64Image = imageData.toString("base64");
    
      const input = [
        {
          type: "image",
          mime_type: "image/png",
          data: base64Image
        },
        { type: "text", text: "Using the provided image of a living room, change only the blue sofa to be a vintage, brown leather chesterfield sofa. Keep the rest of the room, including the pillows on the sofa and the lighting, unchanged." },
      ];
    
      const interaction = await ai.interactions.create({
        model: "gemini-3.1-flash-image",
        input: input,
      });
      for (const step of interaction.steps) {
        if (step.type === "model_output") {
          for (const contentBlock of step.content) {
            if (contentBlock.type === "text") {
              console.log(contentBlock.text);
            } else if (contentBlock.type === "image") {