استفاده از QCode با 9router

QCode.cc را به‌عنوان یک ارائه‌دهنده سفارشی در 9router، یک روتر محلی چندارائه‌دهنده، برای جایگزینی خودکار میان ارائه‌دهنده‌ها و مدیریت یکپارچه اضافه کنید

به کلید API نیاز دارید؟ ثبت‌نام ←·نقاط پایانی و Base URL ←

9router یک پروکسی مسیریابی محلی چندارائه‌دهنده هوش مصنوعی است: سرویسی سازگار با OpenAI را روی دستگاه خودتان اجرا می‌کند (به‌طور پیش‌فرض http://localhost:20128/v1)، درخواست‌های ابزارهایی مانند Claude Code، Cursor، Cline و Codex را تحویل می‌گیرد و آن‌ها را بر اساس قواعد شما به چندین ارائه‌دهنده مدل ارسال می‌کند (از جمله جایگزینی خودکار / جابه‌جایی هنگام اتمام سهمیه / فشرده‌سازی خروجی برای صرفه‌جویی در توکن‌ها و غیره). از نظر مفهومی شبیه CCR خود QCode است — تفاوت در این است که 9router روی دستگاه خودتان اجرا می‌شود و توسط خودتان مدیریت می‌شود.

برای مشاهده دقیق قابلیت‌ها، پورت‌ها و رابط کاربری به مخزن رسمی 9router مراجعه کنید؛ این مقاله فقط به «نحوه افزودن QCode به آن» می‌پردازد.

چه زمانی به آن نیاز دارید¶

• اتصال مستقیم به QCode ساده‌تر است: اگر فقط از QCode استفاده می‌کنید، کافی است BASE_URL ابزار خود را روی api.qcode.cc تنظیم کنید — به 9router نیازی ندارید.
• زمانی که 9router منطقی است: وقتی می‌خواهید QCode را با سایر ارائه‌دهنده‌ها ترکیب کنید (پلن‌های اشتراکی، اعتبارهای تبلیغاتی، خودمیزبان و غیره) و به یک نقطه ورود یکپارچه، جایگزینی خودکار، جابه‌جایی میان ارائه‌دهنده‌ها یا فشرده‌سازی توکن نیاز دارید، می‌توانید QCode را به‌عنوان یکی از ارائه‌دهنده‌های 9router ثبت کنید (به‌عنوان ارائه‌دهنده اصلی یا به‌عنوان یک لایه جایگزین).

افزودن QCode به‌عنوان ارائه‌دهنده¶

1. 9router را طبق مستندات آن راه‌اندازی کنید و کنسول محلی را باز کنید (به‌طور پیش‌فرض http://localhost:20128).

2. در بخش «Providers»، یک ارائه‌دهنده سفارشی / سازگار با OpenAI (Compatible Node) اضافه کنید:

3. نقطه پایانی / Base URL:

   • چت (خانواده GPT): https://api.qcode.cc/openai/v1
   • چت (خانواده Claude، اگر 9router از نودهای پروتکل Anthropic پشتیبانی کند): https://api.qcode.cc/api
   • تصویر (اختیاری): https://api.qcode.cc/qcode-img/v1 (به نکته زیر مراجعه کنید)
   • در چین سرزمین اصلی، دامنه را با asia.qcode.cc (نقطه دسترسی نزدیک آسیا) جایگزین کنید.
4. کلید API: کلید API شما در QCode (که با cr_ شروع می‌شود).
5. مدل‌ها / نام‌های مستعار: claude-opus-5، claude-sonnet-5، gpt-6-sol، gpt-5.6-terra و غیره را بر اساس نیاز ثبت کنید (نسخه‌های 4.x مانند claude-sonnet-4-6 همچنان به فروش می‌رسند).
6. این ارائه‌دهنده QCode را در زنجیره لایه‌ها / جایگزینی خود قرار دهید (مثلاً به‌عنوان ارائه‌دهنده اصلی، یا به‌عنوان یک لایه جایگزین وقتی سهمیه سایر ارائه‌دهنده‌ها تمام می‌شود).
7. ابزارهای خود (Claude Code / Cursor / Cline و غیره) را به نقطه ورود محلی 9router یعنی http://localhost:20128/v1 اشاره دهید — از آن پس 9router تصمیم می‌گیرد چه زمانی درخواست را به QCode مسیردهی کند.

QCode مستقیم در برابر QCode از طریق 9router¶

نکته‌ها¶

• فقط محلی: 9router به‌صورت محلی اجرا می‌شود و پیکربندی آن بین اعضای تیم به اشتراک گذاشته نمی‌شود.
• مسیریابی تصویر نیاز به آزمایش خودتان دارد: 9router مسیر /v1/images/generations را ارائه می‌دهد، اما «فراخوانی gpt-image-2 در QCode از طریق 9router» آزمایش‌نشده است و ممکن است به پیکربندی اضافی نیاز داشته باشد؛ اگر به قابلیت اطمینان نیاز دارید، تصاویر را از طریق image-2 مستقیم مسیریابی کنید.
• سهمیه‌ها از داشبورد QCode تبعیت می‌کنند: آمار 9router با سهمیه واقعی حساب کاربری QCode شما یکسان نیست (سقف‌های روزانه هر کلید و غیره از داشبورد QCode / probe.qcode.cc تبعیت می‌کنند).
• نگاشت پروتکل به مسیر: /openai/v1 از پروتکل OpenAI استفاده می‌کند، /api از پروتکل Anthropic استفاده می‌کند، و /qcode-img/v1 برای تصاویر است — نقاط پایانی و قالب‌های API را ببینید.

نصب و نقطه پایانی محلی (بر اساس README رسمی 9router)¶

تا تاریخ 2026-10-15، شروع سریع در README رسمی 9router این‌گونه است: با npm install -g 9router نصب کنید، آن را با 9router اجرا کنید و به‌طور پیش‌فرض داشبورد را در http://localhost:20128 باز کنید. در ابزاری که می‌خواهید به آن متصل شوید، نقطه پایانی را روی http://localhost:20128/v1 تنظیم کنید و کلید API را از داشبورد 9router کپی کنید. README همچنین بیان می‌کند که نقاط پایانی سازگار با OpenAI / Anthropic سفارشی پشتیبانی می‌شوند و QCode از همین طریق اضافه می‌شود.

توضیح تنظیمات کلیدی¶

خطاهای رایج و روش عیب‌یابی¶

ابتدا QCode را مستقیماً با curl فراخوانی کنید (بخش 5 از نقاط پایانی و قالب‌های API) تا کلید و مسیر را تأیید کنید، سپس لایه 9router را اشکال‌زدایی کنید. این کار باعث صرفه‌جویی زیادی در رفت‌وبرگشت می‌شود.

پرسش‌های متداول¶

اگر فقط از QCode استفاده می‌کنم، آیا به 9router نیاز دارم؟¶

خیر. اگر فقط از QCode استفاده می‌کنید، BASE_URL ابزار را مستقیماً روی api.qcode.cc (یا asia.qcode.cc در سرزمین اصلی چین) تنظیم کنید. این ساده‌تر است: یک پراکسی محلی کمتر و یک نقطه کمتر برای بروز مشکل.

چرا هزینه نمایش‌داده‌شده در 9router با صورت‌حساب QCode من تفاوت دارد؟¶

اعداد در 9router تخمین‌های خودش بر اساس انتخاب‌های مسیریابی‌اش هستند. QCode بر اساس توکن صورت‌حساب می‌کند، با نرخ‌های هر مدل که در qcode.cc/models فهرست شده‌اند، و این داشبورد QCode است که واقعاً ملاک است.

آیا Claude Code می‌تواند از مدل‌های Claude از طریق 9router استفاده کند؟¶

فقط اگر 9router از یک گره با پروتکل Anthropic پشتیبانی کند و شما آدرس /api مربوط به QCode را به‌عنوان چنین گره‌ای پیکربندی کرده باشید. با تنها یک گره سازگار با OpenAI، مدل‌های Claude رد می‌شوند. رابط کاربری دقیق در مخزن رسمی 9router توضیح داده شده است.

چگونه تأیید کنم درخواست‌هایی که از 9router عبور می‌کنند واقعاً به QCode می‌رسند؟¶

کلید cr_ خود را در probe.qcode.cc وارد کنید؛ اگر مدل و توکن‌های درخواست را می‌بینید، درخواست رسیده است. در غیر این صورت، بررسی کنید که آیا ارائه‌دهنده QCode در سطح / زنجیره جایگزینی 9router قرار دارد و آیا به اندازه کافی در ابتدای آن قرار گرفته است.

یک کلید API در دو پروتکل (Anthropic / OpenAI) کار می‌کند، چه مستقیماً متصل شوید و چه از طریق روتری مانند 9router. درباره قیمت‌گذاری QCode.cc اطلاعات کسب کنید.

سازمانی ←