取得所有模型

此 API 用於列出目前系統中可使用的所有語言模型。回傳的 data[].id 即為 Chat Completions 請求中 model 欄位應填入的值,常用於前端下拉選單、模型選擇頁面,也可用來測試 PrivAI 伺服器與 API Key 是否正常運作。
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 <your-api-key> |
Response Body
{
"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 時,回傳身份驗證類錯誤,請參考 錯誤代碼說明-身份驗證類。
-
若後端模型服務無法取得模型清單,會直接回傳該服務的 HTTP 狀態碼,Response Body 為
{"detail": "LiteLLM API error: ..."}。