شروع کار با Nano Banana Pro API

Nano Banana Pro API یک رابط کاربردی و آماده برای تولید است که برای تولید تصاویر با جدیدترین مدل‌های مبتنی بر Gemini استفاده می‌شود. این راهنمای Nano Banana Pro API بر استفاده واقعی تمرکز دارد: نحوه ساخت دستورات (prompts)، ساختاردهی درخواست‌ها، تفسیر پاسخ‌ها و ایجاد گردش کاری که محصول شما بتواند به آن تکیه کند.

اگر نمای کلی رسمی، دموها و زمینه محصول Nano Banana 2 را می‌خواهید، با هاب Nano Banana 2 شروع کنید.

Nano Banana Pro API چیست؟

Nano Banana Pro API به شما یک رابط REST ساده برای تولید تصویر با کیفیت بالا می‌دهد. شما یک دستور و مراجع اختیاری ارسال می‌کنید و خروجی‌های تصویری دریافت می‌کنید که می‌توانید در برنامه خود ذخیره و ارائه دهید. این برای تیم‌هایی طراحی شده است که به نتایج ثابت، گردش کار قابل تکرار و الگوهای ادغام قابل پیش‌بینی نیاز دارند.

چه زمانی از Nano Banana Pro API استفاده کنیم

هنگامی که تصاویر سریع و در صورت تقاضا را بدون ساخت خط لوله مدل داخلی می‌خواهید، از Nano Banana Pro API استفاده کنید:

• محتوای بازاریابی برای تبلیغات و صفحات فرود
• تصاویر محصول برای کاتالوگ‌ها و لیست‌های تجارت الکترونیک
• پیش‌نویس‌های خلاقانه برای مفاهیم اولیه و تابلوهای خلق و خو (mood boards)

قابلیت‌های اصلی

این API بر اساس چند نقطه قوت اصلی ساخته شده است که در تولید اهمیت دارند:

• تولید متن به تصویر برای تبدیل زبان طبیعی به تصاویر بصری
• ایجاد تصویر به تصویر برای ریمیکس کردن یا ساختن بر روی عکس‌های موجود
• خروجی‌های آگاه از مرجع برای ثابت نگه داشتن سبک و موضوع
• عملکرد مقیاس‌پذیر برای تأمین انرژی کارهای دسته‌ای و گردش‌های کاری خودکار

شروع سریع Nano Banana Pro API

۱. دسترسی بگیرید

یک حساب کاربری در داشبورد EvoLink ایجاد کنید، سپس یک کلید API برای پروژه خود تولید کنید. کلید را در یک ذخیره‌سازی امن نگه دارید و هرگز آن را در کد سمت کلاینت فاش نکنید.

۲. اولین درخواست خود را انجام دهید

در اینجا یک مثال حداقل cURL آورده شده است. متغیرها را با مقادیر واقعی خود جایگزین کنید.

curl -X POST "API_BASE/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "prompt": "A beautiful sunset over mountains, digital art style",
    "size": "ASPECT_RATIO",
    "quality": "RESOLUTION_TIER"
  }'

۳. مدیریت پاسخ

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

{
  "created": 1737014400,
  "data": [
    {
      "url": "IMAGE_URL"
    }
  ]
}

پارامترهای اصلی که باید بدانید

اینها پارامترهایی هستند که هنگام فراخوانی Nano Banana Pro API بیشتر از آنها استفاده خواهید کرد:

• model: از مدل فعال شده برای حساب خود استفاده کنید. یک سطح مقرون به صرفه برای پیش‌نویس‌ها و یک سطح پریمیوم برای دارایی‌های نهایی انتخاب کنید.
• prompt: متن دستور شما. در مورد موضوع، سبک و حال و هوا صریح باشید.
• size: نسبت ابعاد یا پیش‌تنظیم اندازه که متناسب با مکان شما است (مربع، پرتره یا منظره).
• quality: سطح رزولوشنی که برای خروجی نهایی نیاز دارید.
• image_urls: تصاویر مرجع اختیاری اگر می‌خواهید موضوع یا سبک را ثابت نگه دارید.

کارهای ناهمگام و URLهای تصویر

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

کتابچه راهنمای دستور (Prompt Playbook)

سریع‌ترین راه برای بهبود نتایج، استفاده از یک ساختار دستور واضح است. یک فرمول ساده به خوبی کار می‌کند:

موضوع + زمینه + سبک + نورپردازی + ترکیب‌بندی + کیفیت

در اینجا نکات کاربردی‌تری برای دستور آورده شده است:

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

نمونه دستورات

کنترل کیفیت و تکرار

با تولید به عنوان یک چرخه طراحی سریع رفتار کنید. با یک دستور گسترده شروع کنید، سپس تکرار کنید:

• بر اساس اولین خروجی، جزئیات را اضافه یا حذف کنید.
• قبل از اصلاح موضوع، یک سبک را قفل کنید.
• بهترین دستورات را ذخیره کنید تا تیم شما بتواند بعداً از آنها استفاده مجدد کند.
• هنگامی که ثبات در یک سری مهم است، از تصاویر مرجع استفاده کنید.

چک‌لیست تولید

قبل از ارسال Nano Banana Pro API در گردش کار خود، از این چک‌لیست استفاده کنید:

• کلید API در یک ذخیره‌سازی امن سمت سرور ذخیره شده است
• دستورات پایه برای موارد استفاده اصلی شما مستند شده‌اند
• تصاویر خروجی در ذخیره‌سازی دائمی ذخیره شده‌اند

خلاصه

Nano Banana Pro API راهی قابل اعتماد برای تولید تصاویر بصری با کیفیت بالا با یک رابط REST تمیز است. با دستورات واضح شروع کنید، به سرعت تکرار کنید و بهترین نتایج خود را مستند کنید. برای تیم‌هایی که سریع ارسال می‌کنند، این کار خروجی خلاقانه را بدون ابزارهای سنگین در حرکت نگه می‌دارد.