هوش مصنوعی گوگل Gemini چیست؟ آموزش کامل استفاده از جمینای

در این راهنمای جامع با هوش مصنوعی گوگل Gemini آشنا می‌شوید و روش استفاده از جمینای برای تولید متن و تصویر، تحلیل فایل، برنامه‌نویسی، تحقیق و اتصال به API را یاد می‌گیرید.

Share
هوش مصنوعی گوگل Gemini چیست؟ آموزش کامل استفاده از جمینای
Google Gemini Darvareh AI

هوش مصنوعی گوگل Gemini چیست؟

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

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

Gemini می‌تواند ورودی‌های مختلفی را پردازش کند:

  • متن
  • تصویر
  • فایل PDF
  • اسناد
  • فایل‌های داده
  • کد
  • صوت و ویدئو در مدل‌ها و قابلیت‌های پشتیبانی‌شده
  • چند نوع ورودی در یک درخواست

این ویژگی با عنوان Multimodal یا چندوجهی شناخته می‌شود. در یک مدل چندوجهی، کاربر می‌تواند برای مثال یک تصویر را همراه با سؤال متنی ارسال کند و درباره محتوای آن توضیح بخواهد.

جمینای همان Google Bard است؟

Google Bard نام قبلی دستیار گفت‌وگویی گوگل بود. گوگل در سال ۲۰۲۴ نام Bard را به Gemini تغییر داد تا نام محصول و خانواده مدل‌های هوش مصنوعی خود را یکپارچه کند.

بنابراین، عبارت‌هایی مانند این موارد معمولاً به نسل‌های مختلف محصول هوش مصنوعی گوگل اشاره دارند:

  • Google Bard
  • بارد گوگل
  • Bard AI
  • Gemini
  • Google Gemini
  • جمینای گوگل

نام فعلی محصول، Gemini است.

تفاوت Gemini App و مدل‌های Gemini

این دو مفهوم یکسان نیستند.

اپلیکیشن Gemini

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

نشانی رسمی نسخه وب:

https://gemini.google.com

مدل Gemini

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

Gemini API

رابط برنامه‌نویسی برای توسعه‌دهندگان است. برنامه می‌تواند درخواست را به مدل ارسال و پاسخ را در قالب متن یا داده ساختاریافته دریافت کند.

Google AI Studio

محیطی برای آزمایش مدل‌ها، تنظیم Prompt و دریافت نمونه کد API است.

آیا Gemini از زبان فارسی پشتیبانی می‌کند؟

بله. براساس صفحه رسمی مناطق و زبان‌های پشتیبانی‌شده، Farsi در فهرست زبان‌های نسخه وب Gemini قرار دارد. گوگل اعلام کرده است نسخه وب Gemini در بیش از ۷۰ زبان و بیش از ۲۳۰ کشور و منطقه ارائه می‌شود. فهرست رسمی زبان‌ها و مناطق Gemini

جمینای می‌تواند:

  • متن فارسی را درک کند.
  • به فارسی پاسخ دهد.
  • متن فارسی تولید کند.
  • متن را بازنویسی یا خلاصه کند.
  • ترجمه فارسی و انگلیسی انجام دهد.
  • به سؤال‌های فارسی پاسخ دهد.
  • کد را با توضیح فارسی تولید کند.
  • درباره تصویر به فارسی توضیح دهد.

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

آیا Gemini در ایران در دسترس است؟

براساس فهرست رسمی Google که در زمان نگارش این مقاله بررسی شده، زبان فارسی پشتیبانی می‌شود، اما نام ایران در فهرست کشورهای پشتیبانی‌شده نسخه وب Gemini دیده نمی‌شود. این وضعیت ممکن است در آینده تغییر کند؛ بنابراین پیش از استفاده، صفحه رسمی دسترسی Gemini را بررسی کنید.

پشتیبانی از زبان فارسی با دسترسی رسمی در یک کشور یکسان نیست. ممکن است یک زبان پشتیبانی شود، اما سرویس مستقیماً در همه کشورها ارائه نشود.

برای توسعه محصول نیز دسترسی و شرایط Gemini API، Google AI Studio و سرویس‌های Google Cloud باید جداگانه بررسی شوند.

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

چگونه وارد هوش مصنوعی گوگل شویم؟

استفاده از نسخه وب

  1. وارد نشانی gemini.google.com شوید.
  2. با حساب Google خود وارد شوید.
  3. شرایط سرویس و تنظیمات مرتبط را بررسی کنید.
  4. Prompt یا پرامپت خود را در کادر گفت‌وگو بنویسید.
  5. در صورت نیاز فایل یا تصویر اضافه کنید.
  6. پاسخ را بررسی و سؤال تکمیلی مطرح کنید.

دسترسی واقعی به نسخه وب به کشور، حساب، سن، زبان، نوع Workspace و سیاست‌های Google بستگی دارد.

استفاده از موبایل

اپلیکیشن Gemini برای Android و iPhone در کشورهای پشتیبانی‌شده ارائه می‌شود. دسترسی موبایل ممکن است با نسخه وب متفاوت باشد و عرضه قابلیت‌ها نیز تدریجی انجام شود.

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

استفاده بدون نصب

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

چگونه از Gemini به زبان فارسی استفاده کنیم؟

فارسی‌بودن سؤال الزاماً باعث نمی‌شود تمام پاسخ با سبک موردنظر شما تولید شود. زبان، لحن و قالب خروجی را صریح تعیین کنید.

پرامپت ساده:

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

برای متن رسمی:

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

برای زبان ساده:

موضوع را به فارسی ساده و برای فردی بدون دانش فنی توضیح بده.
برای هر مفهوم یک مثال روزمره ارائه کن.

Gemini چه کارهایی می‌تواند انجام دهد؟

پاسخ به سؤال

می‌توانید درباره موضوعات عمومی، علمی، آموزشی و فنی سؤال کنید.

تفاوت هوش مصنوعی مولد و یادگیری ماشین را
با سه مثال ساده توضیح بده.

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

نوشتن و بازنویسی متن

Gemini می‌تواند:

  • مقاله بنویسد.
  • متن را خلاصه کند.
  • لحن را تغییر دهد.
  • غلط‌های نگارشی را اصلاح کند.
  • عنوان پیشنهاد دهد.
  • کپشن بنویسد.
  • متن ایمیل تهیه کند.
  • توضیحات محصول بسازد.
  • متن را ساده‌سازی کند.

پرامپت:

متن زیر را بازنویسی کن.

هدف: صفحه محصول
مخاطب: مدیران فنی
لحن: حرفه‌ای و شفاف
طول: حداکثر ۱۵۰ کلمه

هیچ ویژگی جدیدی به محصول اضافه نکن.

خلاصه‌کردن متن

این متن را در سه سطح خلاصه کن:

1. خلاصه یک‌جمله‌ای
2. پنج نکته کلیدی
3. خلاصه مدیریتی ۲۰۰ کلمه‌ای

اعداد، نام‌ها و نتیجه‌گیری اصلی را تغییر نده.

ترجمه

متن زیر را از انگلیسی به فارسی ترجمه کن.
اصطلاحات API، Token، Prompt و Context Window
را به انگلیسی نیز داخل پرانتز نگه دار.
لحن ترجمه فنی و طبیعی باشد.

برای قرارداد، مدرک رسمی یا متن حساس، ترجمه باید توسط متخصص بررسی شود.

تولید ایده

برای وبلاگ یک زیرساخت API هوش مصنوعی،
۲۰ ایده مقاله فارسی پیشنهاد بده.

شرایط:
- مناسب برنامه‌نویسان ایرانی
- دارای هدف جست‌وجوی آموزشی
- غیرتکراری
- قابل تبدیل به آموزش عملی
- برای هر موضوع یک کلمه کلیدی اصلی بنویس

برنامه‌نویسی

Gemini می‌تواند:

  • کد تولید کند.
  • خطا را توضیح دهد.
  • کد را بازنویسی کند.
  • تست بنویسد.
  • Documentation تهیه کند.
  • کد را بین زبان‌ها تبدیل کند.
  • معماری پیشنهاد دهد.
  • Query پایگاه داده بنویسد.

پرامپت:

کد زیر را بررسی کن.

زبان: TypeScript
Runtime: Node.js
هدف: فراخوانی API خارجی

ابتدا باگ‌ها و مشکلات امنیتی را فهرست کن.
سپس نسخه اصلاح‌شده را بنویس.
در پایان تست‌های ضروری را پیشنهاد بده.
کلید API نباید در Frontend قرار بگیرد.

کد تولیدشده را پیش از اجرا بررسی و آزمایش کنید.

تحلیل تصویر

Gemini می‌تواند درباره تصویر ورودی سؤال پاسخ دهد:

  • اشیای موجود را توضیح دهد.
  • نمودار را تحلیل کند.
  • متن قابل‌مشاهده را استخراج کند.
  • تصویر محصول را توصیف کند.
  • مشکل رابط کاربری را بررسی کند.
  • محتوای یک اسکرین‌شات را خلاصه کند.

پرامپت:

این اسکرین‌شات رابط کاربری را تحلیل کن.

موارد زیر را بررسی کن:
- مشکل‌های تجربه کاربری
- خوانایی متن
- سلسله‌مراتب بصری
- سازگاری با RTL
- مشکلات نسخه موبایل

هیچ متنی را که در تصویر خوانا نیست حدس نزن.

تحلیل PDF و فایل

در نسخه‌ها و حساب‌های پشتیبانی‌شده می‌توان فایل را اضافه و درباره آن سؤال کرد.

نمونه:

این فایل را تحلیل کن.

1. موضوع اصلی
2. خلاصه هر بخش
3. اعداد و آمار مهم
4. نتیجه‌گیری
5. محدودیت‌های گزارش
6. سؤال‌هایی که فایل به آن‌ها پاسخ نمی‌دهد

برای هر ادعا شماره صفحه را ذکر کن.

برای فایل‌های طولانی، بهتر است محدوده سؤال را مشخص کنید. درخواست مبهم «این فایل را تحلیل کن» معمولاً خروجی سطحی‌تری تولید می‌کند.

تحلیل داده

این فایل CSV را بررسی کن.

ستون مبلغ برحسب تومان است.
موارد زیر را محاسبه و تحلیل کن:
- فروش ماهانه
- نرخ رشد
- محصولات پرفروش
- حاشیه سود
- مقادیر غیرعادی

محاسبات را از تفسیر جدا کن.
برای هر نتیجه روش محاسبه را توضیح بده.

محاسبات مهم را با Excel، Python یا ابزار آماری کنترل کنید.

تولید و ویرایش تصویر

بعضی مدل‌ها و قابلیت‌های Gemini می‌توانند تصویر تولید یا ویرایش کنند. خانواده مدل‌های تصویری Google با نام‌هایی مانند Nano Banana نیز شناخته شده‌اند.

قابلیت‌های مدل به نسخه و حساب بستگی دارد:

  • ساخت تصویر از متن
  • ویرایش تصویر
  • ترکیب تصاویر مرجع
  • تغییر پس‌زمینه
  • حفظ بعضی عناصر
  • ساخت نسخه‌های مختلف
  • افزودن یا حذف اشیا

پرامپت:

یک تصویر تبلیغاتی مربعی برای یک فنجان قهوه بساز.

سبک: عکاسی محصول حرفه‌ای
پس‌زمینه: کافه مدرن و گرم
نور: نور نرم صبحگاهی
ترکیب‌بندی: محصول در سمت چپ
فضای خالی: سمت راست برای تیتر فارسی
نسبت تصویر: 1:1
بدون نوشته و بدون لوگوی ساختگی

مقاله مستقلی درباره تولید عکس با Gemini و Nano Banana در ادامه این خوشه محتوایی منتشر خواهد شد.

Deep Research در Gemini چیست؟

Deep Research برای تحقیق چندمرحله‌ای و ساخت گزارش از منابع مختلف طراحی شده است. این قابلیت می‌تواند موضوع را به چند بخش تقسیم کند، منابع را بررسی و یک گزارش سازمان‌یافته تهیه کند.

پرامپت مناسب:

درباره بازار API هوش مصنوعی تحقیق کن.

محدوده:
- روند جهانی
- انواع مشتری
- مدل‌های درآمدی
- بازیگران اصلی
- ریسک‌ها
- فرصت‌های بازار ایران

قواعد:
- برای هر آمار، منبع و تاریخ ذکر کن.
- داده جهانی و ایران را جدا کن.
- از عددسازی و تخمین بدون منبع خودداری کن.
- واقعیت، تحلیل و استنباط را از هم جدا کن.

گزارش نهایی همچنان باید بررسی شود. ممکن است منبع اشتباه، قدیمی یا نامرتبط استفاده شده باشد.

Gems در Gemini چیست؟

Gems نسخه‌های سفارشی‌شده‌ای از Gemini هستند که می‌توان برای یک وظیفه یا سبک کاری مشخص پیکربندی کرد.

برای مثال:

  • ویراستار فارسی
  • دستیار برنامه‌نویسی
  • معلم زبان
  • تحلیلگر محتوا
  • دستیار تحقیق
  • تولیدکننده توضیحات محصول

دستور Gem پیشنهادی:

نقش شما ویراستار فارسی محتوای فنی است.

وظایف:
- اصلاح نگارش و نشانه‌گذاری
- حفظ معنی فنی
- یکسان‌سازی اصطلاحات
- کوتاه‌کردن جملات طولانی
- حفظ کدها و URLها
- استفاده هم‌زمان از شکل فارسی و انگلیسی اصطلاحات مهم

محدودیت:
- اطلاعات جدید اضافه نکن.
- عدد، نام مدل و مشخصات فنی را تغییر نده.

بهترین روش پرامپت‌نویسی برای Gemini

یک Prompt خوب معمولاً این اجزا را دارد:

نقش
+
هدف
+
زمینه
+
داده ورودی
+
محدودیت
+
فرمت خروجی
+
معیار کیفیت

پرامپت ضعیف

درباره هوش مصنوعی بنویس.

پرامپت بهتر

یک مقدمه ۲۵۰ کلمه‌ای برای مقاله‌ای درباره API هوش مصنوعی بنویس.

مخاطب:
برنامه‌نویسان فارسی‌زبان مبتدی

هدف:
توضیح تفاوت استفاده از اپلیکیشن Chat با استفاده از API

لحن:
فنی، روشن و غیرتبلیغاتی

محدودیت:
از آمار بدون منبع استفاده نکن.
اصطلاح API را هم به انگلیسی و هم فارسی به کار ببر.

پرامپت‌های کاربردی Gemini

یادگیری

مفهوم RAG را به من آموزش بده.

سطح من: برنامه‌نویس Backend مبتدی در AI
ساختار:
1. تعریف ساده
2. معماری
3. مثال واقعی
4. شبه‌کد
5. اشتباهات رایج
6. تمرین عملی

حل مسئله مرحله‌ای

این مسئله را تحلیل کن.
ابتدا فرض‌ها را فهرست کن.
سپس راه‌حل‌های ممکن را مقایسه کن.
در پایان یک پیشنهاد همراه با دلیل بده.
اگر اطلاعات کافی نیست، سؤال‌های لازم را مطرح کن.

تحقیق

برای موضوع زیر یک برنامه تحقیق بساز.
ادعاها را به منبع نیازمند و غیرنیازمند تقسیم کن.
کلیدواژه‌های جست‌وجوی فارسی و انگلیسی پیشنهاد بده.

مقاله سئو

برای کلمه کلیدی «هوش مصنوعی گوگل» ساختار مقاله SEO طراحی کن.

شامل:
- Search Intent
- کلمات مرتبط
- عنوان H1
- تیترهای H2 و H3
- پرسش‌های متداول
- پیشنهاد لینک داخلی
- CTA

از Keyword Stuffing خودداری کن.

برنامه‌نویسی

یک API با Node.js و TypeScript طراحی کن.
ورودی را با Zod اعتبارسنجی کن.
خطاها را ساختاریافته برگردان.
API Key را از متغیر محیطی بخوان.
کد Production-ready و همراه تست باشد.

آیا Gemini همیشه پاسخ درست می‌دهد؟

خیر. Gemini مانند دیگر مدل‌های زبانی ممکن است:

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

برای کاهش خطا:

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

حریم خصوصی در Gemini

قبل از واردکردن اطلاعات، تنظیمات حساب، نوع حساب و سیاست‌های روز Google را بررسی کنید.

این اطلاعات را بدون مجوز سازمان وارد نکنید:

  • رمز عبور
  • API Key
  • اطلاعات کارت بانکی
  • کد ملی
  • اطلاعات پزشکی
  • قرارداد محرمانه
  • کد اختصاصی منتشرنشده
  • فهرست مشتریان
  • اطلاعات حقوق کارکنان
  • داده‌های مالی داخلی
  • اسناد حقوقی محرمانه

برای استفاده سازمانی، سیاست‌های Workspace، نگهداری داده و سطح دسترسی باید توسط تیم فنی و حقوقی بررسی شوند.

Gemini و تشخیص محتوای تولیدشده با AI

Google از فناوری SynthID برای قراردادن Watermark نامرئی در بعضی محتوای تولید یا ویرایش‌شده توسط مدل‌های خود استفاده می‌کند. Gemini همچنین ابزارهایی برای بررسی SynthID و Content Credentials در محتوای پشتیبانی‌شده دارد. راهنمای رسمی بررسی محتوای AI در Gemini

نبود Watermark اثبات نمی‌کند یک محتوا واقعی است. فایل ممکن است با مدل دیگری ساخته یا متادیتای آن حذف شده باشد.

تفاوت Gemini رایگان و نسخه‌های پولی

امکانات و محدودیت‌ها ممکن است براساس این موارد متفاوت باشند:

  • نوع حساب Google
  • کشور
  • سن
  • حساب شخصی یا Workspace
  • پلن Google AI
  • مدل انتخابی
  • تعداد درخواست
  • حجم فایل
  • قابلیت Deep Research
  • تولید تصویر یا ویدئو
  • Context Window
  • دسترسی به مدل‌های پیشرفته

از درج قیمت ثابت در مقاله خودداری می‌کنیم، زیرا پلن‌ها و قیمت‌ها ممکن است تغییر کنند. برای اطلاعات دقیق، صفحه رسمی Gemini و Google One را بررسی کنید.

Gemini برای برنامه‌نویسان

توسعه‌دهندگان می‌توانند Gemini را برای این کاربردها به محصول متصل کنند:

  • چت‌بات
  • تحلیل اسناد
  • تولید محتوا
  • استخراج داده
  • طبقه‌بندی متن
  • پردازش تصویر
  • تولید کد
  • جست‌وجوی هوشمند
  • دستیار سازمانی
  • Agent
  • پاسخ‌گویی پشتیبانی

Google مستندات Gemini API، Google AI Studio و SDKهای مختلف را در Google AI for Developers ارائه می‌کند.

مدل‌های Gemini

مدل‌های Google مرتب به‌روزرسانی می‌شوند. در زمان نگارش این مقاله، مستندات توسعه‌دهندگان Google به خانواده‌های جدید Gemini 3.x و Gemini 3.5 اشاره می‌کنند؛ اما بعضی مدل‌ها Preview هستند و نام، وضعیت و مشخصات آن‌ها ممکن است تغییر کند.

به‌جای قرار دادن Model ID ثابت در برنامه، بهتر است:

  • فهرست مدل‌ها را از API یا کاتالوگ دریافت کنید.
  • مدل را در تنظیمات نگه دارید.
  • قابلیت‌های آن را بررسی کنید.
  • نسخه Preview را بدون تست وارد Production نکنید.
  • برای حذف یا Deprecation مدل برنامه مهاجرت داشته باشید.

API رسمی Google یک Endpoint برای مشاهده مدل‌ها و اطلاعاتی مانند محدودیت ورودی، محدودیت خروجی و روش‌های پشتیبانی‌شده ارائه می‌کند. مستندات رسمی Models در Gemini API

اتصال به مدل‌های Google از طریق API درواره

برای دسترسی به مدل‌های موجود در کاتالوگ درواره:

  1. وارد درواره شوید.
  2. حساب کاربری بسازید.
  3. کیف پول را شارژ کنید.
  4. API Key ایجاد کنید.
  5. کاتالوگ مدل‌ها را بررسی کنید.
  6. مدل Google موردنظر را در صورت موجودبودن انتخاب کنید.
  7. درخواست را به Base URL درواره ارسال کنید.

Base URL:

https://api.darvareh.ir/v1

مزیت معماری OpenAI-Compatible این است که در بسیاری از پروژه‌ها می‌توان با تغییر Base URL، API Key و Model ID از مدل‌های مختلف استفاده کرد.

نمونه استفاده با Python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DARVAREH_API_KEY"],
    base_url="https://api.darvareh.ir/v1"
)

response = client.chat.completions.create(
    model="YOUR_GEMINI_MODEL_ID",
    messages=[
        {
            "role": "system",
            "content": (
                "به فارسی دقیق و روشن پاسخ بده. "
                "اگر اطلاعات کافی نیست، آن را اعلام کن."
            )
        },
        {
            "role": "user",
            "content": (
                "تفاوت REST API و WebSocket را "
                "با مثال توضیح بده."
            )
        }
    ],
    temperature=0.2
)

print(
    response.choices[0].message.content
)

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

نمونه Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.DARVAREH_API_KEY,
  baseURL: "https://api.darvareh.ir/v1"
});

const response =
  await client.chat.completions.create({
    model: "YOUR_GEMINI_MODEL_ID",
    messages: [
      {
        role: "system",
        content:
          "به زبان فارسی، دقیق و ساختاریافته پاسخ بده."
      },
      {
        role: "user",
        content:
          "یک راهنمای کوتاه برای طراحی REST API بنویس."
      }
    ],
    temperature: 0.2
  });

console.log(
  response.choices[0].message.content
);

نمونه cURL

curl https://api.darvareh.ir/v1/chat/completions \
  -H "Authorization: Bearer $DARVAREH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_GEMINI_MODEL_ID",
    "messages": [
      {
        "role": "user",
        "content": "هوش مصنوعی چندوجهی را به فارسی توضیح بده."
      }
    ]
  }'

کلید API را در Frontend قرار ندهید

این کد ناامن است:

const apiKey = "sk-...";

اگر کلید در JavaScript مرورگر قرار بگیرد، کاربران می‌توانند آن را مشاهده و استخراج کنند.

معماری امن:

Frontend
   ↓
Backend شما
   ↓
API درواره
   ↓
مدل Gemini یا مدل انتخابی

API Key را در متغیر محیطی Backend نگهداری کنید:

DARVAREH_API_KEY=your_api_key

انتخاب مدل مناسب

برای انتخاب مدل این معیارها را بررسی کنید:

  • کیفیت فارسی
  • سرعت پاسخ
  • قیمت ورودی و خروجی
  • Context Window
  • پشتیبانی از تصویر
  • پشتیبانی از فایل
  • Structured Output
  • Tool Calling
  • Streaming
  • وضعیت Stable یا Preview
  • محدودیت نرخ
  • کاربرد برنامه‌نویسی
  • کیفیت استدلال

مدل بزرگ‌تر همیشه بهترین انتخاب نیست. برای دسته‌بندی ساده، مدل سریع و ارزان می‌تواند مناسب‌تر باشد.

مدیریت هزینه Gemini API

هزینه استفاده از API ممکن است براساس این موارد محاسبه شود:

  • Token ورودی
  • Token خروجی
  • تصویر
  • صوت
  • ویدئو
  • Context طولانی
  • نوع مدل
  • قابلیت خاص

برای کاهش هزینه:

  • Prompt را کوتاه و دقیق بنویسید.
  • تاریخچه غیرضروری را حذف کنید.
  • خروجی را محدود کنید.
  • فایل بزرگ را بخش‌بندی کنید.
  • پاسخ‌های تکراری را Cache کنید.
  • برای کار ساده از مدل سبک‌تر استفاده کنید.
  • مصرف هر کاربر را ثبت کنید.
  • سقف بودجه قرار دهید.
  • نسخه Preview را بدون ارزیابی هزینه استفاده نکنید.

Gemini بهتر است یا ChatGPT؟

پاسخ به نوع استفاده بستگی دارد.

Gemini در اکوسیستم Google، ورودی‌های چندوجهی و بعضی گردش‌های کاری متصل به سرویس‌های Google مزیت دارد. ChatGPT نیز در گفت‌وگو، ابزارها، تحلیل فایل، برنامه‌نویسی و اکوسیستم OpenAI قابلیت‌های گسترده‌ای ارائه می‌کند.

برای انتخاب باید با یک مجموعه تست ثابت مقایسه کنید:

  • سؤال فارسی
  • خلاصه PDF
  • تولید کد
  • تحلیل تصویر
  • خروجی JSON
  • سرعت
  • هزینه
  • دقت
  • حریم خصوصی
  • دسترسی API

به‌جای انتخاب براساس تبلیغات، مدل‌ها را با داده واقعی پروژه خود ارزیابی کنید.

Gemini بهتر است یا DeepSeek؟

DeepSeek بیشتر به‌خاطر مدل‌های استدلال و برنامه‌نویسی شناخته می‌شود. Gemini یک اکوسیستم گسترده‌تر شامل اپلیکیشن، مدل‌های چندوجهی و سرویس‌های Google دارد.

انتخاب به این عوامل بستگی دارد:

  • نوع مسئله
  • زبان فارسی
  • نیاز چندوجهی
  • هزینه
  • سرعت
  • Context
  • نیاز به Tool Calling
  • شرایط داده
  • دسترسی API

Gemini بهتر است یا Claude؟

Claude در تحلیل متن، اسناد طولانی و برنامه‌نویسی کاربرد زیادی دارد. Gemini نیز در تحلیل چندوجهی و اکوسیستم Google قدرتمند است. کیفیت آن‌ها بسته به Prompt و نسخه مدل تغییر می‌کند.

در یک محصول حرفه‌ای بهتر است معماری Multi-Model داشته باشید تا در صورت نیاز مدل را تغییر دهید. API یکپارچه درواره نیز برای ساده‌ترشدن همین نوع دسترسی طراحی شده است.

اشتباهات رایج در استفاده از Gemini

نوشتن پرامپت مبهم

یک متن خوب بنویس.

هدف، مخاطب، لحن و طول مشخص نیست.

اعتماد کامل به پاسخ

Gemini ممکن است اطلاعات نادرست تولید کند.

ارسال فایل محرمانه

سیاست داده و مجوز سازمان باید بررسی شود.

درخواست عدد بدون منبع

از مدل بخواهید منبع و تاریخ ارائه کند و سپس آن را کنترل کنید.

اجرای مستقیم کد

کد AI ممکن است آسیب‌پذیر یا ناسازگار باشد.

قرار دادن API Key در Frontend

کلید باید در Backend نگهداری شود.

استفاده از یک مدل برای همه کارها

برای هر Workflow مدل مناسب را انتخاب کنید.

استفاده از Model ID قدیمی

نام و وضعیت مدل‌ها تغییر می‌کنند. کاتالوگ را بررسی کنید.

چک‌لیست استفاده حرفه‌ای

  • هدف درخواست مشخص است.
  • زبان و لحن تعیین شده‌اند.
  • Context کافی ارائه شده است.
  • فرمت خروجی مشخص است.
  • منبع برای ادعاهای مهم درخواست شده است.
  • پاسخ با منبع اولیه مقایسه شده است.
  • داده محرمانه حذف شده است.
  • کد آزمایش شده است.
  • API Key در Backend قرار دارد.
  • مدل از تنظیمات انتخاب می‌شود.
  • مصرف توکن ثبت می‌شود.
  • Timeout و Retry وجود دارد.
  • خروجی JSON اعتبارسنجی می‌شود.
  • مدل Preview قبل از محیط واقعی ارزیابی می‌شود.
  • برای پاسخ حساس Human Review وجود دارد.

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

هوش مصنوعی گوگل چیست؟

Gemini نام خانواده مدل‌ها و دستیار هوش مصنوعی Google است که برای تولید متن، تحلیل فایل و تصویر، برنامه‌نویسی، تحقیق و وظایف چندوجهی استفاده می‌شود.

Gemini به فارسی چه می‌شود؟

تلفظ رایج آن در فارسی «جمینای» است. بعضی کاربران «جمنای» یا «جمینی» نیز جست‌وجو می‌کنند، اما «جمینای» در فارسی رایج‌تر است.

آدرس سایت هوش مصنوعی گوگل چیست؟

نشانی رسمی نسخه وب:

https://gemini.google.com

آیا Gemini رایگان است؟

بعضی قابلیت‌ها ممکن است به‌صورت رایگان با محدودیت ارائه شوند و مدل‌ها یا امکانات پیشرفته به پلن پولی نیاز داشته باشند. وضعیت پلن‌ها ممکن است تغییر کند.

آیا Gemini فارسی است؟

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

آیا هوش مصنوعی گوگل در ایران باز می‌شود؟

در زمان نگارش این مقاله، ایران در فهرست رسمی کشورهای پشتیبانی‌شده نسخه وب Gemini دیده نمی‌شود. صفحه رسمی Google را برای تغییرات بعدی بررسی کنید.

چگونه Gemini را دانلود کنیم؟

در کشورهای پشتیبانی‌شده، نسخه موبایل را فقط از Google Play یا App Store دریافت کنید. نسخه وب نیز بدون نصب در مرورگر قابل استفاده است.

آیا Gemini عکس می‌سازد؟

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

آیا Gemini فایل PDF را می‌خواند؟

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

آیا Gemini برای برنامه‌نویسی مناسب است؟

بله. می‌تواند کد تولید، توضیح، بازنویسی و خطایابی کند. کد باید قبل از استفاده در Production تست و بازبینی شود.

آیا می‌توان Gemini را به سایت متصل کرد؟

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

آیا درواره Gemini ارائه می‌کند؟

مدل‌های موجود ممکن است با گذشت زمان تغییر کنند. برای مشاهده مدل‌های Google قابل‌دسترسی، کاتالوگ روز درواره را بررسی کنید.

Base URL درواره چیست؟

https://api.darvareh.ir/v1

جمع‌بندی

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

برای دریافت پاسخ بهتر، Prompt باید هدف، Context، محدودیت و فرمت خروجی روشنی داشته باشد. خروجی Gemini نیز مانند هر مدل هوش مصنوعی دیگری ممکن است اشتباه باشد و باید در موضوعات مهم بررسی شود.

توسعه‌دهندگان می‌توانند قابلیت‌های مدل‌های Google را از طریق API به محصول خود اضافه کنند. برای مشاهده مدل‌های موجود، دریافت API Key و استفاده از API یکپارچه با پرداخت ریالی، وارد درواره شوید. Base URL درواره https://api.darvareh.ir/v1 است.

مقالات مرتبط

Read more