اتصال به برنامهها
سیستمعامل و برنامهتان را انتخاب کنید؛ راهنمای قدمبهقدم با کلید و مدل خودتان آماده میشود.
۱ سیستمعامل
۲ برنامه
کلید فقط در مرورگر شما جایگزین میشود و جایی ارسال نمیشود.
وارد شوید تا بتوانید همینجا کلید بسازید.
ضریب مصرف هر مدل در صفحهی مدلها آمده است.
راهنمای اتصال ChatterUI
Android · ۷ قدم-
۱
انتخاب یا ساخت کلید API
از بالای همین صفحه کلید کامل خود را بچسبانید یا با دکمهی «ساخت کلید جدید برای این برنامه» یک کلید تازه بسازید؛ کدهای این راهنما خودکار با کلید و مدل انتخابی شما پر میشوند.
کلید کامل فقط یک بار، هنگام ساخت، نمایش داده میشود. آن را در جای امنی نگه دارید و در گروهها یا اسکرینشاتها منتشر نکنید.
-
۲
نصب ChatterUI
ChatterUI رایگان و متنباز است و فقط از صفحهی Releases در GitHub منتشر میشود. از آخرین نسخه، فایل
.apkرا دانلود و نصب کنید (اگر گوشی پرسید، اجازهی نصب از منبع ناشناس را بدهید). -
۳
رفتن به حالت Remote
منوی بالا چپ را باز کنید و کلید بالای منو را از
LocalرویRemoteبزنید. سپسAPIرا باز کنید؛ صفحهای با عنوانConnectionsباز میشود. -
۴
ساخت اتصال
دکمهی
Add Connectionرا بزنید، در فهرست پایین بروید وChat Completionsرا انتخاب کنید (برای ارسال عکس:Chat Completions (Vision/Audio))، سپسCreate. -
۵
وارد کردن آدرس و کلید
در پنجرهی
Edit Connectionفیلدها را اینطور پر کنید وSaveرا بزنید:Friendly Name2928
Completion URLhttps://api.2928.ir/v1/chat/completions
API Keysk-...Model URLhttps://api.2928.ir/v1/models
Completion URL باید مسیر کامل باشد (خود اپ زیرش نوشته Use full URL path)؛ فقط
https://api.2928.ir/v1کار نمیکند. -
۶
انتخاب مدل
ChatterUI فهرست مدلها را بعد از اولین ذخیره میگیرد. دوباره روی آیکن مداد اتصال
2928بزنید: دکمهی کنار Model URL بایدConnectedباشد (قبل از ذخیرهی اولFailed To Connectنوشته؛ نگران نباشید). ازModel←Select Itemمدلclaude-sonnet-5را انتخاب کنید و دوبارهSaveبزنید. مطمئن شوید کلید کنار اتصال2928روشن است. -
۷
ساخت کاراکتر و گفتگو
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 استفاده کنید. وضعیت لحظهای مدلها در صفحهی «وضعیت سرویس» است.
بگویید در کدام قدم ماندید و متن خطا را بفرستید.