اتصال به برنامه‌ها
سیستم‌عامل و برنامه‌تان را انتخاب کنید؛ راهنمای قدم‌به‌قدم با کلید و مدل خودتان آماده می‌شود.
۱ سیستم‌عامل
۲ برنامه
برای اپ رسمی Claude فقط مدل‌های Claude قابل استفاده است؛ برای گفتگو با GPT روی دسکتاپ از Cherry Studio استفاده کنید.
کلید فقط در مرورگر شما جایگزین می‌شود و جایی ارسال نمی‌شود.
وارد شوید تا بتوانید همین‌جا کلید بسازید.
ضریب مصرف هر مدل در صفحه‌ی مدل‌ها آمده است.
راهنمای اتصال Cherry Studio
macOS · ۶ قدم-
۱
انتخاب یا ساخت کلید API
از بالای همین صفحه کلید کامل خود را بچسبانید یا با دکمه‌ی «ساخت کلید جدید برای این برنامه» یک کلید تازه بسازید؛ کدهای این راهنما خودکار با کلید و مدل انتخابی شما پر می‌شوند.
کلید کامل فقط یک بار، هنگام ساخت، نمایش داده می‌شود. آن را در جای امنی نگه دارید و در گروه‌ها یا اسکرین‌شات‌ها منتشر نکنید.
-
۲
نصب Cherry Studio
Cherry Studio را از سایت رسمی
cherry-ai.comیا صفحه‌ی GitHub آن دانلود و نصب کنید. -
۳
افزودن ارائه‌دهنده
Settings (چرخ‌دنده) ← Model Provider را باز کنید. پایین فهرست روی
+ Addبزنید، یک نام دلخواه بنویسید و نوع ارائه‌دهنده راOpenAIبگذارید. -
۴
وارد کردن کلید و آدرس
API Keysk-...API Addresshttps://api.2928.ir
Cherry Studio خودش
/v1را اضافه می‌کند؛ پیش‌نمایش آدرس زیر فیلد باید بهhttps://api.2928.ir/v1/chat/completionsختم شود. -
۵
افزودن مدل
در بخش Models همان صفحه روی
+ Addبزنید و نام مدل را وارد کنید، سپس ارائه‌دهنده را روشن (Enable) کنید:Model IDclaude-sonnet-5
-
۶
تست و گفتگو
دکمه‌ی Check کنار کلید را بزنید؛ سپس در صفحه‌ی گفتگو مدل
claude-sonnet-5را از بالای پنجره انتخاب کنید و پیام بدهید.
خطاهای رایج
- 401 (Unauthorized)
- کلید اشتباه است یا ناقص چسبانده شده. کلید کامل را دوباره وارد کنید و مطمئن شوید فاصله یا خط جدید اضافه ندارد.
- 403 (اعتبار تمام شده)
- اعتبار حساب تمام یا منقضی شده است. از صفحه‌ی «خرید اعتبار» بسته بخرید یا تمدید کنید.
- 503 — model_not_found
- نام مدل اشتباه است. نام را دقیقاً از صفحه‌ی «مدل‌ها» کپی کنید.
- 404 (Not Found)
- آدرس پایه باید
https://api.2928.ir/v1باشد. خود برنامه مسیر/chat/completionsرا اضافه می‌کند؛ آن را به آدرس اضافه نکنید. - پاسخ دیر شروع می‌شود
- مدل‌های بزرگ (Opus، GPT-6 و Sol) گاهی چند ثانیه تا ده‌ها ثانیه قبل از شروع پاسخ فکر می‌کنند؛ برای کارهای سریع از Sonnet یا Haiku استفاده کنید. وضعیت لحظه‌ای مدل‌ها در صفحه‌ی «وضعیت سرویس» است.
بگویید در کدام قدم ماندید و متن خطا را بفرستید.