خانه → راهنماها → Cherry Studio با API سفارشی: نشانی، مدل‌ها، Claude و ورودی تصویر

Cherry Studio با API سفارشی: نشانی، مدل‌ها، Claude و ورودی تصویر

افزودن ارائه‌دهنده در Cherry Studio کمتر از یک دقیقه طول می‌کشد. تنها فیلدی که اشتباه پر می‌شود نشانی API است، چون Cherry خودش /v1 را اضافه می‌کند. وقتی شروع به پیوست کردن اسکرین‌شات می‌کنید، مهم است بدانید کدام مدل‌ها واقعاً تصویر را می‌بینند — ما هفت مدل را آزمودیم.

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

1. تنظیمات ← ارائه‌دهندگان مدل را باز کنید و روی افزودن بزنید. یک نام بگذارید (مثلاً APICLAN) و نوع OpenAI را انتخاب کنید.
2. کلید API را از کنسول بچسبانید.
3. نشانی API را https://apiclan.us وارد کنید.
4. روی بررسی بزنید و یک مدل دلخواه انتخاب کنید تا از کارکرد کلید مطمئن شوید.

آنچه وارد می‌کنید	آنچه Cherry Studio فراخوانی می‌کند
https://apiclan.us	https://apiclan.us/v1/chat/completions ✓
https://apiclan.us/v1/	https://apiclan.us/v1/chat/completions ✓
https://apiclan.us/v1	https://apiclan.us/v1/v1/chat/completions ✗ 404

Cherry Studio به انتهای نشانی /v1/chat/completions اضافه می‌کند، مگر اینکه نشانی با / تمام شود. پس https://apiclan.us و https://apiclan.us/v1/ هر دو کار می‌کنند، اما https://apiclan.us/v1 بدون اسلش پایانی به /v1/v1 تبدیل می‌شود و 404 برمی‌گرداند.

افزودن مدل‌ها

زیر ارائه‌دهنده روی مدیریت بزنید. Cherry Studio فهرست را از /v1/models می‌گیرد که فقط مدل‌های گروه کلید شما را برمی‌گرداند. در ۱۲ اکتبر ۲۰۲۶ این فهرست چنین بود:

• گروه GPT: gpt-5.6-sol, gpt-5.6-terra, gpt-6-astra, gpt-6-sol, gpt-6.1-sol
• گروه DeepSeek: deepseek-v4-flash, deepseek-v4-pro, deepseek-v4.1-flash (به‌علاوهٔ نسخه‌های تاریخ‌دار)

کنار مدل‌های دلخواه روی + بزنید. اگر مدلی در فهرست نیست، کلید شما به گروه دیگری تعلق دارد — هر کلید در این درگاه فقط به یک گروه وابسته است.

افزودن Claude

یک ارائه‌دهندهٔ دوم از نوع Anthropic اضافه کنید، با همان نشانی https://apiclan.us و کلیدی که در یک گروه Claude ساخته‌اید. سپس claude-opus-5-5 یا claude-fable-5-1 را اضافه کنید. یک ارائه‌دهنده برای هر گروه باعث می‌شود کلیدها قاطی نشوند: GPT، DeepSeek و Claude هر کدام مدخل جداگانه دارند.

کدام مدل‌ها تصویر پیوست‌شده را می‌خوانند

یک تصویر کوچک تک‌رنگ یکسان را با همان درخواست سبک OpenAI که Cherry Studio به کار می‌برد برای هر مدل فرستادیم و رنگش را پرسیدیم. آزمون را با رنگ دوم تکرار کردیم تا حدس شانسی پذیرفته نشود.

مدل	خواندن تصویر	زمان پاسخ
claude-opus-5-5	✓	3.1 s
claude-fable-5-1	✓	3.3 s
deepseek-v4.1-flash	✓	2.3–3.1 s
gpt-6-astra	✓	6.6 s
gpt-5.6-sol	✓	7.3 s
gpt-6.1-sol	✓	24–25 s
deepseek-v4-pro	✗	—

deepseek-v4-pro تصویر نمی‌پذیرد: برای تصویری سبز پاسخ داد «white» و بار دیگر چیزی برنگرداند، بی‌آنکه خطایی بدهد. برای اسکرین‌شات از مدل‌های تیک‌دار استفاده کنید. gpt-6.1-sol تصویر را درست می‌خواند اما حدود ۲۴ ثانیه طول کشید، در حالی که در درخواست فقط‌متنی نخستین توکن پس از ۲٫۶ ثانیه می‌رسد. اگر Cherry Studio برای مدلی دکمهٔ تصویر نشان نمی‌دهد، تنظیمات آن مدل را باز کنید و گزینهٔ بینایی را تیک بزنید. تاریخ آزمون: ۱۲ اکتبر ۲۰۲۶.

خطاهای رایج

• 401 ← کلید نادرست است یا با ارائه‌دهنده جور نیست (مثلاً کلید GPT در ارائه‌دهندهٔ Anthropic).
• 404 ← نشانی بدون اسلش با /v1 تمام شده است. از https://apiclan.us استفاده کنید.
• model_not_found (is not supported by any configured account in this group) ← این مدل در گروه کلید شما نیست. آن را از مدیریت اضافه کنید، نه با تایپ دستی.
• پاسخ تصویر شما را نادیده می‌گیرد ← این مدل نمی‌تواند تصویر بخواند. به یکی از مدل‌های تیک‌دار جدول بروید.

ابزارهای برنامه‌نویسی را راه‌اندازی می‌کنید؟ Cline با API سفارشی · Codex با API سفارشی.

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

بدون اشتراک، بدون حداقل ماهانه، بدون تماس فروش. با 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 · فارسی · Русский

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