هر مدل کاتالوگ را به Cherry Studio بهعنوان یک provider اضافه کنید.
Updated 2026-07-29
تنظیمات Model Services در Cherry Studio هر endpoint سازگار با OpenAI را میپذیرد: یک provider با نوع OpenAI اضافه کنید، API address را روی api.apisrouter.com تنظیم کنید، یک کلید paste کنید، و id های مدل را دستی اضافه کنید. Claude، GPT، DeepSeek، GLM، Kimi، و Qwen در یک انتخابگر روی دسکتاپ مینشینند.
پاسخ سریع: یک provider در Model Services.
روی آیکون چرخدنده در navigation سمت چپ Cherry Studio کلیک کنید، تب Model Services را باز کنید، و روی دکمه Add زیر فهرست provider کلیک کنید. یک نام قابلتشخیص به provider بدهید (APIsRouter) و OpenAI را بهعنوان نوع provider انتخاب کنید، سپس ذخیره کنید. حالا provider جدید را در فهرست انتخاب کنید و آن را پیکربندی کنید: toggle فعالسازی آن را بزنید، کلید خود را در فیلد API key paste کنید، و API address را روی https://api.apisrouter.com تنظیم کنید. به شکل توجه کنید: پیشفرض مستند Cherry Studio این است که آدرس ریشه را بگیرد و خودش /v1/chat/completions را پیوست کند، پس host را بدون /v1 وارد کنید. سپس با دکمه Add در بخش مدل مدلها را اضافه کنید، یک id دقیق کاتالوگ به ازای هر entry (claude-sonnet-4-6، deepseek-v4-flash، glm-5.2)، و روی دکمه Check کنار کلید کلیک کنید تا یک اعتبارسنجی زنده در برابر یک مدل انتخابشده اجرا شود.
Provider name: APIsRouter
Provider type: OpenAI
then, on the provider page:
API key: sk-YOUR-APISROUTER-KEY
API address: https://api.apisrouter.com
(Cherry appends /v1/chat/completions)
Models → + Add: claude-sonnet-4-6, deepseek-v4-flash, glm-5.2
Check → pick a model → successCherry Studio چطور URL درخواست را میسازد.
Cherry Studio (CherryHQ روی GitHub، حدود ۴۹ هزار ستاره) یک کلاینت دسکتاپ با منشأ چینی برای ویندوز، macOS، و لینوکس است، شناختهشده برای ارائه preset برای صدها provider و دستیار. هرچیزی که در فهرست preset نیست از طریق جریان provider سفارشی بالا وارد میشود، و بخشی که ارزش فهمیدن دارد فیلد API address است. پیشفرض مستند: شما آدرس ریشه را میدهید، و Cherry Studio مسیر OpenAI را روی آن concat میکند، پس https://api.apisrouter.com به https://api.apisrouter.com/v1/chat/completions روی سیم تبدیل میشود. اگر یک provider از یک مسیر غیراستاندارد استفاده کند، پایاندادن آدرس با # کاملاً concatenation را غیرفعال میکند و آدرس دقیقاً همانطور که تایپ شده استفاده میشود، که escape hatch مستند است. رفتار concatenation حول اسلشهای انتهایی بین release ها تغییر کرده، پس اگر درخواستها 404 میدهند، URL نهایی را در خطا بخوانید نه حدس بزنید؛ فرم آدرس-ریشه بهعلاوه پیوست خودکار پیکربندی پایدار برای یک gateway استاندارد /v1 است. وقتی پیکربندی شد، هر مکالمه chat completions استاندارد را با id مدلی که اضافه کردهاید بهعنوان یک رشته ساده میفرستد. vendor برای فرمت سیم اهمیتی ندارد، که اجازه میدهد یک entry provider id های کاتالوگ چینی و غربی را با هم حمل کند.
جزئیاتی که ارزش خود را ثابت میکنند: مدیریت چند-کلید و مدل.
فیلد API key بیش از یک کلید میپذیرد: کلیدها را با کاما انگلیسی جدا کنید و Cherry Studio از بالا به پایین به ازای هر درخواست بین آنها میچرخد، یک ویژگی load-balancing مستند. با یک gateway که به ازای هر کلید اندازهگیری میکند، این همزمان بهعنوان انتساب هم عمل میکند؛ یک کلید برای کار، یک کلید برای شخصی، چرخش خاموش با فهرستکردن فقط یک کلید. entry های مدل دستیاند و آن یک ویژگی است. Cherry Studio دقیقاً همانی که اضافه میکنید را نشان میدهد، پس انتخابگر curated میماند بهجای غرقشدن در یک کاتالوگ fetchشده. هر entry id را بهعنوان رشته سیم میگیرد؛ دکمه Manage entry ها را بعداً ویرایش یا حذف میکند. id های مرتبط را با نامگذاری ثابت گروهبندی کنید و انتخابگر مثل یک منو خوانده میشود: رده سریع (deepseek-v4-flash، claude-haiku-4-5-20251001)، قوت منطقهای (glm-5.2، qwen3.7-plus، kimi-k2.6)، مرزی (claude-sonnet-4-6). دکمه Check جفت کلید و آدرس را در برابر مدلی که انتخاب میکنید اعتبارسنجی میکند، و سریعترین راه تأیید provider قبل از مکالمات واقعی است. یک check شکستخورده با یک کلید درست تقریباً همیشه یعنی فیلد آدرس یک /v1 اضافه حمل میکند که مسیر را دوبار کرده.
curl -s https://api.apisrouter.com/v1/models \
-H "Authorization: Bearer $APISROUTER_API_KEY" | head -50
# add these ids verbatim in the provider's model listانتخاب مدل برای یک اسبکار دسکتاپ.
یک کلید یعنی مقایسهها تعویض انتخابگر هستند. همان هفته کار را روی دو id کاندید اجرا کنید و بگذارید هزینه هر-مدل در کنسول APIsRouter در برابر خوانش خودتان از کیفیت خروجی داوری کند.
- چت روزانه و بازنویسی سریع روی رده سریع زندگی میکنند: deepseek-v4-flash و claude-haiku-4-5-20251001 حس همیشه-باز پنجره را رایگان نگه میدارند.
- کار زبان چینی جایی است که id های منطقهای ردیفهای خود را کسب میکنند: glm-5.2 و qwen3.7-plus برای پیشنویس و اسناد، kimi-k2.6 برای خواندن long-context.
- claude-sonnet-4-6 مکالماتی که بدون ویرایش forward میکنید را میگیرد: تحلیل دقیق، نثر رو-به-مشتری، کدی که قصد shipکردنش را دارید.
- دستیارهای Cherry Studio میتوانند مدل خودشان را به ازای هر نقش pin کنند، پس یک دستیار ترجمه روی glm-5.2 و یک دستیار کدنویسی روی claude-sonnet-4-6 پشت یک provider همزیستی دارند.
- ردیفها را عمدی اضافه کنید؛ یک انتخابگر شش-مدلی curated استفاده میشود، در حالی که یک کاتالوگ pasteشده scroll میشود.
پرداخت بر اساس مصرف · پایینتر از قیمت رسمی
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 |
| DeepSeek V4 Flash | $0.14 / $0.28 per M | $0.10 / $0.30 per M |
| GLM-5.2 | $1.14 / $4.00 per M | $1.10 / $4.00 per M |
| Kimi K2.6 | $0.95 / $4.00 per M | $1.00 / $4.00 per M |
| Qwen 3.7 Plus | $0.29 / $1.14 per M | $0.30 / $1.10 per M |
حالتهای شکست مختص Cherry Studio.
مسیر دوبار پرگزارشترین است: paste کردن https://api.apisrouter.com/v1 در فیلدی که /v1/chat/completions را پیوست میکند URL های /v1/v1 تولید میکند که 404 میدهند. آدرس ریشه را وارد کنید و بگذارید کلاینت route را بسازد. اگر مجبورید یک URL دقیق را pin کنید، فرم # انتهایی برای همین وجود دارد. یک Check شکستخورده با یک کلید خوب معمولاً همان شکل آدرس بالاست؛ یک Check شکستخورده با یک آدرس تمیز کلید است، و توجه کنید چند کلید باید با کاما انگلیسی جدا شوند، چون کاراکترهای full-width pasteشده از روشهای ورودی چینی فهرست را بیصدا خراب میکنند. مدلهایی که بهتنهایی خطا میدهند در حالی که بقیه کار میکنند یک مشکل املای id است؛ entry ها متن آزادند و فهرست /v1/models منبع معتبر است. و بهخاطر داشته باشید تنظیمات به ازای هر دستگاه است: یک provider پیکربندیشده روی دسکتاپ شما روی لپتاپ شما وجود ندارد تا راهاندازی دو-دقیقهای را تکرار کنید یا از ویژگیهای backup خود Cherry Studio استفاده کنید. نکته drift نسخه: Cherry Studio مکرر ship میشود و برچسبهای تنظیمات جابهجا میشوند (Model Services در برخی build ها بهعنوان Model Provider هم ظاهر شده)؛ جریان اضافهکردن provider، انتخاب نوع OpenAI، کلید، آدرس، مدلها پایدار مانده.
چه کسانی Cherry Studio را از طریق یک gateway مسیردهی میکنند.
- کاربران دسکتاپ دوزبانه که GLM، Qwen، Kimi، و DeepSeek را با Claude و GPT در یک انتخابگر، یک موجودی، بدون حساب هر-vendor مخلوط میکنند.
- کاربران در آسیا که میخواهند id های Claude و GPT روی یک موجودی پیشپرداخت بدون کارت غربی، کنار مدلهای منطقهای که از قبل استفاده میکنند داشته باشند.
- کاربران قدرتمند که دستیارهای Cherry Studio را به ازای هر نقش اجرا میکنند و میخواهند هر دستیار بدون مدیریت پنج کلید به vendor درست pin شود.
- افرادی که از قبل ابزارهای دیگر را از طریق یک gateway مسیردهی میکنند و میخواهند کلاینت دسکتاپ روی همان کلید و لاگ usage باشد.
- هرکسی که مدلهای منطقهای و غربی را روی کار واقعی روزانه بهجای benchmark مقایسه میکند، جایی که هر کاندید یک ردیف مدل است.
endpoint را تأیید کنید و اولین مکالمه را عیبیابی کنید.
اول فهرست مدلها را curl کنید و id هایی که قصد اضافهکردنشان را دارید کپی کنید؛ سپس یک chat completion در برابر انتخاب روزانه مورد نظر خود اجرا کنید. با موفقیت هر دو، هر چیز باقیمانده در صفحه provider است. داخل Cherry Studio، Check را قبل از چتکردن اجرا کنید. شکستهای احراز هویت فیلد کلید یا جداکنندههای کاما آن هستند. 404 ها شکل آدرساند، URL ساختهشده در خطا را بخوانید و بخشهای /v1 را بشمارید. خطاهای not-found روی یک مدل خاص املای id در آن ردیف است. وقتی مکالمات جریان یابند، کنسول APIsRouter مدل، شمارش token، و هزینه به ازای هر درخواست را نشان میدهد. یک کلاینت دسکتاپ که در طول یک روز کاری استفاده میشود جریان پیوستهای از درخواستهای کوچک تولید میکند، و نمای usage هر-کلید آن جریان را به اعداد هر-مدل، هر-روز تبدیل میکند، با id های چینی و غربی روی همان صفحه.
curl -s https://api.apisrouter.com/v1/chat/completions \
-H "Authorization: Bearer $APISROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v4-flash",
"messages":[{"role":"user","content":"ping"}]}'پرسشهای پرتکرار
چطور یک provider سفارشی در Cherry Studio اضافه کنم؟
آیکون چرخدنده، تب Model Services، Add. provider را نامگذاری کنید، نوع OpenAI را انتخاب کنید، ذخیره کنید، سپس در صفحهاش آن را فعال کنید، کلید خود را paste کنید، API address را روی https://api.apisrouter.com تنظیم کنید، و id های مدل را دستی اضافه کنید. با دکمه Check اعتبارسنجی کنید.
آیا API address باید /v1 را شامل شود؟
نه. پیشفرض مستند Cherry Studio آدرس ریشه را میگیرد و خودش /v1/chat/completions را پیوست میکند، پس https://api.apisrouter.com را وارد کنید. paste کردن یک host با /v1 مسیر را دوبار میکند و 404 میدهد. برای pin کردن یک URL دقیق غیراستاندارد، آدرس را با # پایان دهید تا concatenation غیرفعال شود.
آیا Cherry Studio میتواند Claude، DeepSeek، و GLM را از طریق یک provider اجرا کند؟
بله. id هر ردیف مدل بهعنوان یک رشته ساده به آدرس سفر میکند، پس claude-sonnet-4-6، deepseek-v4-flash، glm-5.2، kimi-k2.6، و qwen3.7-plus میتوانند یک provider و یک کلید مشترک داشته باشند، قابلتعویض به ازای هر مکالمه و هر دستیار.
ویژگی کلید جدا-شده-با-کاما چه کاری انجام میدهد؟
چند کلید در فیلد API key، جدا-شده با کاما انگلیسی، از بالا به پایین بین درخواستها چرخانده میشوند، یک ویژگی load-balancing داخلی. با متریشدن هر-کلید سمت gateway، همچنین بهعنوان انتساب کار میکند؛ یک کلید تنها را فهرست کنید تا چرخش خاموش بماند.
چرا دکمه Check شکست میخورد؟
با یک کلید درست، دلیل معمول یک آدرس با /v1 اضافه است که مسیر ساختهشده را دوبار میکند. با یک آدرس تمیز، دوباره کلید و جداکنندههای آن را چک کنید؛ کاماهای full-width از روشهای ورودی چینی فهرستهای چند-کلید را بیصدا خراب میکنند.
چرا مدلها مثل provider های preset خودکار پر نمیشوند؟
provider های سفارشی دقیقاً همانی که اضافه میکنید را فهرست میکنند؛ Cherry Studio کاتالوگ یک endpoint سفارشی را fetch نمیکند. این انتخابگر را curated نگه میدارد. id ها را از فهرست /v1/models بکشید و آنهایی که واقعاً استفاده میکنید را اضافه کنید، سپس روزی که یکی دیگر لازم شد فهرست را گسترش دهید.