اتصال به برنامهها
سیستمعامل و برنامهتان را انتخاب کنید؛ راهنمای قدمبهقدم با کلید و مدل خودتان آماده میشود.
۱ سیستمعامل
۲ برنامه
کلید فقط در مرورگر شما جایگزین میشود و جایی ارسال نمیشود.
وارد شوید تا بتوانید همینجا کلید بسازید.
ضریب مصرف هر مدل در صفحهی مدلها آمده است.
راهنمای اتصال RikkaHub
Android · ۶ قدم-
۱
انتخاب یا ساخت کلید API
از بالای همین صفحه کلید کامل خود را بچسبانید یا با دکمهی «ساخت کلید جدید برای این برنامه» یک کلید تازه بسازید؛ کدهای این راهنما خودکار با کلید و مدل انتخابی شما پر میشوند.
کلید کامل فقط یک بار، هنگام ساخت، نمایش داده میشود. آن را در جای امنی نگه دارید و در گروهها یا اسکرینشاتها منتشر نکنید.
-
۲
نصب RikkaHub
RikkaHub رایگان و متنباز است. فقط از یکی از این دو منبع رسمی نصب کنید: سایت
rikka-ai.com/download(پیشنهاد خود سازنده) یا Google Play.نسخههای کپی (fork) زیادی از RikkaHub با همین اسم منتشر شده؛ از جای دیگری نصب نکنید چون ممکن است کلید شما را بدزدند.
-
۳
باز کردن Providers
در صفحهی اصلی، منوی ☰ بالا چپ را باز کنید و از پایین منو آیکن تنظیمات (ششضلعی) را بزنید. در صفحهی Settings، زیر بخش
Models & ServicesرویProvidersبزنید. -
۴
افزودن ارائهدهنده
دکمهی
+بالا راست را بزنید. در پنجرهیAdd ProviderنوعOpenAIرا انتخابشده بگذارید و فیلدها را اینطور پر کنید:Name2928
API Keysk-...API Base Urlhttps://api.2928.ir/v1
API Path/chat/completions
API Path همان مقدار پیشفرض است، تغییرش ندهید.
Enableروشن بماند وResponse APIخاموش. در آخر دکمهیAddرا بزنید. -
۵
افزودن مدلها
ارائهدهندهی جدید ته فهرست اضافه میشود؛ در کادر
Search providersعبارت2928را بنویسید و رویش بزنید. از نوار پایین تبModelsرا باز کنید. کنار دکمهیAdd New Modelآیکنی با یک عدد هست (تعداد مدلهایی که RikkaHub از سرور ما گرفته)؛ رویش بزنید و در فهرستAvaliable ModelsگزینهیSelect Allرا بزنید، یا فقط مدلهای دلخواه را با+اضافه کنید.اگر بهجای عدد چیزی نمیبینید یا فهرست خالی است، کلید یا آدرس اشتباه است؛ به تب
Configurationبرگردید و دوباره بررسی کنید. -
۶
انتخاب مدل و گفتگو
به صفحهی چت برگردید. آیکن مدل در پایین چپِ کادر پیام را بزنید، زیر گروه
2928مدلclaude-sonnet-5را انتخاب کنید و یک پیام کوتاه مثلsay hiبفرستید. زیر هر پاسخ، تعداد توکن ورودی و خروجی و زمان پاسخ را میبینید.تستشده با RikkaHub نسخهی ۲.۵.۶ و مدلهای Claude و GPT.
خطاهای رایج
- 401 (Unauthorized)
- کلید اشتباه است یا ناقص چسبانده شده. کلید کامل را دوباره وارد کنید و مطمئن شوید فاصله یا خط جدید اضافه ندارد.
- 403 (اعتبار تمام شده)
- اعتبار حساب تمام یا منقضی شده است. از صفحهی «خرید اعتبار» بسته بخرید یا تمدید کنید.
- 503 — model_not_found
- نام مدل اشتباه است. نام را دقیقاً از صفحهی «مدلها» کپی کنید.
- 404 یا فهرست مدل خالی
- API Base Url باید دقیقاً
https://api.2928.ir/v1باشد و API Path همان/chat/completions. آدرس بدون/v1کار نمیکند (تکرار/v1/v1را خود سرور درست میکند). - پاسخ دیر شروع میشود
- مدلهای بزرگ (Opus، GPT-6 و Sol) گاهی چند ثانیه تا دهها ثانیه قبل از شروع پاسخ فکر میکنند؛ برای کارهای سریع از Sonnet یا Haiku استفاده کنید. وضعیت لحظهای مدلها در صفحهی «وضعیت سرویس» است.
بگویید در کدام قدم ماندید و متن خطا را بفرستید.