API هوش مصنوعی

اتصال به برنامه‌ها

سیستم‌عامل و برنامه‌تان را انتخاب کنید؛ راهنمای قدم‌به‌قدم با کلید و مدل خودتان آماده می‌شود.

۱ سیستم‌عامل

Windows
ویندوز ۱۰ و ۱۱
macOS
مک
Linux
اوبونتو، فدورا و…
Android
گوشی و تبلت اندروید

۲ برنامه

RikkaHub
پیشنهاد ما — رایگان و متن‌باز
ChatterUI
رایگان و متن‌باز، نصب از GitHub
Layla
از Google Play

کلید فقط در مرورگر شما جایگزین می‌شود و جایی ارسال نمی‌شود.

وارد شوید تا بتوانید همین‌جا کلید بسازید.

ضریب مصرف هر مدل در صفحه‌ی مدل‌ها آمده است.

راهنمای اتصال RikkaHub

Android · ۶ قدم
  1. ۱

    انتخاب یا ساخت کلید API

    از بالای همین صفحه کلید کامل خود را بچسبانید یا با دکمه‌ی «ساخت کلید جدید برای این برنامه» یک کلید تازه بسازید؛ کدهای این راهنما خودکار با کلید و مدل انتخابی شما پر می‌شوند.

    کلید کامل فقط یک بار، هنگام ساخت، نمایش داده می‌شود. آن را در جای امنی نگه دارید و در گروه‌ها یا اسکرین‌شات‌ها منتشر نکنید.

  2. ۲

    نصب RikkaHub

    RikkaHub رایگان و متن‌باز است. فقط از یکی از این دو منبع رسمی نصب کنید: سایت rikka-ai.com/download (پیشنهاد خود سازنده) یا Google Play.

    نسخه‌های کپی (fork) زیادی از RikkaHub با همین اسم منتشر شده؛ از جای دیگری نصب نکنید چون ممکن است کلید شما را بدزدند.

  3. ۳

    باز کردن Providers

    در صفحه‌ی اصلی، منوی ☰ بالا چپ را باز کنید و از پایین منو آیکن تنظیمات (شش‌ضلعی) را بزنید. در صفحه‌ی Settings، زیر بخش Models & Services روی Providers بزنید.

  4. ۴

    افزودن ارائه‌دهنده

    دکمه‌ی + بالا راست را بزنید. در پنجره‌ی Add Provider نوع OpenAI را انتخاب‌شده بگذارید و فیلدها را این‌طور پر کنید:

    Name
    2928
    API Key
    sk-...
    API Base Url
    https://api.2928.ir/v1
    API Path
    /chat/completions

    API Path همان مقدار پیش‌فرض است، تغییرش ندهید. Enable روشن بماند و Response API خاموش. در آخر دکمه‌ی Add را بزنید.

  5. ۵

    افزودن مدل‌ها

    ارائه‌دهنده‌ی جدید ته فهرست اضافه می‌شود؛ در کادر Search providers عبارت 2928 را بنویسید و رویش بزنید. از نوار پایین تب Models را باز کنید. کنار دکمه‌ی Add New Model آیکنی با یک عدد هست (تعداد مدل‌هایی که RikkaHub از سرور ما گرفته)؛ رویش بزنید و در فهرست Avaliable Models گزینه‌ی Select All را بزنید، یا فقط مدل‌های دلخواه را با + اضافه کنید.

    اگر به‌جای عدد چیزی نمی‌بینید یا فهرست خالی است، کلید یا آدرس اشتباه است؛ به تب Configuration برگردید و دوباره بررسی کنید.

  6. ۶

    انتخاب مدل و گفتگو

    به صفحه‌ی چت برگردید. آیکن مدل در پایین چپِ کادر پیام را بزنید، زیر گروه 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 استفاده کنید. وضعیت لحظه‌ای مدل‌ها در صفحه‌ی «وضعیت سرویس» است.
کمک لازم دارید؟

بگویید در کدام قدم ماندید و متن خطا را بفرستید.

تماس با پشتیبانی