API هوش مصنوعی

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

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

۱ سیستم‌عامل

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

۲ برنامه

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

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

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

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

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

Android · ۷ قدم
  1. ۱

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

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

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

  2. ۲

    نصب ChatterUI

    ChatterUI رایگان و متن‌باز است و فقط از صفحه‌ی Releases در GitHub منتشر می‌شود. از آخرین نسخه، فایل .apk را دانلود و نصب کنید (اگر گوشی پرسید، اجازه‌ی نصب از منبع ناشناس را بدهید).

  3. ۳

    رفتن به حالت Remote

    منوی بالا چپ را باز کنید و کلید بالای منو را از Local روی Remote بزنید. سپس API را باز کنید؛ صفحه‌ای با عنوان Connections باز می‌شود.

  4. ۴

    ساخت اتصال

    دکمه‌ی Add Connection را بزنید، در فهرست پایین بروید و Chat Completions را انتخاب کنید (برای ارسال عکس: Chat Completions (Vision/Audio))، سپس Create.

  5. ۵

    وارد کردن آدرس و کلید

    در پنجره‌ی Edit Connection فیلدها را این‌طور پر کنید و Save را بزنید:

    Friendly Name
    2928
    Completion URL
    https://api.2928.ir/v1/chat/completions
    API Key
    sk-...
    Model URL
    https://api.2928.ir/v1/models

    Completion URL باید مسیر کامل باشد (خود اپ زیرش نوشته Use full URL path)؛ فقط https://api.2928.ir/v1 کار نمی‌کند.

  6. ۶

    انتخاب مدل

    ChatterUI فهرست مدل‌ها را بعد از اولین ذخیره می‌گیرد. دوباره روی آیکن مداد اتصال 2928 بزنید: دکمه‌ی کنار Model URL باید Connected باشد (قبل از ذخیره‌ی اول Failed To Connect نوشته؛ نگران نباشید). از Model ← Select Item مدل claude-sonnet-5 را انتخاب کنید و دوباره Save بزنید. مطمئن شوید کلید کنار اتصال 2928 روشن است.

  7. ۷

    ساخت کاراکتر و گفتگو

    ChatterUI برای گفتگو یک «کاراکتر» لازم دارد. به صفحه‌ی اصلی برگردید، آیکن آدمک بالا راست را بزنید، Create Character را انتخاب کنید، یک نام (مثلاً Assistant) بنویسید و Create بزنید؛ در صفحه‌ی بعد Save و بازگشت. روی کاراکتر بزنید و پیام بفرستید.

    تست‌شده با ChatterUI نسخه‌ی ۰.۱۰.۱.

خطاهای رایج

401 (Unauthorized)
کلید اشتباه است، ناقص چسبانده شده، یا کلمه‌ی «Bearer» را خودتان جلوی کلید نوشته‌اید (برنامه خودش اضافه می‌کند). فقط خود کلید sk-... را وارد کنید.
403 (اعتبار تمام شده)
اعتبار حساب تمام یا منقضی شده است. از صفحه‌ی «خرید اعتبار» بسته بخرید یا تمدید کنید.
503 — model_not_found
نام مدل اشتباه است. نام را دقیقاً از صفحه‌ی «مدل‌ها» کپی کنید.
404 یا «اتصال ناموفق»
این برنامه آدرس کامل می‌خواهد: https://api.2928.ir/v1/chat/completions. اگر فقط https://api.2928.ir/v1 یا آدرس بدون /v1 بنویسید، درخواست به جای درست نمی‌رسد.
پاسخ دیر شروع می‌شود
مدل‌های بزرگ (Opus، GPT-6 و Sol) گاهی چند ثانیه تا ده‌ها ثانیه قبل از شروع پاسخ فکر می‌کنند؛ برای کارهای سریع از Sonnet یا Haiku استفاده کنید. وضعیت لحظه‌ای مدل‌ها در صفحه‌ی «وضعیت سرویس» است.
کمک لازم دارید؟

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

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