查詢平台模型列表

支援查詢平台模型列表；傳入組織 ID 後可查詢該組織實際可用的模型。

可以透過該 API，查詢平台模型列表；傳入 org_id 後回傳該組織實際可用的模型，包含組織自行設定的模型。

請求方式

GET

調用地址

https://api.${endpoint}/v1/model/list

調用驗證

使用帳號級 DevKey / DevSecret 的 Basic 驗證。

請求

請求範例

curl -X GET 'https://api.${endpoint}/v1/model/list?org_id=p-xxxx&agent_type=LOOP_AGENT' \ -H 'Authorization: Basic ${BASIC_TOKEN}'

                      
                      curl -X GET 'https://api.${endpoint}/v1/model/list?org_id=p-xxxx&agent_type=LOOP_AGENT' \
  -H 'Authorization: Basic ${BASIC_TOKEN}'

此代碼塊在浮窗中顯示

請求標頭

欄位	類型	說明
Authorization	Basic ${BASIC_TOKEN}	使用 `DevKey:DevSecret` Base64 後的 Basic Token。

請求參數（Query Parameters）

參數	類型	說明	required
org_id	String	組織 ID。傳入後會驗證組織成員身分，並回傳該組織可用的模型。	true
agent_type	String	Agent 類型。支援 `AGENT`、`FLOW_AGENT`、`LOOP_AGENT`、`WORKFLOW`；	true

回應

回應範例

{ "code": 0, "message": "OK", "data": { "CHAT": { "OPEN_AI": [ { "model_name": "GPT-4o", "aiModelVersion": "gpt-4o", "modelId": "mv-xxxx", "capabilities": ["pluginSupport", "ImageRecognition", "jsonSchema"] } ] } } }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "CHAT": {
      "OPEN_AI": [
        {
          "model_name": "GPT-4o",
          "aiModelVersion": "gpt-4o",
          "modelId": "mv-xxxx",
          "capabilities": ["pluginSupport", "ImageRecognition", "jsonSchema"]
        }
      ]
    }
  }
}

此代碼塊在浮窗中顯示

成功回應

欄位	類型	說明
model_name	String	模型顯示名稱。
aiModelVersion	String	模型版本名稱。
modelId	String	模型版本 ID，其他 API 引用模型時使用。
capabilities	String[]	模型能力列表。

失敗回應

欄位	類型	說明
code	Integer	錯誤碼。
message	String	錯誤詳情。

狀態碼

狀態碼	說明
200	成功
400	參數錯誤
401	未授權
403	權限不足
429	請求過於頻繁
500	伺服器錯誤