跳至主要内容
版本:PrivStation 4.0.0
Markdown 原文

取得所有模型

此 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​

KeyValue
Request MethodGET
acceptapplication/json
AuthorizationBearer <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

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

錯誤處理​

  • 未帶或帶入無效的 API Key 時,回傳身份驗證類錯誤,請參考 錯誤代碼說明-身份驗證類。

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