全部產品
Search

搜尋本產品

    OpenSearch：GetModel - 擷取模型詳細資料

    文件中心

    OpenSearch：GetModel - 擷取模型詳細資料

    更新時間：Sep 22, 2025

    通過執行個體ID和模型名稱查詢特定模型的詳細配置資訊。

    介面說明

    請求說明

    • 該 API 用於擷取指定執行個體下的特定模型的詳細資料，包括模型類型、URL、狀態等。

    • 確保提供的instanceId和modelName是有效，否則可能返回錯誤或找不到資源。

    • 返回的資料結構中包含了模型的內容（如要求標頭、參數等）以及建立和更新時間，有助於瞭解模型的具體配置及其最新狀態。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    searchengine:GetModel

    get

    *Instance

    acs:searchengine:{#regionId}:{#accountId}:instance/{#InstanceId}

    		 無 無

    請求文法

    GET /openapi/ha3/instances/{instanceId}/models/{modelName} HTTP/1.1

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    instanceId

    string

    是

    執行個體 ID

    ha-cn-pl32rf0****
    modelName

    string

    是

    模型名稱

    test

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    requestId

    string

    請求 ID

    38b079f1-7846-4226-8c90-3e2644b5c52b
    result

    object

    模型配置資訊

    name

    string

    模型名稱

    test
    type

    string

    模型類別

    • a. 文本向量化：text_embedding

    • b. 文本稀疏向量化：text_sparse_embedding

    • c. 圖片向量化：image_embedding

    • d. 圖片內容解析：image_analyze

    枚舉值：

    • text_embedding :

      文本向量化

    • image_embedding :

      圖片向量化

    • image_analyze :

      圖片內容解析

    • text_sparse_embedding :

      文本稀疏向量化

    text_embedding
    url

    string

    模型存取 URL

    http://***.platform-cn-shanghai.opensearch.aliyuncs.com/v3/openapi/workspaces/default/text-embedding/ops-text-embedding-001
    status

    string

    模型狀態。

    • ok: 模型正常

    • error: 模型異常

    ok
    dimension

    integer

    模型的維度

    128
    content

    object

    模型配置資訊

    modelName

    string

    模型名稱

    test
    modelType

    string

    模型類別

    • a. 文本向量化：text_embedding

    • b. 文本稀疏向量化：text_sparse_embedding

    • c. 圖片向量化：image_embedding

    • d. 圖片內容解析：image_analyze

    text_embedding
    url

    string

    模型服務的訪問地址

    http://***.platform-cn-shanghai.opensearch.aliyuncs.com/v3/openapi/workspaces/default/text-embedding/ops-text-embedding-001
    method

    string

    模型服務訪問的 http method, 支援 PUT 和 POST

    POST
    request

    object

    請求配置資訊

    header

    object

    HTTP 要求頭

    Authorization

    string

    認證資訊，格式:Bearer access_token

    Bearer OS-v0********6vvs

    Content-Type

    string

    HTTP 要求內容類型。

    application/json

    urlParams

    object

    url 中的參數，有限模型服務需要從 url 上傳遞參數。

    build

    object

    構建索引時傳遞的參數

    key: value

    search

    object

    查詢時傳遞的參數

    key: value
    requestBody

    string

    請求 Body 體的模板字串

    {\"input\": [\"%{input}\"], \"input_type\": \"%{input_type}\"}

    parameters

    object

    如果 body 中的參數需要區分 build 和 search 階段，可以定義在這個參數中。

    build

    object

    索引構建階段的參數

    input_type

    string

    輸入類型

    query

    search

    object

    查詢階段的參數

    input_type

    string

    輸入類型

    document

    response

    object

    如何解析結果資訊，使用 json path 格式描述

    embeddings

    string

    如何解析結果資訊，使用 json path 格式描述

    $.result.embeddings[*].embedding

    createTime

    string

    建立時間

    2024-05-21 16:05:26
    updateTime

    string

    修改時間

    2024-05-21 16:05:26

    樣本

    正常返回樣本

    JSON格式

    {
  "requestId": "38b079f1-7846-4226-8c90-3e2644b5c52b",
  "result": {
    "name": "test",
    "type": "text_embedding",
    "url": "http://***.platform-cn-shanghai.opensearch.aliyuncs.com/v3/openapi/workspaces/default/text-embedding/ops-text-embedding-001",
    "status": "ok",
    "dimension": 128,
    "content": {
      "modelName": "test",
      "modelType": "text_embedding",
      "url": "http://***.platform-cn-shanghai.opensearch.aliyuncs.com/v3/openapi/workspaces/default/text-embedding/ops-text-embedding-001",
      "method": "POST",
      "request": {
        "header": {
          "Authorization": "Bearer OS-v0********6vvs\n",
          "Content-Type": "application/json\n"
        },
        "urlParams": {
          "build": {
            "test": "test",
            "test2": 1
          },
          "search": {
            "test": "test",
            "test2": 1
          }
        },
        "requestBody": "{\\\"input\\\": [\\\"%{input}\\\"], \\\"input_type\\\": \\\"%{input_type}\\\"}\n",
        "parameters": {
          "build": {
            "input_type": "query\n"
          },
          "search": {
            "input_type": "document\n"
          }
        }
      },
      "response": {
        "embeddings": "$.result.embeddings[*].embedding\n"
      }
    },
    "createTime": "2024-05-21 16:05:26",
    "updateTime": "2024-05-21 16:05:26"
  }
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。