خانه → راهنماها → Chatbox با API سفارشی: هاست، مسیر، Claude و ساخت تصویر

Chatbox با API سفارشی: هاست، مسیر، Claude و ساخت تصویر

در Chatbox، API سفارشی در سه جا ممکن است خراب شود: جفت API Host و API Path، حالت Claude که /v1 می‌خواهد در حالی که Claude Code آن را ممنوع می‌کند، و Image Creator که ارائه‌دهنده‌های سفارشی را کاملاً نادیده می‌گیرد. کد منبع Chatbox 1.23.5 را خواندیم، همهٔ ترکیب‌ها را روی درگاه خودمان آزمودیم و خطاهای کاربران واقعی Chatbox را جمع کردیم.

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

1. Settings ← Model Provider را باز کنید و روی Add Custom Provider بزنید. نامی بدهید و API Mode را روی OpenAI API Compatible بگذارید.
2. در API Host مقدار https://apiclan.us را وارد کنید و API Path را خالی بگذارید.
3. کلید API را از کنسول بچسبانید.
4. روی Fetch بزنید تا مدل‌های گروه کلیدتان بارگذاری شود، سپس با Check کلید را بیازمایید.

API Host	API Path	Chatbox فراخوانی می‌کند
https://apiclan.us	(خالی)	/v1/chat/completions ✓
https://apiclan.us/v1	/chat/completions	/v1/chat/completions ✓
https://apiclan.us	/chat/completions	/chat/completions ✗ 404

Chatbox فقط وقتی API Path خالی است /v1 را به هاست اضافه می‌کند. به محض وارد کردن مسیر، هاست همان‌طور که هست به کار می‌رود؛ پس https://apiclan.us همراه /chat/completions بخش /v1 را جا می‌اندازد و 404 با بدنهٔ خالی برمی‌گرداند. یا مسیر را خالی بگذارید یا /v1 را در هاست بنویسید.

افزودن Claude

دو راه هست و قاعدهٔ نشانی در آن‌ها فرق دارد:

API Mode	API Host	Chatbox فراخوانی می‌کند
OpenAI API Compatible	https://apiclan.us	/v1/chat/completions ✓
Claude API Compatible	https://apiclan.us/v1	/v1/messages ✓
Claude API Compatible	https://apiclan.us	/messages ✗ 404

ساده‌ترین راه، یک ارائه‌دهندهٔ سفارشی دوم در حالت OpenAI API Compatible با کلیدی از گروه Claude است؛ ۲۹ مورد از ۴۳ درخواست Chatbox که ثبت کردیم claude-fable-5-1 بود که دقیقاً همین‌طور فرستاده شده بود. اگر Claude API Compatible را ترجیح می‌دهید، هاست باید به /v1 ختم شود، چون Chatbox فقط /messages را اضافه می‌کند. این برعکس Claude Code است که در آن ANTHROPIC_BASE_URL نباید /v1 داشته باشد.

ساخت تصویر در Chatbox

Image Creator فقط ارائه‌دهندهٔ داخلی OpenAI (و خود Chatbox و Gemini) را نشان می‌دهد. ارائه‌دهنده‌های سفارشی در کد به‌طور ثابت مدل تصویر ندارند و با Provider doesnt support image generation شکست می‌خورند.

1. Settings ← Model Provider ← OpenAI را باز کنید (همان داخلی، نه ارائه‌دهندهٔ سفارشی خودتان).
2. API Host را https://api.apiclan.us بگذارید و کلیدی را که در گروه تصویر ساخته‌اید بچسبانید.
3. مدل gpt-image-2.5 را اضافه کنید و Model Type آن را Image بگذارید.
4. Image Creator را باز کنید و gpt-image-2.5 را برگزینید.

مدل‌های گفت‌وگو را در ارائه‌دهندهٔ سفارشی نگه دارید: هر کلید فقط به یک گروه تعلق دارد، پس کلید تصویر در ارائه‌دهندهٔ OpenAI نمی‌تواند مدل‌های گفت‌وگوی GPT را اجرا کند. این‌جا از api.apiclan.us استفاده می‌کنیم چون یک تصویر بزرگ ممکن است چند دقیقه طول بکشد و نشانی اصلی پاسخ را پس از ۱۰۰ ثانیه قطع می‌کند. درخواست آزمایشی ما با قالب Chatbox یک تصویر 1024×1024 را در ۲۱ ثانیه برگرداند.

هزینهٔ درخواست‌های واقعی Chatbox

همهٔ ۴۳ درخواست Chatbox به درگاه ما در ۳۰ روز منتهی به ۱۲ اکتبر ۲۰۲۶، همگی به‌صورت جریانی از طریق /v1/chat/completions:

مدل	درخواست	نخستین توکن (میانه)	میانگین هر پیام
claude-fable-5-1	29	5.2 s	$0.039
gpt-6-astra	8	1.4 s	$0.006
gpt-5.6-sol	6	7.6 s	$0.004

این‌جا هر پاسخ Claude حدود هفت برابر یک پاسخ GPT هزینه داشت، بیشتر چون پاسخ‌ها طولانی‌تر بودند (به‌طور میانگین ۶۲۲ توکن خروجی). Chatbox در هر نوبت کل گفت‌وگو را دوباره می‌فرستد، اما در Claude به‌طور میانگین ۴٬۰۷۱ توکن در هر درخواست به‌عنوان خواندن از حافظهٔ نهان حساب شد نه ورودی با قیمت کامل، و همین گفت‌وگوهای طولانی را مقرون‌به‌صرفه نگه می‌دارد. gpt-5.6-sol ارزان‌ترین بود اما دیرتر از همه شروع کرد، چون پیش از پاسخ استدلال می‌کند.

خطاهایی که کاربران واقعی Chatbox دیدند

• 404 با بدنهٔ خالی ← API Path پر شده ولی هاست /v1 ندارد، یا Claude API Compatible بدون /v1. جدول‌های بالا را ببینید.
• 400 This model is not supported on the Chat Completions endpoint ← gpt-image-2.5 به‌عنوان مدل گفت‌وگو انتخاب شده. مدل‌های تصویر فقط در Image Creator کار می‌کنند.
• 403 Image generation is not enabled for this group ← کلید ارائه‌دهندهٔ OpenAI از گروه تصویر نیست.
• 404 model_not_found (is not supported by any configured account in this group) ← این مدل در گروه کلید شما نیست (کاربری gpt-5.2-pro را تایپ کرده بود که ما ارائه نمی‌دهیم). به‌جای تایپ نام از Fetch استفاده کنید.
• Provider doesnt support image generation ← Image Creator به یک ارائه‌دهندهٔ سفارشی اشاره می‌کند. از ارائه‌دهندهٔ داخلی OpenAI استفاده کنید.

کلاینت‌های دسکتاپ دیگر: Cherry Studio با API سفارشی · Base URL برای Claude Code.

شروع به استفاده کنید

بدون اشتراک، بدون حداقل ماهانه، بدون تماس فروش. با USDT شارژ کنید و فقط به‌اندازهٔ مصرف بپردازید — 1 USDT برابر 2 اعتبار موجودی API است.

راهنمای 30 ثانیه‌ای شروع سریع را بخوانید

زبان: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

قیمت‌های این صفحه به‌طور خودکار از داده‌های واقعی صورتحساب پر می‌شوند. شرایط اشخاص ثالث از مستندات خودشان نقل شده است.