اتصال به برنامهها
سیستمعامل و برنامهتان را انتخاب کنید؛ راهنمای قدمبهقدم با کلید و مدل خودتان آماده میشود.
۱ سیستمعامل
۲ برنامه
کلید فقط در مرورگر شما جایگزین میشود و جایی ارسال نمیشود.
وارد شوید تا بتوانید همینجا کلید بسازید.
ضریب مصرف هر مدل در صفحهی مدلها آمده است.
راهنمای اتصال 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.
-
۷
ساخت عکس (مدلهای gpt-image)
مدلهای ساخت عکس مثل
gpt-image-2مدل چت نیستند و از صفحهی چت کار نمیکنند. اگر مدل ساخت عکس را اضافه کردهاید، این مراحل را انجام دهید: (۱) در تبModelsارائهدهندهی2928روی مدل عکس بزنید و نوع (Type) آن را ازChatبهImageتغییر دهید و ذخیره کنید. (۲) به صفحهی اصلی برگردید، منوی ☰ را باز کنید و بخش ساخت تصویر (Image Generation) را بزنید. (۳) در همان صفحه مدل عکس را انتخاب کنید، توضیح عکس را بنویسید و بفرستید.مدلی که نوعش
Imageباشد در فهرست مدلهای صفحهی چت نمیآید؛ این طبیعی است. ساخت هر عکس حدود ۲۰ تا ۴۵ ثانیه طول میکشد و هزینهاش برای هر عکس ثابت است (صفحهی «مدلها»).اگر مدل عکس را در صفحهی چت انتخاب کنید، خطای
This model is not supported on the Chat Completions endpointمیگیرید.
خطاهای رایج
- 401 (Unauthorized)
- کلید اشتباه است یا ناقص چسبانده شده. کلید کامل را دوباره وارد کنید و مطمئن شوید فاصله یا خط جدید اضافه ندارد.
- 403 (اعتبار تمام شده)
- اعتبار حساب تمام یا منقضی شده است. از صفحهی «خرید اعتبار» بسته بخرید یا تمدید کنید.
- 503 — model_not_found
- نام مدل اشتباه است. نام را دقیقاً از صفحهی «مدلها» کپی کنید.
- 404 یا فهرست مدل خالی
- API Base Url باید دقیقاً
https://api.2928.ir/v1باشد و API Path همان/chat/completions. آدرس بدون/v1کار نمیکند (تکرار/v1/v1را خود سرور درست میکند). - This model is not supported on the Chat Completions endpoint
- یک مدل ساخت عکس (مثل
gpt-image-2) را برای چت انتخاب کردهاید. مدلهای عکس فقط از بخش ساخت تصویر برنامه کار میکنند، نه از صفحهی چت؛ برای گفتگو یک مدل Claude یا GPT انتخاب کنید. - پاسخ دیر شروع میشود
- مدلهای بزرگ (Opus، GPT-6 و Sol) گاهی چند ثانیه تا دهها ثانیه قبل از شروع پاسخ فکر میکنند؛ برای کارهای سریع از Sonnet یا Haiku استفاده کنید. وضعیت لحظهای مدلها در صفحهی «وضعیت سرویس» است.
بگویید در کدام قدم ماندید و متن خطا را بفرستید.