هر مدل کاتالوگ را به Chatbox با یک provider سفارشی اضافه کنید.
Updated 2026-07-29
Chatbox یک جریان Add Custom Provider برای هر endpoint سازگار با OpenAI ارائه میدهد: حالت OpenAI API Compatible را انتخاب کنید، API Host را روی https://api.apisrouter.com/v1 تنظیم کنید، یک کلید paste کنید، و id های Claude، GPT، Gemini، و DeepSeek کنار هم در انتخابگر مدل روی دسکتاپ، موبایل، و وب مینشینند.
پاسخ سریع: یک دیالوگ در تنظیمات Model Provider.
تنظیمات Chatbox را باز کنید و به تب Model Provider سوییچ کنید. روی Add کلیک کنید، سپس Add Custom Provider. دیالوگ را با پنج مقدار پر کنید: یک Name (APIsRouter)، API Mode تنظیمشده روی OpenAI API Compatible، کلید خود در API Key، https://api.apisrouter.com/v1 در API Host، و API Path را روی پیشفرض /chat/completions که Chatbox برای یک host به /v1 ختمشده پر میکند رها کنید. سپس مدلها را اضافه کنید. دکمه Fetch فهرست مدل endpoint را از طریق /v1/models میکشد پس میتوانید id ها را مستقیم از کاتالوگ فعال کنید، و New اجازه میدهد اگر یک انتخابگر curated کوتاه ترجیح میدهید یک id را دستی تایپ کنید. روی Check کنار فیلد کلید کلیک کنید و Chatbox یک درخواست زنده اجرا میکند؛ یک تأیید سبز یعنی provider سیمکشی شده. ما دقیقاً همین جریان را در برابر اپ وب فعلی Chatbox اعتبارسنجی کردیم، و همان دیالوگ در build های دسکتاپ و موبایل هم ship میشود.
Chatbox چطور با یک provider سفارشی صحبت میکند.
Chatbox (chatboxai روی GitHub، حدود ۴۱ هزار ستاره) یکی از نصبشدهترین کلاینتهای چت AI است: اپهای native برای ویندوز، macOS، و لینوکس، build های موبایل برای iOS و اندروید، و یک نسخه مرورگری در web.chatboxai.app. با entry های first-party برای vendor های بزرگ ship میشود، هرکدام کلید خودشان را میخواهند، و دیالوگ provider سفارشی مسیر مستند برای هرچیز دیگر است. یک provider سفارشی در حالت OpenAI API Compatible یک توصیف ساده از یک endpoint است: host، مسیر، کلید، و یک فهرست id مدل. هر turn مکالمه به یک درخواست chat-completions استاندارد در برابر آن host تبدیل میشود، با id مدل از انتخابگر که بهعنوان یک رشته سفر میکند. Chatbox اهمیتی نمیدهد کدام vendor مدل پشت یک id را train کرده، که دقیقاً همان چیزی است که یک gateway چند-vendor اینجا مفید میکند: یک entry provider claude-sonnet-4-6، gpt-5.5، gemini-3.5-flash، و deepseek-v4-flash را در همان انتخابگر قرار میدهد، صورتحسابشده از طریق همان کلید. تفاوت عملی نسبت به انباشتن چهار provider first-party فقط کلیدهای کمتر نیست. تنظیمات Chatbox به ازای هر دستگاه sync میشوند، پس هر حساب vendor ای که اضافه میکنید یک کلید دیگر است که باید روی گوشی، لپتاپ، و اپ وب خود paste کنید. یک provider سفارشی یک paste به ازای هر دستگاه است، و سوییچ یک مکالمه از Claude به DeepSeek یک تغییر انتخابگر است نه تغییر provider.
راهاندازی کامل: هر فیلد داخل دیالوگ.
Name فقط یک برچسب است؛ APIsRouter انتخابگر را خوانا نگه میدارد. API Mode باید OpenAI API Compatible باشد، که به Chatbox میگوید chat completions استاندارد صحبت کند؛ حالت دیگر در dropdown برای endpoint های native Gemini است و چیزی که یک gateway میخواهد نیست. API Host و API Path به یک URL درخواست ترکیب میشوند، و این جفت جایی است که راهاندازیها اشتباه میشوند. با host تنظیمشده روی https://api.apisrouter.com/v1، مسیر /chat/completions است، و Chatbox دقیقاً همین را وقتی یک host /v1 را تشخیص دهد پر میکند. مستندات Chatbox قرارداد host-برهنه را هم توصیف میکنند، جایی که host /v1 را حذف میکند و مسیر بهطور پیشفرض /v1/chat/completions است؛ هر دو به همان URL ترکیب میشوند، پس یک شکل را انتخاب کنید و فیلد دیگر را روی پیشفرضش رها کنید. چیزی که میشکند مخلوطکردن آنهاست، یک host /v1 با یک مسیر /v1/chat/completions، که یک URL دوبارشده /v1/v1 تولید میکند که 404 میدهد. برچسبهای فیلد و رفتار autofill کمی بین release های Chatbox تغییر میکند، پس به URL ترکیبشده اعتماد کنید نه حافظه. برای مدلها، Fetch مسیر کمزحمت است: Chatbox هرچه endpoint سرویس میدهد را فهرست میکند و شما آنچه میخواهید را toggle میکنید. New مسیر curated است: id ها را دستی تایپ کنید و انتخابگر کوتاه بماند. هر ردیف مدل toggle های قابلیت دارد (vision، tool use)؛ آنها را خاموش رها کنید مگر بدانید مدل آن قابلیت را پشتیبانی میکند، چون یک مدل پیکربندینشده بهعنوان متن ساده رفتار میشود و آن پیشفرض امن است. با Check تمام کنید، سپس یک مکالمه شروع کنید و زیر نام provider جدید خود یک مدل انتخاب کنید.
Name: APIsRouter
API Mode: OpenAI API Compatible
API Key: sk-YOUR-APISROUTER-KEY
API Host: https://api.apisrouter.com/v1
API Path: /chat/completions (autofilled)
Models: Fetch (pull the catalog) or New (type ids)
Then: Check → green confirmationانتخاب مدل برای یک کلاینت چت روزانه.
چون هر مدل فعالشده از طریق یک کلید صورتحساب میشود، مقایسه دو id یک سوییچ انتخابگر است نه یک تصمیم حساب. همان نوع مکالمات را روی هر دو برای چند روز اجرا کنید، سپس هزینه هر-مدل را در کنسول APIsRouter بخوانید و آنچه جایگاهش را کسب کرد نگه دارید.
- سؤالات روزمره و بازنویسی سریع کار انفجاریاند. claude-haiku-4-5-20251001 و gemini-3.5-flash آنقدر سریع پاسخ میدهند که اپ فوری حس میشود، و بیشتر ترافیک روزانه را خوب حمل میکنند.
- پیشنویسی بلند، استدلال دقیق، و بحثهای کد ارزش claude-sonnet-4-6 یا gpt-5.5 را دارند. یکی از هر رده را فعال نگه دارید و به ازای هر مکالمه نه به ازای هر provider سوییچ کنید.
- deepseek-v4-flash انتخاب حجمی است اگر Chatbox sidebar همیشه-باز شماست؛ مکالمات کوچک مداوم جمع میشوند و رده سریع موجودی را آهسته حرکت نگه میدارد.
- مکالمات ورودی-تصویر به یک id vision-پذیر با toggle vision فعال روی آن ردیف مدل نیاز دارند؛ قابلیت را در برابر مستندات مدل تأیید کنید قبل از زدن toggle.
- مدلهای کمی را عمدی فعال کنید بهجای fetch کردن همه؛ هر toggle یک ردیف انتخابگر است، و اضافهکردن id دیگری بعداً یک ویرایش ده-ثانیهای است.
پرداخت بر اساس مصرف · پایینتر از قیمت رسمی
Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.
| مدل | قیمت رسمی | قیمت ما |
|---|---|---|
| Claude Sonnet 4.6 | $3.00 / $15.00 per M | $2.40 / $12.00 per M |
| Claude Haiku 4.5 20251001 | $1.00 / $5.00 per M | $0.80 / $4.00 per M |
| GPT-5.5 | $5.00 / $30.00 per M | $4.00 / $24.00 per M |
| Gemini 3.5 Flash | $1.50 / $9.00 per M | $1.20 / $7.20 per M |
| DeepSeek V4 Flash | $0.14 / $0.28 per M | $0.10 / $0.30 per M |
حالتهای شکست مختص Chatbox.
مسیر دوبار کلاسیک است. یک 404 روی هر پیام یعنی API Host و API Path هر دو یک /v1 حمل میکنند یا مسیر آنچه host از قبل به آن ختم میشود را تکرار میکند؛ entry provider را باز کنید و دو فیلد را بهعنوان یک URL بخوانید. یک نتیجه خالی از Fetch معمولاً یعنی کلید اشتباه یا غایب است، چون فهرست مدل خودش یک درخواست احراز-هویتشده است. فیلد API Key را چک کنید و از دکمه Check استفاده کنید، که خطاهای احراز هویت را مستقیم نشان میدهد. یک مدل که فقط در بعضی مکالمات خطا میدهد معمولاً یک toggle قابلیت است: vision فعال روی مدلی که ورودی تصویر ندارد، یا یک جریان وابسته-به-ابزار که به یک مدل با tools خاموش میخورد. ردیف مدل را روی پیشفرضها ریست کنید و قابلیتها را یکییکی دوباره فعال کنید. و بهخاطر داشته باشید entry provider به ازای هر نصب زندگی میکند. اضافهکردن APIsRouter روی دسکتاپ شما گوشیتان را پیکربندی نمیکند؛ دیالوگ را آنجا هم تکرار کنید، یا از اشتراکگذاری پیکربندی خود Chatbox استفاده کنید اگر نسخه شما آن را ارائه میدهد. تنها چیزی که هرگز نیاز به تکرار ندارد ثبتنام vendor است، چون یک کلید هر مدل روی هر دستگاه را پوشش میدهد.
چه کسانی Chatbox را از طریق یک gateway مسیردهی میکنند.
- افرادی که میخواهند Claude، GPT، Gemini، و DeepSeek در یک انتخابگر باشند بدون نگهداری چهار حساب vendor و چهار کلید روی سه دستگاه.
- کاربران در مناطقی که برخی ثبتنامهای vendor دردناک است؛ دسترسی مبتنی بر شارژ بدون الزام کارت وابستگی هر-provider را حذف میکند.
- توسعهدهندگانی که از قبل ویرایشگر و ابزار ترمینال خود را از طریق یک gateway مسیردهی میکنند و میخواهند کلاینت چت خود روی همان کلید و همان لاگ usage باشد.
- خریداران مدل که id ها را روی مکالمات واقعی مقایسه میکنند قبل از تعهد یک پروژه به یکی؛ هر کاندید یک ردیف انتخابگر است، نه یک حساب.
- خانوادهها و تیمهای کوچک که روی یک endpoint، یک موجودی، و قابلیتمشاهده usage هر-کلید بهجای اشتراکهای پراکنده استاندارد میشوند.
endpoint را تأیید کنید و اولین پیام را عیبیابی کنید.
اول نیمه gateway را بیرون از Chatbox اثبات کنید: مدلها را با کلید خود فهرست کنید، سپس یک chat completion در برابر یک id ای که قصد فعالکردنش را دارید اجرا کنید. اگر هر دو موفق شوند، هر چیز باقیمانده در دیالوگ provider است. داخل Chatbox، دکمه Check سریعترین سیگنال است. خطاهای احراز هویت فیلد کلید هستند. خطاهای not-found هنگام ارسال یک عدمتطابق id هستند، که بیشتر با entry های دستی New اتفاق میافتد؛ id ها را از خروجی /v1/models کپی کنید نه از حافظه. 404 روی هر درخواست ترکیب host/path پوششدادهشده بالاست. وقتی پیامها جریان یابند، کنسول APIsRouter مدل، شمارش token، و هزینه به ازای هر درخواست را نشان میدهد. یک کلاینت چت در طول روز درخواستهای کوچک بسیاری تولید میکند، و لاگ usage جایی است که آن عادت به یک عدد هر-مدل، هر-روز واقعاً قابلخواندن تبدیل میشود.
curl -s https://api.apisrouter.com/v1/models \
-H "Authorization: Bearer $APISROUTER_API_KEY" | head -50
curl -s https://api.apisrouter.com/v1/chat/completions \
-H "Authorization: Bearer $APISROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"claude-haiku-4-5-20251001",
"messages":[{"role":"user","content":"ping"}]}'پرسشهای پرتکرار
چطور یک API host سفارشی به Chatbox اضافه کنم؟
Settings، تب Model Provider، Add، سپس Add Custom Provider. API Mode را روی OpenAI API Compatible تنظیم کنید، API Host را روی https://api.apisrouter.com/v1، کلید خود را paste کنید، و API Path را روی پیشفرض /chat/completions رها کنید. مدلها را با Fetch یا New اضافه کنید، سپس Check را بزنید.
آیا API Host باید /v1 را شامل شود؟
هر دو شکل کار میکنند تا زمانی که host و path دقیقاً یک بار به /v1/chat/completions ترکیب شوند. با host یعنی https://api.apisrouter.com/v1 مسیر /chat/completions است؛ با یک host برهنه، مسیر بهطور پیشفرض /v1/chat/completions است. مخلوطکردن این دو /v1 را دوبار میکند و 404 میدهد.
آیا Chatbox میتواند Claude، Gemini، و DeepSeek را از طریق یک entry provider اجرا کند؟
بله. در حالت OpenAI API Compatible، id مدل بهعنوان یک رشته ساده به API Host سفر میکند، پس یک entry میتواند claude-sonnet-4-6، gemini-3.5-flash، و deepseek-v4-flash را با هم فعال کند، همه از طریق همان کلید صورتحسابشده و قابلتعویض در انتخابگر.
چرا Fetch هیچ مدلی برنمیگرداند؟
Fetch فهرست /v1/models endpoint را با کلید شما فراخوانی میکند، پس یک نتیجه خالی تقریباً همیشه یک مشکل احراز هویت است. فیلد API Key را دوباره چک کنید و دکمه Check را اجرا کنید؛ وقتی کلید موفق شود، Fetch هر id ای که gateway سرویس میدهد را فهرست میکند.
آیا provider سفارشی روی موبایل و وب Chatbox هم کار میکند؟
بله، دیالوگ Add Custom Provider در build های دسکتاپ، موبایل، و وب ship میشود. entry های provider به ازای هر نصب پیکربندی میشوند، پس راهاندازی یک-دیالوگ را روی هر دستگاه با همان کلید تکرار کنید.
آیا باید toggle های قابلیت را روی هر مدل تنظیم کنم؟
نه. یک مدل پیکربندینشده بهعنوان چت متن ساده کار میکند، که پیشفرض امن است. toggle های vision یا tool را فقط روی مدلهایی که واقعاً آن قابلیت را پشتیبانی میکنند فعال کنید، چون یک toggle اشتباه فعالشده دقیقاً در همان مکالماتی که از آن استفاده میکنند خطاهای گیجکننده تولید میکند.