Help Center/ MaaS/ Model Calling/ Model API Calling Specifications/ Obtaining the Model List (Models/GET)
Updated on 2026-08-19 GMT+08:00

Obtaining the Model List (Models/GET)

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

Constraints

This function is only available in the CN-Hong Kong region.

API Information

Table 1 API information

Parameter

Description

Example Value

API Host

API URL for calling the model service.

https://api-ap-southeast-1.modelarts-maas.com/v2/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

The following uses the requests library of Python to send an HTTP GET request to obtain model information.

Replace yourApiKey with the actual API key. For more information, see Manage API Keys.

import requests

url = "https://api-ap-southeast-1.modelarts-maas.com/v2/models"

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

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

print(response.text)

Response Example

{
    "object": "list",
    "data": [
        {
            "id": "deepseek-v4-flash",
            "object": "list",
            "created": 0,
            "owned_by": "system"
        },
        {
            "id": "deepseek-v4-pro",
            "object": "list",
            "created": 0,
            "owned_by": "system"
        },
        {
            "id": "glm-5.1",
            "object": "list",
            "created": 0,
            "owned_by": "system"
        },
        {
            "id": "glm-5.2",
            "object": "list",
            "created": 0,
            "owned_by": "system"
        }
    ]
}