# 取得所有模型

![](https://privstation-docs.apmic.ai/img/notion/16051aaefc33.png)

此 API 用於列出目前系統中可使用的所有語言模型。回傳的 `data[].id` 即為 Chat Completions 請求中 `model` 欄位應填入的值，常用於前端下拉選單、模型選擇頁面，也可用來測試 PrivAI 伺服器與 API Key 是否正常運作。

```bash
curl -X 'GET' \
  'http://127.0.0.1:8000/v1/models' \
  -H 'accept: application/json' \
  -H "Authorization: Bearer $PRIVAI_API_KEY"
```

#### Request Headers

| **Key** | **Value** |
| --- | --- |
| Request Method | GET |
| accept | application/json |
| Authorization | Bearer &lt;your-api-key> |

#### Response Body

```json
{
  "object": "list",
  "data": [
    {
      "id": "ace-1",
      "object": "model",
      "created": 1677610602,
      "owned_by": "N/A",
      "max_input_characters": 128000
    }
  ]
}
```

**Field Explanation**

| **Field** | **Detail** |
| --- | --- |
| object | 與 OpenAI 相容而保留，固定為 `"list"` |
| data[] | 模型列表 |
| `data[].id` | 模型名稱；呼叫 Chat Completions 時填入 `model` 欄位的值 |
| `data[].object` | 與 OpenAI 相容而保留，固定為 `"model"` |
| `data[].created` | Unix timestamp。與 OpenAI 相容而保留，**並非**模型實際建立時間 |
| `data[].owned_by` | 模型擁有者，與 OpenAI 相容而保留 |
| `data[].max_input_characters` | 模型建議的輸入字元數上限。**僅供參考，並非強制限制**；未設定時為 `null` |

#### 錯誤處理

- 未帶或帶入無效的 API Key 時，回傳身份驗證類錯誤，請參考 [錯誤代碼說明-身份驗證類](https://privstation-docs.apmic.ai/latest/privai-400/錯誤代碼說明-身份驗證類.md)。

- 若後端模型服務無法取得模型清單，會直接回傳該服務的 HTTP 狀態碼，Response Body 為 `{"detail": "LiteLLM API error: ..."}`。
