# مدل‌های چینی

QCode.cc چیزی بیش از Claude / GPT / Gemini می‌فروشد. همان کلید `cr_` نیز به Zhipu GLM، Moonshot Kimi، DeepSeek و Qwen می‌رسد. این صفحه فقط به این پرسش پاسخ می‌دهد که «درخواست‌ها چگونه به این شناسه‌ها می‌رسند» — بدون مقایسه سبک، بدون بازاریابی.

پیش‌فرض روزانه همچنان باید خانواده Claude 5 باشد (به [راهنمای انتخاب مدل](/docs/usage/model-selection) مراجعه کنید). خانواده‌های چینی در این موارد می‌درخشند: متن‌های اداری و بلند چینی، حجم انبوه ارزان‌تر، و به‌عنوان کنترل در برابر Claude. هرگز نامی را در کلاینت وارد نکنید که در [qcode.cc/models](https://qcode.cc/models) نمایش داده نمی‌شود.

## اکنون چه چیزی به فروش می‌رسد

شناسه‌های زیر در 2026-09-18 هم در [qcode.cc/models](https://qcode.cc/models) و هم در نقطه پایانی عمومی `GET https://api.qcode.cc/api/v1/models` ظاهر شدند (بررسی متقابل شده‌اند؛ قیمت‌های واحد در لحظه و اندازه‌های پنجره زمینه همان چیزی است که [qcode.cc/models](https://qcode.cc/models) نشان می‌دهد — این صفحه عمداً اعداد را کپی نمی‌کند).

| خانواده | شناسه پرچمدار | یک رده سبک‌تر |
|------|---------|----------|
| Zhipu GLM | `glm-5.3` | `glm-5.3-flash` |
| Moonshot Kimi | `kimi-k3.1-pro` · `kimi-k3` | — (نسخه پیشین `kimi-k2.6` بازنشسته شده است) |
| DeepSeek | `deepseek-v4-pro` | `deepseek-v4-flash` · `deepseek-v4.1-flash` |
| Qwen | `qwen3.8-max` | `qwen3.8-flash` · `qwen3.7-plus` |

نام‌هایی که ممکن است هنوز در نمونه‌های قدیمی ببینید اما دیگر فروخته نمی‌شوند: `qwen3.7-max`، `kimi-k2.6`، `glm-5.1` — از هر دو فهرست زنده حذف شده‌اند؛ وارد کردن آن‌ها در کلاینت شکست می‌خورد، به شناسه‌های بالا تغییر دهید.

**grok وجود ندارد.** فهرست زنده: [qcode.cc/models](https://qcode.cc/models) یا `GET https://api.qcode.cc/v1/models` با کلید خود.

**kimi-k3.1-pro در یک نگاه** (از 2026-11-11 در QCode فهرست شده است): پنجره زمینه 1M توکن، محدودیت خروجی 131,072 توکن به ازای هر درخواست در QCode؛ توکن‌های استدلال به‌عنوان توکن خروجی حساب می‌شوند و با نرخ خروجی صورت‌حساب می‌شوند؛ ورودی تصویر پشتیبانی می‌شود. نرخ‌های هر مدل: [qcode.cc/models](https://qcode.cc/models).

## کدام پروتکل

پروتکل با **مسیر** تعیین می‌شود؛ کلید به خانواده‌ها کاری ندارد. مرجع اصلی: [نقاط پایانی و مسیرهای API](/docs/getting-started/endpoints-and-api-paths).

| ابزار شما | چه چیزی وارد کنید | فیلد مدل چه چیزی را می‌پذیرد |
|------------|--------|----------------|
| OpenAI SDK / LangChain / Cline "OpenAI Compatible" / [WorkBuddy](/docs/ide/workbuddy) | `https://api.qcode.cc/openai/v1` (سرزمین اصلی چین: ترجیحاً `https://asia.qcode.cc/openai/v1`) | شناسه‌های جدول بالا، عیناً کاراکتر به کاراکتر |
| Claude Code (طبق [محیط](/docs/getting-started/environment) از قبل به QCode اشاره می‌کند) | نیازی به تغییر `ANTHROPIC_BASE_URL` نیست | در نشست `/model glm-5.3` |
| HTTP دستی | `POST /openai/v1/chat/completions` | `"model"` در JSON |

شناسه‌های خانواده چینی را زیر پیشوند `/gemini` مربوط به Gemini قرار ندهید، و ابزارهای سازگار با OpenAI را روی `https://api.qcode.cc/api` تنظیم نکنید (این همان پیشوند Anthropic Messages است).

مدل‌های غیر Claude ممکن است ویژگی‌های بومی مانند Extended Thinking را در Claude Code از دست بدهند — [راهنمای انتخاب مدل](/docs/usage/model-selection) همین هشدار را برای GPT مستند می‌کند. در صورت تردید، با آن‌ها به‌عنوان یک رده تکمیلی رفتار کنید، نه یک جایگزین.
## خودآزمایی curl

همان تفسیر مستندات نقاط پایانی: `400` = مسیر و کلید هر دو درست‌اند (نبود بدنه مورد انتظار است)، `401` = کلید نامعتبر، `404` = پیشوند اشتباه.

```bash
KEY="cr_your-QCode-key"

# path check only
curl -s -o /dev/null -w '%{http_code}\n' -X POST https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY"

# end-to-end with one id on sale (replace glm-5.3 with the id you want)
curl -sS https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY" \
  -H "content-type: application/json" \
  -d '{"model":"glm-5.3","messages":[{"role":"user","content":"ping"}]}'
```

از سرزمین اصلی چین، میزبان را به `asia.qcode.cc` تغییر دهید و دوباره آزمایش کنید. یک کلید روی هر سه دامنه کار می‌کند.

کلاینت مرجع OpenAI Python (`base_url` را روی `/openai/v1` تنظیم کنید، **بدون** اسلش انتهایی):

```python
from openai import OpenAI

client = OpenAI(
    api_key="cr_your-QCode-key",
    base_url="https://api.qcode.cc/openai/v1",
)
resp = client.chat.completions.create(
    model="glm-5.3",
    messages=[{"role": "user", "content": "ping"}],
)
```

## ترکیب با خانواده Claude 5

| کاری که انجام می‌دهید | با چه چیزی شروع کنید | زمانی که مدل‌های چینی وارد می‌شوند |
|------------|------|----------------|
| ویرایش‌های روزمره کد | `claude-sonnet-5` | یک دور کنترل اجرا کنید، یا با بودجه محدود از `deepseek-v4-pro` / `glm-5.3` استفاده کنید |
| استدلال دشوار / بازآرایی‌های بزرگ | `claude-opus-5` | تغییر اجباری لازم نیست؛ برای یک اجرای مقایسه‌ای `kimi-k3.1-pro` را امتحان کنید |
| متن چینی طولانی، یادداشت‌ها، کارهای اداری | هر مدل پرچم‌دار | `kimi-k3.1-pro`، `kimi-k3`، `glm-5.3`، `qwen3.8-max` رایج‌اند |
| کارهای انبوه و پرزحمت | `claude-haiku-5-5` | وقتی می‌خواهید اینجا از یک مدل چینی استفاده کنید: `deepseek-v4-flash` / `qwen3.8-flash` |

نسل 4.x (`claude-sonnet-4-6`، `claude-opus-4-8`) **هنوز در فروش است**، فقط دیگر پیش‌فرض نیست. قیمت‌ها و پنجره‌ها: [qcode.cc/models](https://qcode.cc/models).

همان کلید در یک کلاینت دسکتاپ اداری: [یکپارچه‌سازی WorkBuddy](/docs/ide/workbuddy) را ببینید. جابه‌جایی Claude Code / Codex: [راه‌اندازی CC Switch](/docs/ide/cc-switch).

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

### id را وارد کردید اما 404 / فهرست خالی گرفتید

id باید در جدول شبیه `glm-5.3` باشد، نه «GLM-5.3» یا یک نام نمایشی. حالت سازگار با OpenAI اغلب چیزی فهرست نمی‌کند — id را دستی وارد کنید.

### 401

کلید با `cr_` شروع می‌شود و فاصله اضافی ندارد. آن را در [qcode.cc/dashboard](https://qcode.cc/dashboard) بررسی کنید.

### آیا می‌توانم GLM را از طریق `/api/v1/messages` در Anthropic فراخوانی کنم؟

دروازه پروتکل را بر اساس مسیر انتخاب می‌کند. `/openai/v1/chat/completions` مسیر مستندشده برای کلاینت‌های سازگار با OpenAI است. وقتی Claude Code از قبل به QCode اشاره می‌کند، فقط `/model <id>` را بزنید — برای رده چینی نیازی به فراخوانی‌های دستی Messages نیست.

### WorkBuddy / Cline چطور؟

WorkBuddy: ارائه‌دهنده Custom، نقطه پایانی `https://api.qcode.cc/openai/v1`، نام مدل = یک id از جدول؛ گام‌به‌گام در [یکپارچه‌سازی WorkBuddy](/docs/ide/workbuddy). Cline همان Base URL و شناسه مدل را زیر «OpenAI Compatible» استفاده می‌کند.

## گام‌های بعدی

- [نقاط پایانی و مسیرهای API](/docs/getting-started/endpoints-and-api-paths)
- [راهنمای انتخاب مدل](/docs/usage/model-selection)
- [صورت‌حساب](/docs/reference/billing)
- [یکپارچه‌سازی WorkBuddy](/docs/ide/workbuddy)
- idهای فعال: [qcode.cc/models](https://qcode.cc/models)
- در سمت CLI ترمینال: Qwen Code شناسه‌های چینی را در شاخه `openai` از `modelProviders` اعلام می‌کند — [راه‌اندازی Qwen Code](/docs/ide/qwen-code) را ببینید؛ Kimi Code CLI از `type = "openai"` در `[providers.<name>]` استفاده می‌کند — [راه‌اندازی Kimi Code CLI](/docs/ide/kimi-code) را ببینید.
- برای یک فرانت‌اند وب چت خودمیزبان: Open WebUI به مدل‌های چینی از طریق همین نشانی سازگار با OpenAI دسترسی پیدا می‌کند، اما فقط Chat Completions را ارسال می‌کند، بنابراین Claude آنجا در دسترس نیست — [یکپارچه‌سازی Open WebUI](/docs/ide/open-webui) را ببینید.