# اتصال بلایندگرام به OpenAI (ChatGPT)

راهنمای نحوه اتصال دستیار بلایندگرام به مدل‌های رسمی OpenAI (شامل GPT-4o، GPT-4o-mini و تبدیل صوت Whisper). راهنمای ساخت کلید API، تنظیم مدل‌ها و رفع خطاهای پرداخت.

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

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

- یک حساب توسعه‌دهنده در [platform.openai.com](https://platform.openai.com/).
- اعتبار پیش‌پرداخت (حساب توسعه‌دهنده مجزا از اشتراک ماهانه وب ChatGPT Plus است).
- برنامه بلایندگرام و دستیار بلایندگرام روی گوشی اندروید.

## گام اول: ساخت کلید API در OpenAI

1. به پنل توسعه‌دهندگان [OpenAI Platform](https://platform.openai.com/) رفته و وارد شوید.
2. در بخش **Settings** > **Billing** اطمینان حاصل کنید حساب شما دارای اعتبار است (شارژ ۵ دلار برای ماه‌ها استفاده شخصی در تلگرام کافی است).
3. از نوار کناری وارد بخش **API keys** شوید.
4. روی **Create new secret key** بزنید.
5. یک نام انتخاب کرده (مثلاً `blindGram Assistant`) و کلید را بسازید.
6. کلید ساخته‌شده (که با `sk-proj-...` شروع می‌شود) را کپی کنید.

> **نکته:** OpenAI کلید مخفی را فقط یک بار نشان می‌دهد؛ بلافاصله آن را کپی کنید.

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

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

## گام سوم: تنظیم مدل‌های متن، تصویر و صدا

چون OpenAI هم از گفتگوی متنی و هم از پردازش صوت پشتیبانی می‌کند، دو ردیف برای تنظیم دارید:

- **مدل (متن و تصویر):**
  - `gpt-4o-mini` (پیشنهادی): بسیار کم‌هزینه و سریع با دقت بالا در توصیف عکس‌ها و متون.
  - `gpt-4o`: بالاترین سطح استدلال برای خواندن اسناد سخت، دست‌خط و تصاویر پیچیده.
- **مدل صوتی (Whisper):**
  - مدل `whisper-1` را انتخاب کنید. در این حالت، ویس‌ها مستقیماً به Whisper ارسال شده و با دقت فوق‌العاده بالایی به متن تبدیل می‌شوند.

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

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

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

### مشکل: خطای پایان سهمیه (You exceeded your current quota / 429)
- **علت:** اعتبار حساب توسعه‌دهنده شما در OpenAI صفر شده است. توجه کنید اشتراک ماهیانه ۲۰ دلاری ChatGPT Plus جدا از اعتبار API است.
- **راه‌حل:** به [platform.openai.com/billing](https://platform.openai.com/billing) بروید و ۵ دلار حساب را شارژ کنید.

### مشکل: خطای نامعتبر بودن کلید (Incorrect API key)
- **علت:** کلید کپی‌شده ناقص است یا فاصله اضافی دارد.
- **راه‌حل:** در پنل OpenAI یک کلید جدید بسازید و مستقیماً کپی و جای‌گذاری کنید.

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

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

### آیا اشتراک ChatGPT Plus اینجا کار می‌کند؟
خیر، سرویس وب با API تفاوت دارد. بلایندگرام به API متصل می‌شود که هزینه آن بر اساس تعداد کلمات محاسبه شده و بسیار ارزان‌تر است.

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