Updated on 2025-08-04 GMT+08:00

Obtaining the Model List (Models/GET)

This chapter describes how to query the model list through the Models API.

Description

Table 1 API information

Parameter

Description

Example Value

url

API URL for calling the model service.

https://api.modelarts-maas.com/v1/models

Creating a Request

  • Authentication description

    MaaS inference services support API key authentication. The authentication header is in the following format:

    'Authorization': 'Bearer API key of the region where the service is deployed'
  • Response parameters
    Table 2 Response parameters

    Parameter

    Type

    Description

    object

    string

    Type-list: (The queried information is listed.)

    data

    Array

    Model information of the model service. The main parameters are as follows:

    • id: model ID used when calling the API to create a request.
    • object: model type.
    • created: creation timestamp.

Example Request

import requests

url = "https://api.modelarts-maas.com/v1/models"

headers = {"Authorization": "Bearer yourApiKey"}

response = requests.request("GET", url, headers=headers)

print(response.text)

Response Example

{
  "object": "list",
  "data": [
    {
      "id": "DeepSeek-R1",
      "object": "model",
      "created": 0,
      "owned_by": ""
    },
    {
      "id": "DeepSeek-V3",
      "object": "model",
      "created": 0,
      "owned_by": ""
    }
  ]
}