# قیمت و توکن

> توکن در دانا چطور شمرده می‌شود، اعتبار کی کسر می‌شود و مصرف را کجا ببینید

URL: https://dana.expert/docs/pricing-and-tokens

دانا بر اساس توکن ورودی و خروجی هر درخواست اعتبار کسر می‌کند. واحد پرداخت تومان است.

## قیمت هر مدل

قیمت‌ها به تومان و برای هر یک میلیون توکن است:

| مدل | مسیر | ورودی | خروجی |
|---|---|---|---|
| مترجم هدهد (`dana-translator`) | `POST /v1/translate` | ۱۰٬۰۰۰ | ۴۰٬۰۰۰ |
| سنجه (`ghanari` و `kabootar`) | `POST /v1/decide` | ۱۰٬۰۰۰ | ۱۰٬۰۰۰ |
| هما (`homa`) | `POST /v1/chat/completions` و `POST /v1/messages` | ۱۰٬۰۰۰ | ۴۰٬۰۰۰ |

برای نمونه، اگر ترجمه‌ای ۱۳۰ توکن ورودی و ۲۵۰ توکن خروجی مصرف کند، هزینه‌اش حدود ۱۱ تومان است. هزینهٔ سنجه هم به طول متن و تعداد پرسش‌ها بستگی دارد.

مصرف هر درخواست همان لحظه در [گزارش درخواست‌ها](https://console.dana.expert/logs) دیده می‌شود. کسر قطعی از موجودی هر ساعت یک بار، از روی همین گزارش، در دفتر اعتبار ثبت می‌شود.

## توکن چیست

توکن کوچک‌ترین واحد متنی است که مدل می‌بیند. نه حرف است و نه دقیقا کلمه؛ چیزی میان این دو. به‌طور تقریبی:

- هر ۷۵ کلمه انگلیسی ≈ ۱۰۰ توکن
- فارسی معمولا توکن بیشتری نسبت به انگلیسی مصرف می‌کند

پس یک متن فارسی و ترجمه انگلیسی‌اش، با اینکه یک حرف می‌زنند، یک اندازه هزینه ندارند.

## چه چیزهایی شمرده می‌شوند

در هدهد، متن انگلیسی ورودی است و ترجمهٔ فارسی خروجی. در سنجه، متن و پرسش‌ها ورودی‌اند و هر پرسش یک توکن خروجی حساب می‌شود.

در گفت‌وگو با هما، مصرف به این شکل شمرده می‌شود:

| بخش | شامل چیست |
|---|---|
| ورودی | متن system، همه پیام‌های قبلی مکالمه، و پیام تازه کاربر |
| خروجی | متنی که مدل تولید می‌کند |

سه نکته که معمولا غافلگیر می‌کنند:

- **تاریخچه هر بار از نو شمرده می‌شود.** مدل حافظه ندارد؛ در هر درخواست کل مکالمه را دوباره می‌فرستید. مکالمه‌ای که طولانی می‌شود، هر نوبت گران‌تر از نوبت قبل تمام می‌شود. برای مکالمه‌های بلند، پیام‌های قدیمی را خلاصه کنید یا بیندازید دور.
- **پیام system هم ورودی است.** یک system prompt بلند، هزینه‌اش را به تک‌تک درخواست‌های آن مکالمه اضافه می‌کند.
- **هر پیام کمی سربار ساختاری دارد.** ده پیام کوتاه از یک پیام بلندِ هم‌اندازه، کمی بیشتر توکن مصرف می‌کند.

## برآورد ورودی گفت‌وگو

با مسیر `count_tokens` تعداد توکن ورودی را پیش از ارسال می‌سنجید:

```bash
curl https://api.dana.expert/v1/messages/count_tokens \
  -H "Authorization: Bearer $DANA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "homa",
    "messages": [{"role": "user", "content": "پایتخت ایران کجاست؟"}]
  }'
```

پاسخ:

```json
{"input_tokens": 12}
```

این عدد یک برآورد است، نه رسید. فقط ورودی را می‌شمارد و خروجی هنوز تولید نشده. برای گزارش قطعی، `usage` پاسخ اصلی را بخوانید.

## مصرف واقعی در پاسخ

هر پاسخ موفق فیلد `usage` دارد. نامش در دو رابط فرق می‌کند، معنایش یکی است:

**رابط OpenAI:**

```json
{
  "usage": {
    "prompt_tokens": 22,
    "completion_tokens": 15,
    "total_tokens": 37
  }
}
```

**رابط Anthropic:**

```json
{
  "usage": {
    "input_tokens": 22,
    "output_tokens": 15
  }
}
```

روی پاسخ streaming هم این آمار می‌آید، در رویداد پایانی.

## رزرو اعتبار برای درخواست گفت‌وگو

دانا موقع پذیرش درخواست، بدترین حالت هزینه را کنار می‌گذارد: توکن‌های ورودی به‌علاوه سقفی که در `max_tokens` خواسته‌اید. وقتی پاسخ تمام شد، تفاوت این برآورد با مصرف واقعی به موجودی برمی‌گردد.

دو نتیجه دارد. اول اینکه دیدن یک افت لحظه‌ای در موجودی طبیعی است. دوم اینکه `max_tokens` بزرگ و بی‌دلیل، تا پایان همان درخواست بخشی از اعتبارتان را قفل نگه می‌دارد. عددی بگذارید که واقعا لازم دارید.

اگر اعتبار کافی نباشد، درخواست با `429` و نوع `insufficient_quota` رد می‌شود و در [خطاها](https://dana.expert/docs/errors) شرح داده شده است.

## مشاهده مصرف و شارژ

در [کنسول دانا](https://console.dana.expert/usage) می‌توانید:

- مصرف روزانه توکن را ببینید
- درخواست‌ها را بر اساس مدل فیلتر کنید
- گزارش CSV بگیرید
- موجودی فعلی را بررسی کنید

شارژ اعتبار از [بخش اعتبار کنسول](https://console.dana.expert/credit) با درگاه پرداخت ایرانی انجام می‌شود.

## صفحه‌های مرتبط

- [Messages](https://dana.expert/docs/messages) - جزئیات endpoint شمارش توکن
- [مدل‌ها](https://dana.expert/docs/models) - انتخاب مدل
- [محدودیت‌ها](https://dana.expert/docs/rate-limits) - سقف نرخ درخواست
- [خطاها](https://dana.expert/docs/errors) - خطاهای مربوط به اعتبار