全部產品
Search
文件中心

Platform For AI:ListModels - 擷取模型列表

更新時間:Dec 23, 2025

擷取模型列表。

調試

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

調試

授權資訊

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

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

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

paimodel:ListModels

list

*全部資源

*

請求文法

GET /api/v1/models HTTP/1.1

請求參數

名稱

類型

必填

描述

樣本值

PageNumber

integer

模型列表的頁碼。起始值為 1,預設為 1。

1

PageSize

integer

分頁查詢時設定的每頁顯示的模型數量,預設為 10。

10

Order

string

分頁查詢時,對指定的排序欄位進行升序或降序。預設 ASC。

  • ASC:升序。

  • DESC:降序。

DESC

SortBy

string

分頁查詢時的排序欄位。目前使用 GmtCreateTime 欄位用於排序。

GmtCreateTime

WorkspaceId

string

配置工作空間 ID,返回列表中只擷取該工作空間內的模型列表。如何擷取工作空間 ID,請參見 ListWorkspaces

324**

ModelName

string

配置模型名稱,用來過濾擷取的模型列表。

情感分析

Label

string

標籤串。用於列表過濾,標籤中 key 或 value 中,有指定字串的,都會被過濾出來。

key1

Provider

string

提供者。指定提供者,則只返回該提供者公開的模型。不填則返回使用者自己的模型。

pai

Domain

string

配置領域來過濾該領域內的模型列表。例如:nlp(自然語言處理)、cv(電腦視覺)等。

nlp

Task

string

配置任務來過濾屬於該任務類型的模型列表。例如:text-classification(文本分類)等。

text-classification

Origin

string

配置模型源,來過濾屬於該社區或組織的模型列表。例如 ModelScope,HuggingFace 等。

ModelScope

Query

string

配置查詢條件。ModelName、Domain、Task、LabelKey、LabelValue 相似匹配。 例如輸入為 nlp,則 ModelName、Domain、Task、LabelKey、LabelValue 中匹配的模型都會返回。

nlp

ModelType

string

模型類型

Endpoint

Collections

string

模型所在 Collection,支援填寫多個,用英文逗號分割

AI4D,QuickStart

Tag

array<object>

標籤列表。

Endpoint

object

標籤資訊。

Key

string

標籤的 key。

key1

Value

string

標籤的 value。

value1

Conditions

array<object>

條件。

object

Column

string

參數名。如:ParameterSize。

ParameterSize

Operator

string

操作符。如:LessThan。

LessThan

Value

string

值,如 3000。

3000

返回參數

名稱

類型

描述

樣本值

object

返回體。

RequestId

string

請求 ID。

5A14FA81-DD4E-******-6343FE44B941

Models

array

模型列表。

Model

模型。

TotalCount

integer

模型總數。

15

樣本

正常返回樣本

JSON格式

{
  "RequestId": "5A14FA81-DD4E-******-6343FE44B941",
  "Models": [
    {
      "ModelId": "model-1123*****",
      "ModelName": "情感分析",
      "GmtCreateTime": "2021-01-21T17:12:35Z",
      "GmtModifiedTime": "2021-01-21T17:12:35Z",
      "WorkspaceId": "234**",
      "UserId": "1557702098******",
      "OwnerId": "1557702098******",
      "ModelDescription": "情感分析。",
      "Accessibility": "PUBLIC",
      "LatestVersion": {
        "VersionName": "0.1.0",
        "GmtCreateTime": "2021-01-21T17:12:35Z",
        "GmtModifiedTime": "2021-01-21T17:12:35Z",
        "UserId": "155770209******",
        "OwnerId": "155770209******",
        "Uri": "oss://mybucket.oss-cn-beijing.aliyuncs.com/mypath/",
        "VersionDescription": "情感分析。",
        "FormatType": "SavedModel",
        "FrameworkType": "TensorFlow",
        "Options": "{}",
        "SourceType": "PAIFlow",
        "SourceId": "region=cn-shanghai,workspaceId=13**,kind=PipelineRun,id=run-sakdb****jdf",
        "ApprovalStatus": "Approved",
        "Labels": [
          {
            "Value": "v1",
            "Key": "k1"
          }
        ],
        "Metrics": {
          "Results": [
            {
              "Dataset": {
                "DatasetId": "d-sdkjanksaklerhfd"
              },
              "Metrics": {
                "cer": 0.175
              }
            },
            {
              "Dataset": {
                "Uri": "oss://xxxx/"
              },
              "Metrics": {
                "cer": 0.172
              }
            }
          ]
        },
        "TrainingSpec": {},
        "InferenceSpec": {
          "processor": "tensorflow_gpu_1.12"
        },
        "EvaluationSpec": {},
        "CompressionSpec": {},
        "ExtraInfo": {
          "CoverUris": [
            "https://e***u.oss-cn-hangzhou.aliyuncs.com/st****017.preview.png"
          ],
          "TrainedWords": [
            "albedo_overlord"
          ]
        },
        "DistillationSpec": {}
      },
      "OrderNumber": 101,
      "Origin": "ModelScope",
      "Domain": "nlp",
      "Task": "text-classifiaction",
      "ModelDoc": "https://***.md",
      "Provider": "pai",
      "ModelType": "Checkpoint",
      "Labels": [
        {
          "Key": "env",
          "Value": "test"
        }
      ],
      "Tags": [
        {
          "Key": "env",
          "Value": "test"
        }
      ],
      "ExtraInfo": {
        "RatingCount": 2866,
        "Rating": 4.94,
        "FavoriteCount": 34992,
        "CommentCount": 754,
        "CoverUris": [
          "https://e***u.oss-cn-hangzhou.aliyuncs.com/drea***w.png"
        ],
        "TippedAmountCount": 32,
        "DownloadCount": 606056
      },
      "ParameterSize": 1024,
      "GmtLatestVersionModifiedTime": "2021-01-21T17:12:35Z"
    }
  ],
  "TotalCount": 15
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情