# مدل‌ها

> مدل‌های API دانا، نسخهٔ فعلی و وضعیت دسترسی هر مدل

URL: https://dana.expert/docs/models

شناسه‌ای که در درخواست می‌فرستید ثابت می‌ماند. نسخهٔ مدلی که جواب داده در فیلد `model_version` پاسخ می‌آید، پس با عوض شدن نسخه کدتان عوض نمی‌شود.

| خانواده | مسیر | شناسه در API | نسخهٔ فعلی (`model_version`) | وضعیت |
|---|---|---|---|---|
| مترجم هدهد | `POST /v1/translate` | `dana-translator` | `hodhod-v2.3` (هدهد v2.3) | در دسترس |
| سنجه: قناری | `POST /v1/decide` | `ghanari` (پیش‌فرض) | `ghanari-ir-v0.1` (Ghanari-IR v0.1) | در دسترس |
| سنجه: کبوتر | `POST /v1/decide` | `kabootar` | `kabootar-d3-mini` | در دسترس |
| هما، گفت‌وگو | `POST /v1/chat/completions` و `POST /v1/messages` | `homa` | `homa-c2b` | در دسترس |

اگر مدلی همین حالا در دسترس نباشد، پاسخ `503` با `code` برابر `model_unavailable` است؛ چند دقیقه بعد دوباره بفرستید ([خطاها](https://dana.expert/docs/errors)).

## کجا مدل را انتخاب می‌کنید

- **مترجم:** انتخابی لازم نیست؛ همیشه هدهد جواب می‌دهد.
- **سنجه:** فیلد اختیاری `model` در بدنه، `ghanari` یا `kabootar`. قناری سریع‌تر است و کبوتر دقیق‌تر. جزئیات در [سنجه](https://dana.expert/docs/decide).
- **هما، مدل گفت‌وگو:** فیلد `model` در بدنه برابر `homa`. جزئیات در [هما](https://dana.expert/docs/homa).

## فهرست از خود API

`GET /v1/models` با همان کلید، فهرست فعلی را با نسخه و مسیر هر مدل می‌دهد:

```bash
curl https://api.dana.expert/v1/models \
  -H "Authorization: Bearer $DANA_API_KEY"
```

```json
{
  "object": "list",
  "data": [
    {"id": "dana-translator", "version": "hodhod-v2.3", "endpoint": "/v1/translate", "status": "available", "object": "model", "owned_by": "dana"},
    {"id": "ghanari", "version": "ghanari-ir-v0.1", "endpoint": "/v1/decide", "status": "available", "object": "model", "owned_by": "dana"},
    {"id": "kabootar", "version": "kabootar-d3-mini", "endpoint": "/v1/decide", "status": "available", "object": "model", "owned_by": "dana"},
    {"id": "homa", "version": "homa-c2b", "endpoint": "/v1/chat/completions", "status": "available", "object": "model", "owned_by": "dana"},
    {"id": "dana-1", "endpoint": "/v1/chat/completions", "status": "coming_soon", "object": "model", "owned_by": "dana"},
    {"id": "dana-1-fast", "endpoint": "/v1/chat/completions", "status": "coming_soon", "object": "model", "owned_by": "dana"}
  ]
}
```

شناسه‌های `dana-1` و `dana-1-fast` هنوز باز نیستند و پاسخ `503` با `code` برابر `coming_soon` می‌گیرند.

## مرجع کامل

قرارداد این مسیر در [مرجع API](https://dana.expert/docs/api-reference/list-models) آمده است.