# شرح صورتحساب

این سند روش صورتحساب و منطق قیمت‌گذاری QCode.cc را به‌تفصیل معرفی می‌کند و به شما کمک می‌کند بفهمید هزینه‌ها چگونه محاسبه می‌شوند.

## اصول صورتحساب

QCode.cc بر اساس **مصرف توکن** صورتحساب صادر می‌کند. هر بار که یک مدل هوش مصنوعی را فراخوانی می‌کنید، هزینه از دو بخش تشکیل می‌شود:

- **توکن‌های ورودی**: محتوایی که به مدل می‌فرستید، شامل prompt، زمینه، محتوای فایل و غیره.

- **توکن‌های خروجی**: محتوای پاسخی که مدل تولید می‌کند.

> **توکن چیست؟** توکن واحد پایه متن است که مدل پردازش می‌کند. در انگلیسی، 1 توکن تقریباً معادل 4 کاراکتر یا ¾ یک کلمه است؛ در چینی، هر 1 کاراکتر معمولاً معادل 1 تا 2 توکن است.

فرمول محاسبه هزینه:

```text
Total Cost = Input Tokens × Input Unit Price + Output Tokens × Output Unit Price
```

## منبع داده قیمت‌گذاری

### قیمت چگونه محاسبه می‌شود

```text
QCode price = official API price × service rate
```

**نرخ سرویس** کارمزد سرویس مسیریابی و پروکسی است. پلتفرم آن را برای هر ارائه‌دهنده تعیین می‌کند، بنابراین می‌تواند بین ارائه‌دهندگان متفاوت باشد. قیمت واحد نهایی هر مدل و نرخ فعلی در کارت‌های نرخ بالای [qcode.cc/models](https://qcode.cc/models) نمایش داده می‌شود — این صفحه همچنین تنها منبع حقیقت مورد استفاده برای صورتحساب است.

به‌صورت جداگانه، ارائه‌دهندگان **قیمت‌های فهرستی فراخوانی‌های API را منتشر می‌کنند** اما قواعد کامل داخلی شمارش توکن خود را افشا نکرده‌اند (برای مثال: آیا promptهای سیستمی شمارش می‌شوند، توکن‌های استفاده از ابزار چگونه شمارش می‌شوند، اصابت به کش (cache hit) چگونه قیمت‌گذاری می‌شود). به همین دلیل، برآورد و صورتحساب واقعی همچنان می‌توانند اندکی متفاوت باشند.

### جدول قیمت‌گذاری qcode.cc/models

برای تضمین **شفافیت و انصاف** در صورتحساب، QCode.cc از جدول قیمت‌گذاری مدل‌ها که در صفحه رسمی **qcode.cc/models** نگهداری می‌شود به‌عنوان مبنای صورتحساب استفاده می‌کند:

**نشانی منبع داده:** [qcode.cc/models](https://qcode.cc/models)

**چرا از qcode.cc/models استفاده می‌شود؟**

- **همگام‌سازی در زمان واقعی**: قیمت‌های صفحه models هنگام تغییر قیمت‌ها توسط ارائه‌دهندگان به‌سرعت به‌روزرسانی می‌شود.

- **تنها منبع حقیقت**: از همان داده قیمت‌گذاری صورتحساب کنسول و سهمیه پلن‌ها استفاده می‌کند.

- **پوشش جامع**: تمام مدل‌های ارائه‌دهندگان بزرگ مانند Anthropic، OpenAI و Google را پوشش می‌دهد.

- **باز و شفاف**: همه قیمت‌گذاری‌ها به‌صورت عمومی در دسترس است تا هر کسی بتواند مشاهده و بررسی کند.

- **به‌روزرسانی به‌موقع**: وقتی ارائه‌دهندگان مدل قیمت‌ها را تغییر می‌دهند، داده قیمت‌گذاری به‌سرعت به‌روزرسانی می‌شود.
## خانواده‌های مدل پشتیبانی‌شده

QCode از **هفت خانواده مدل** پشتیبانی می‌کند: Claude، GPT / Codex، Gemini، GLM، Kimi، DeepSeek و Qwen. **grok وجود ندارد.**

چهار خانواده چینی (GLM / Kimi / DeepSeek / Qwen) همان کلید `cr_` و همان نقاط پایانی سه خانواده نخست را به اشتراک می‌گذارند. برای شناسه‌های در حال فروش فعلی (مانند `glm-5.2`، `kimi-k3`، `deepseek-v4-pro`، `qwen3.7-max`) به [qcode.cc/models](https://qcode.cc/models) مراجعه کنید؛ برای نحوه تکمیل پروتکل و نام مدل، [مدل‌های چینی](/docs/usage/cn-models) را ببینید.

## مرجع قیمت‌گذاری مدل‌های اصلی

قیمت‌گذاری مدل‌های پرکاربرد (واحد: USD / میلیون توکن):

### قیمت‌گذاری فعلی مدل‌ها

برای **نرخ‌های لحظه‌ای هر مدل** (ورودی / خروجی / کش) همیشه به **[qcode.cc/models](https://qcode.cc/models)** مراجعه کنید — این تنها منبع داده صورتحساب است؛ این صفحه دیگر نسخه‌ای از اعداد را نگه نمی‌دارد تا از اختلاف با صورتحساب واقعی جلوگیری شود.

میزان تقریبی (قیمت ورودی Haiku 4.5 = 1×):

- **خانواده Claude**: Haiku 4.5 (1×) < Sonnet 5 (≈2×) < Sonnet 4.6 (≈3×) < Opus 5 / 4.8 (≈5×) < Fable 5 (≈10×)
- **خانواده GPT**: برای نرخ‌های خانواده gpt-6 (sol / astra) و gpt-5.6-sol / gpt-5.6-terra به صفحه مدل‌ها مراجعه کنید

> می‌توانید هر زمان مدل‌های موجود را با یک درخواست GET احراز هویت‌شده به `https://api.qcode.cc/v1/models` فهرست کنید.

### درباره قیمت‌گذاری کش

برخی مدل‌ها (مانند سری Claude) از **کش prompt** پشتیبانی می‌کنند که محتوای زمینه تکراری را در کش نگه می‌دارد. قیمت‌گذاری مرتبط با کش:

- **نوشتن در کش**: هزینه نوشتن محتوا در کش برای نخستین بار، که معمولاً کمی بیشتر از قیمت‌های ورودی عادی است.

- **خواندن از کش**: هزینه هنگام برخورد با کش، که معمولاً حدود 10% قیمت‌های ورودی عادی است.

سازوکار کش می‌تواند هزینه‌های مصرف را در سناریوهایی با زمینه تکراری به‌طور چشمگیری کاهش دهد.

### صورتحساب زمینه بلند برای مدل‌های GPT

سری GPT (`gpt-6.1-sol`، `gpt-6-sol`، `gpt-6-astra`، `gpt-5.6-sol`، `gpt-5.6-terra`) از همان قاعده OpenAI پیروی می‌کند و بر اساس طول ورودی یک درخواست واحد، دو سطح را به کار می‌برد:

- توکن‌های ورودی یک درخواست (**شامل بخشی که از کش ارائه می‌شود**) برابر یا کمتر از 272K: با قیمت‌های واحد استاندارد صورتحساب می‌شود

- بالای 272K: برای **کل درخواست** با قیمت‌های زمینه بلند صورتحساب می‌شود — قیمت واحد ورودی و خواندن از کش 2× است، قیمت واحد خروجی 1.5× است (این ضریب‌ها به کل درخواست اعمال می‌شوند، نه فقط به بخش بالای 272K)

قیمت‌های زمینه بلند هر مدل در [qcode.cc/models](https://qcode.cc/models) در خط «>272K» زیر هر قیمت GPT فهرست شده است. سری Claude و همه خانواده‌های دیگر سطح‌های بلند/کوتاه ندارند.

> مکالمه‌های طولانی همچنان رشد می‌کنند. وقتی زمینه به 272K نزدیک می‌شود، از قابلیت فشرده‌سازی کلاینت شما (مانند `/compact` در Codex) استفاده کنید یا نشست جدیدی آغاز کنید تا درخواست در سطح استاندارد باقی بماند.
## نمونه‌های صورت‌حساب

فرض کنید از claude-sonnet-5 برای یک جلسه پرسش و پاسخ کدنویسی استفاده می‌کنید:

| مورد | تعداد | قیمت واحد | هزینه |
|------|------|------|------|
| توکن‌های ورودی | 5,000 | $2.00 / میلیون | $0.010 |
| توکن‌های خروجی | 2,000 | $10.00 / میلیون | $0.020 |
| **مجموع** | | | **$0.030** |

در مصرف واقعی، یک تعامل کامل با Claude Code معمولاً شامل چندین فراخوانی API است (تحلیل کد، تولید راه‌حل، اجرای عملیات و غیره)، بنابراین هزینه واقعی بیشتر از یک فراخوانی واحد خواهد بود.

## سازوکار به‌روزرسانی قیمت

- QCode.cc با جدیدترین داده‌های قیمت‌گذاری از qcode.cc/models **به‌طور منظم همگام‌سازی می‌کند**.

- وقتی یک ارائه‌دهنده مدل تعدیل قیمت را اعلام می‌کند، qcode.cc/models قیمت‌گذاری را بی‌درنگ به‌روزرسانی می‌کند و ما نیز به‌تبع آن همگام‌سازی می‌کنیم.

- به‌روزرسانی‌های قیمت بر هزینه‌های تاریخی که قبلاً ایجاد شده‌اند تأثیری ندارند؛ آن‌ها فقط بر مصرف جدید پس از به‌روزرسانی اثر می‌گذارند.

## پلن‌ها و سهمیه

صورت‌حساب همیشه به ازای هر توکن است؛ پلن‌ها تنها در نحوه اعطای سهمیه تفاوت دارند:

| پلن | شکل سهمیه | بازنشانی / اعتبار |
|---|---|---|
| پلن شخصی | سهمیه روزانه | در 00:00 به وقت پکن بازنشانی می‌شود |
| بسته تقویتی | سهمیه اضافی برای آن روز | در 02:00 به وقت پکن روز بعد به‌صورت جداگانه بازنشانی می‌شود |
| بسته پرداخت به‌ازای مصرف | سهمیه کل برای دوره اعتبار | بسته Small / Medium / Large / XL، همه به مدت 7 روز معتبرند؛ تمدید انباشته می‌شود، باقی‌مانده‌ها در زمان انقضا باطل می‌شوند |
| پلن تیمی | به ازای هر واحد ($4,000 برای هر واحد در ماه) | [راهنمای پلن تیمی](/docs/reference/enterprise-guide) را ببینید |

برای قیمت بسته‌ها و قواعد تمدید و انقضا، [بسته‌های پرداخت به‌ازای مصرف](/docs/reference/payg-packs) را ببینید؛ برای مقایسه گزینه‌ها، [نحوه انتخاب پلن](/docs/getting-started/choose-a-plan) را ببینید. هنگامی که سهمیه تمام می‌شود، پاسخ HTTP 402 است؛ [مرجع خطاها](/docs/reference/errors#402-quota-exhausted) را ببینید.

در یک سرور ابری، هزینه به دو بخش تقسیم می‌شود: هزینه سرور برای دوره‌ای که انتخاب می‌کنید (1، 3، 6 یا 12 ماه) محاسبه می‌شود و مدل‌ها به ازای هر توکن. انتخاب ماشین در [سرورهای ابری: انتخاب، خرید و استفاده](/docs/getting-started/cloud-servers) پوشش داده شده است، قواعد سمت سرور در [صورت‌حساب و قواعد سرور ابری](/docs/reference/cloud-billing)، و اجرای عامل‌ها روی آن در [اجرای عامل‌ها روی سرور ابری](/docs/usage/cloud-server-agents).

## نحوه مشاهده مصرف

### داشبورد (توصیه‌شده)

به [QCode.cc Console](https://qcode.cc/dashboard) وارد شوید و به صفحه «آمار مصرف» بروید تا موارد زیر را مشاهده کنید:

- **جزئیات فراخوانی مدل**: مدل، تعداد توکن و هزینه هر فراخوانی.

- **خلاصه هزینه**: آمار هزینه روزانه و ماهانه.

- **پیشرفت مصرف پلن**: مصرف سهمیه پلن اشتراک فعلی.

### مشاهده در CLI

برای مشاهده سریع نمای کلی مصرف نشست فعلی، از فرمان `/cost` در Claude Code استفاده کنید:

```text
/cost
```

> **نکته**: هزینه‌ای که `/cost` نشان می‌دهد یک مقدار تقریبی است. برای داده‌های دقیق، لطفاً به داشبورد مراجعه کنید.
## پرسش‌های متداول

### آیا قیمت شما با قیمت رسمی یکسان است؟

نه دقیقاً. قیمت QCode = قیمت رسمی API × **نرخ سرویس**؛ نرخ سرویس همان کارمزد سرویس مسیریابی و پراکسی است که پلتفرم برای هر ارائه‌دهنده تعیین می‌کند. قیمت واحد نهایی هر مدل و نرخ فعلی در [qcode.cc/models](https://qcode.cc/models) آمده است که تنها منبع مرجع مورد استفاده برای صورت‌حساب است.

جدا از این، قواعد داخلی شمارش توکن ارائه‌دهندگان به‌طور کامل افشا نمی‌شود؛ بنابراین برآورد داخلی `/cost` در CLI و مبلغ واقعی کسرشده که در داشبورد نمایش داده می‌شود همچنان ممکن است اندکی متفاوت باشد.

### چرا یک درخواست با زمینه بلند از حد معمول گران‌تر است؟

در سری GPT، به‌محض اینکه ورودی یک درخواست (شامل بخش کش‌شده) از 272K توکن فراتر رود، کل درخواست با قیمت‌های زمینه بلند محاسبه می‌شود (ورودی و خواندن از کش 2×، خروجی 1.5×) که با قاعده خود OpenAI مطابقت دارد. به بخش «صورت‌حساب زمینه بلند برای مدل‌های GPT» در بالا مراجعه کنید. سری Claude پله‌بندی ندارد.

### داده‌های قیمت‌گذاری هر چند وقت یک‌بار به‌روزرسانی می‌شود؟

ما به‌طور منظم با منبع داده qcode.cc/models همگام‌سازی می‌کنیم. به‌روزرسانی‌ها معمولاً چند روز پس از اعلام تعدیل قیمت از سوی ارائه‌دهنده کامل می‌شوند.

### چگونه می‌توانم قیمت‌ها را خودم بررسی کنم؟

می‌توانید داده‌های قیمت‌گذاری qcode.cc/models را مستقیماً ببینید:

1. به [qcode.cc/models](https://qcode.cc/models) مراجعه کنید.

2. نام مدلی را که استفاده می‌کنید جست‌وجو کنید (مثلاً `claude-sonnet-5`).

3. قیمت ورودی و قیمت خروجی آن را بررسی کنید.

4. قیمت‌ها به‌ازای هر میلیون توکن فهرست شده‌اند.

### چرا از جدول قیمت‌گذاری عمومی به‌جای قیمت‌های اختصاصی استفاده می‌شود؟

انتخاب یک منبع مرجع واحد، باز و شفاف، انصاف را تضمین می‌کند. جدول قیمت‌گذاری qcode.cc/models به‌صورت عمومی در دسترس است و هر کسی می‌تواند آن را بررسی و راستی‌آزمایی کند؛ این کار از بروز اختلاف‌های قیمتی جلوگیری می‌کند.

### سهمیه بسته پرداخت به‌ازای مصرف چگونه کسر می‌شود؟

مانند هر پلن دیگری به‌ازای هر توکن محاسبه می‌شود، با نرخ‌های هر مدل در [qcode.cc/models](https://qcode.cc/models)؛ هزینه از سهمیه کل بسته کسر می‌شود که روزانه بازنشانی نمی‌شود و تا زمان اتمام آن ادامه دارد. به [بسته‌های پرداخت به‌ازای مصرف](/docs/reference/payg-packs) مراجعه کنید.

### آیا می‌توانم برای بسته پرداخت به‌ازای مصرف بازپرداخت دریافت کنم؟

خیر. بسته‌ها غیرقابل بازپرداخت هستند و سهمیه باقی‌مانده پس از انقضا از بین می‌رود.

> **مشتریان سازمانی**: پلن تیمی QCode از **انتقال بانکی شرکتی** پشتیبانی می‌کند و ما می‌توانیم یک توافق‌نامه رسمی خدمات امضا کنیم. قیمت‌گذاری پله‌ای به‌ازای هر واحد — به [راهنمای پلن تیمی](/docs/reference/enterprise-guide) مراجعه کنید یا در [qcode.cc/enterprise](https://qcode.cc/fa/enterprise) بپرسید.

## صفحات مرتبط

- [پلن‌ها و قیمت‌گذاری](https://qcode.cc/fa/pricing) — مشاهده پلن‌ها و قیمت‌های فعلی
- [مدل‌ها و قیمت‌گذاری](https://qcode.cc/fa/models) — مشاهده قیمت‌گذاری و نرخ‌های لحظه‌ای همه مدل‌های پشتیبانی‌شده
- [مدل‌های چینی](/docs/usage/cn-models) — مسیرها و شناسه‌های GLM / Kimi / DeepSeek / Qwen
- [پرسش‌های متداول](/docs/reference/faq) — بازپرداخت‌ها، سهمیه‌ها و دیگر پرسش‌های مربوط به حساب کاربری
- [بسته‌های پرداخت به‌ازای مصرف](/docs/reference/payg-packs) — قیمت‌ها، قواعد تمدید و انقضای چهار بسته
- [چگونه یک پلن انتخاب کنیم](/docs/getting-started/choose-a-plan) — پلن شخصی، بسته‌ها، پلن تیمی و برنامه شرکا در کنار هم