# فهرست مدل‌ها

> فهرست مدل‌های فعلی را با نسخه، مسیر و وضعیت هر مدل می‌دهد. شناسه‌هایی که هنوز باز نیستند وضعیت `coming_soon` دارند.

URL: https://dana.expert/docs/api-reference/list-models

`GET https://api.dana.expert/v1/models`

## هدرها

| فیلد | نوع | الزامی | توضیح |
|---|---|---|---|
| `Authorization` | string | بله | کلید API از کنسول دانا: `Authorization: Bearer dn-live-...` |
| `x-api-key` | string | نه | همان کلید، به‌جای هدر `Authorization` |

## پاسخ `200`

فهرست مدل‌ها

| فیلد | نوع | الزامی | توضیح |
|---|---|---|---|
| `object` | string | بله | مقدار: `"list"` |
| `data` | object[] | بله |  |

**فیلدهای هر عضو data:**

| فیلد | نوع | الزامی | توضیح |
|---|---|---|---|
| `id` | string | بله | شناسه‌ای که در درخواست می‌فرستید |
| `object` | string | بله | مقدار: `"model"` |
| `created` | integer | بله | زمان پاسخ، Unix seconds |
| `owned_by` | string | بله | مقدار: `"dana"` |
| `endpoint` | string | بله | مسیری که این مدل را سرو می‌کند |
| `status` | string | بله | وضعیت مدل؛ مقدار: `"available"`، `"coming_soon"` |
| `version` | string | نه | نسخهٔ فعلی؛ برای مدل‌هایی که هنوز باز نشده‌اند نمی‌آید |

نمونه:

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

## خطاها

| کد | یعنی |
|---|---|
| `401` | کلید نرسید یا شناخته نشد |

فرمت خطا:

```json
{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "param": null,
    "code": null
  }
}
```