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

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

سرویس OpenRouter ارائه‌دهنده پیش‌فرض در بلایندگرام است؛ زیرا با یک حساب کاربری واحد می‌توانید به صدها مدل هوش مصنوعی از شرکت‌های مختلف (Meta Llama، Mistral، گوگل، Claude و OpenAI) دسترسی داشته باشید، از جمله مدل‌های متعددی که کاملاً رایگان هستند.

## چرا استفاده از OpenRouter پیشنهاد می‌شود؟

- **صدها مدل با یک کلید:** بدون نیاز به ساخت چندین حساب در سایت‌های مختلف، می‌توانید بین Llama 3، Mistral یا Claude جابه‌جا شوید.
- **مدل‌های کاملاً رایگان:** دسترسی به مدل‌های قدرتمندی که بدون وارد کردن کارت اعتباری کار می‌کنند.
- **کنترل حریم خصوصی:** تنظیمات شفاف ذخیره‌سازی داده‌ها مستقیماً در پنل OpenRouter در دسترس است.

## گام اول: ثبت‌نام و دریافت کلید API

1. در مرورگر خود سایت [OpenRouter](https://openrouter.ai/) را باز کنید.
2. با حساب گوگل یا ایمیل خود یک حساب رایگان بسازید یا وارد شوید.
3. منوی کاربری (بالا سمت راست) را باز کرده و گزینه **Keys** را انتخاب کنید.
4. روی **Create Key** بزنید. یک نام برای آن انتخاب کنید (مثلاً `blindGram Phone`).
5. سقف اعتبار را خالی بگذارید یا مشخص کنید، سپس روی **Create** بزنید.
6. کلید ساخته‌شده (که با `sk-or-v1-...` شروع می‌شود) را کپی کنید.

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

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

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

## گام سوم: انتخاب مدل

در سطر **مدل** می‌توانید مدل مورد نظرتان را مشخص کنید:

- **مدل‌های رایگان (پیشنهادی برای شروع):**
  - `meta-llama/llama-3.3-70b-instruct:free` — قدرت استدلال عالی، سرعت بالا و کاملاً رایگان.
  - `google/gemini-2.0-flash-exp:free` — سرعت پردازش فوق‌العاده در درک تصاویر و پاسخ‌های کوتاه.
- **مدل‌های حرفه‌ای (نیازمند اعتبار):**
  - `anthropic/claude-3.5-sonnet` — درک عمیق جزئیات تصویر و نگارش فارسی طبیعی.
  - `openai/gpt-4o-mini` — تعادل فوق‌العاده میان هزینه کم و سرعت بالا.
- **دریافت مدل‌ها از ارائه‌دهنده:** با زدن این گزینه، فهرست زنده مدل‌ها دانلود شده و یک فیلد جستجو برای انتخاب بین صدها مدل در اختیارتان قرار می‌گیرد.

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

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

## حل مشکلات رایج

### مشکل: خطای مدل نامعتبر (Model Not Found)
- **علت:** ممکن است شناسه یک مدل رایگان تغییر کرده یا موقتاً از دسترس خارج شده باشد.
- **راه‌حل:** روی سطر **مدل** بزنید، گزینه **دریافت مدل‌ها** را انتخاب کنید و یکی از مدل‌های فعال روز را برگزینید.

### مشکل: خطای سهمیه یا محدودیت سرعت (۴۲۹ Rate Limit) در مدل‌های رایگان
- **علت:** مدل‌های رایگان در هر دقیقه سقف مشخصی برای کل کاربران عمومی دارند.
- **راه‌حل:** ۳۰ تا ۶۰ ثانیه صبر کرده و مجدداً تلاش کنید؛ یا با شارژ اندک حساب، از مدل‌های دارای اولویت بالا استفاده نمایید.

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

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

### آیا بدون پرداخت پول می‌توان از OpenRouter استفاده کرد؟
بله. مدل‌هایی که دارای پسوند `:free` هستند کاملاً رایگان بوده و بدون شارژ حساب کار می‌کنند.

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