# اتصال بلایندگرام به Google Gemini

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

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

## پیش‌نیازها

پیش از شروع بررسی کنید که:
- برنامه **بلایندگرام** و **دستیار بلایندگرام** روی گوشی اندرویدی شما نصب باشند.
- یک حساب گوگل (Gmail) برای ورود به Google AI Studio داشته باشید.
- اتصال پایدار اینترنت فراهم باشد.

## گام اول: دریافت کلید API رایگان از Google AI Studio

گوگل سهمیه رایگانی برای استفاده شخصی از Gemini در اختیارتان می‌گذارد:

1. در مرورگر گوشی یا رایانه، سایت [Google AI Studio](https://aistudio.google.com/) را باز کنید و با حساب گوگل خود وارد شوید.
2. روی دکمه **Get API key** (در نوار کناری یا بالای صفحه) بزنید.
3. گزینه **Create API key** را انتخاب کنید. در صورت نمایش لیست، یک پروژه موجود را انتخاب کرده یا گزینه ساخت کلید در پروژه جدید (**Create API key in new project**) را بزنید.
4. پنجره‌ای شامل کلید ساخته‌شده شما (رشته‌ای طولانی که معمولاً با `AIza` شروع می‌شود) نمایش داده می‌شود.
5. روی **Copy** بزنید تا کلید در حافظه موقت (کلیپ‌بورد) کپی شود.

> **نکته امنیتی:** کلید API مانند رمز عبور شماست؛ آن را در اختیار دیگران قرار ندهید. این کلید فقط روی گوشی شما ذخیره شده و صرفاً همراه هر درخواست مستقیماً به سرور گوگل فرستاده می‌شود.

## گام دوم: وارد کردن کلید در دستیار بلایندگرام

1. برنامه **بلایندگرام** را باز کنید.
2. از منوی اصلی وارد مسیر **تنظیمات** > **ناحیه بلایندگرام** > **دستیار** > **هوش مصنوعی** شوید.
3. در بخش **سرویس**:
   - روی **ارائه‌دهنده** بزنید و **Gemini** را انتخاب کنید.
   - روی **کلید API** بزنید و کلیدی که کپی کرده بودید را جای‌گذاری (Paste) کنید.
   - تأیید کنید تا ذخیره شود.

## گام سوم: انتخاب مدل هوش مصنوعی

در سطر **مدل** می‌توانید مدل پردازشگر Gemini را مشخص کنید:

- **Gemini 1.5 Flash یا Gemini 2.0 Flash (پیشنهادی):** سریع، دقیق و سبک. مناسب‌ترین گزینه برای دریافت پاسخ‌های فوری در صفحه‌خوان تاک‌بک با کمترین تأخیر.
- **Gemini 1.5 Pro:** قدرت استدلال بالاتر و تحلیل دقیق‌تر جزئیات، مناسب برای بررسی تصاویر پیچیده یا اسناد متنی پرجزئیات.
- **مدل‌های دیگر / دریافت مدل‌ها:** به شما امکان می‌دهد لیست جدیدترین مدل‌ها را مستقیماً از گوگل دریافت کنید یا شناسه مدل مورد نظرتان را دستی تایپ نمایید.

## گام چهارم: فعال‌سازی امکانات هوش مصنوعی

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

- **توصیف دقیق تصویر:** در بخش **توصیف تصویر**، کلید **توصیف با جزئیات** را روشن کنید. هنگام باز کردن یا اشتراک عکس، تصویر برای Gemini فرستاده می‌شود و توصیف کامل به شکل پیام صوتی یا متنی خوانده می‌شود.
- **خلاصه پیام صوتی:** در بخش **خلاصه صوتی**، کلید **خلاصه با هوش مصنوعی** را روشن کنید تا دکمه «خلاصه پیام صوتی» در منوی پیام‌های صوتی ظاهر شود.
- **خلاصه پیام متنی:** در بخش **خلاصه متنی**، گزینه **خلاصه پیام‌ها** را فعال کنید تا پیام‌های طولانی فشرده شوند.
- **پرسش درباره پیام‌ها:** در بخش **پرسش درباره پیام‌ها**، گزینه **پرسش از هوش مصنوعی درباره هر پیام** را روشن کنید تا بتوانید با هوش مصنوعی درباره هر عکس، ویس یا متن گفتگو کنید.

## حل مشکلات و خطاهای رایج

### مشکل: خطای نامعتبر بودن کلید (API Key Invalid)
- **علت:** ممکن است هنگام کپی کردن کلید، نویسه‌ای جا افتاده یا فاصله اضافی کپی شده باشد.
- **راه‌حل:** مجدداً وارد Google AI Studio شوید، کلید را کپی کنید و مطمئن شوید در ابتدا و انتهای آن فاصله نباشد.

### مشکل: خطای پایان سهمیه یا Resource Exhausted (کد ۴۲۹)
- **علت:** سهمیه رایگان گوگل دارای محدودیت تعداد درخواست در دقیقه (RPM) و روز (RPD) است.
- **راه‌حل:** حدود یک دقیقه صبر کرده و دوباره درخواست دهید. در صورت تکرار، وضعیت مصرف سهمیه را در پنل AI Studio بررسی کنید.

### مشکل: خطای اتصال یا قطعی اینترنت
- **علت:** دسترسی به دامنه سرویس‌های گوگل (`generativelanguage.googleapis.com`) ممکن است در برخی شبکه‌ها محدود باشد.
- **راه‌حل:** اطمینان حاصل کنید که اتصال اینترنت شما برقرار است و دسترسی به سرویس‌های گوگل مسدود نیست. در صورت استفاده از پروکسی، دستیار از طریق اتصال امن کار خواهد کرد.

### مشکل: عدم تشخیص صوت در خلاصه پیام‌های صوتی
- **علت:** Gemini به صورت پیش‌فرض اندپوینت تبدیل صوت به متن ندارد.
- **راه‌حل:** دستیار بلایندگرام ابتدا با موتور تبدیل گفتار به متن گوشی شما ویس را پیاده کرده و سپس متن را برای خلاصه به Gemini می‌فرستد. اطمینان حاصل کنید زبان صوتی مورد نظر روی موتور تبدیل گفتار به متن گوشی نصب باشد.

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

### آیا استفاده از Gemini در بلایندگرام رایگان است؟
بله، سهمیه پایه Google AI Studio برای مصارف شخصی و روزمره رایگان است و هزینه‌ای ندارد.

### تاریخچه گفتگوها و پاسخ‌ها کجا ذخیره می‌شوند؟
همه پاسخ‌ها و گفتگوهای هوش مصنوعی تا یک هفته در بخش [گفتگوهای هوش مصنوعی](/docs/assistant/ai/conversations/) نگهداری می‌شوند و قابل مرور هستند.