j9九游会登录/ 大模型即服务平台 maas/ api参考/ / 查询自定义接入点
更新时间：2026-02-10 gmt 08:00

查询自定义接入点-j9九游会登录

功能介绍

该api用于查询用户接入点列表。

接口约束

该功能仅支持“西南-贵阳一”区域。

uri

get /v1/{project_id}/maas/services/custom-endpoint/endpoint

表1 路径参数

参数

是否必选

参数类型

描述

project-id

是

string

参数解释：项目id。关于如何获取项目id，请参见获取项目id和名称。

约束限制：不涉及。

取值范围：不涉及。

默认取值：不涉及。

请求参数

表2 请求header参数

参数

是否必选

参数类型

描述

x-auth-token

是

string

参数解释：用户token。通过调用iam服务的获取用户token接口获取（响应消息头中x-subject-token的值）。具体操作，请参见认证鉴权。

约束限制：不涉及。

取值范围：不涉及。

默认取值：不涉及。

响应参数

表3 响应body参数

参数

参数类型

描述

total

integer

参数解释：当前账号下所有自定义接入点总数。

取值范围：不涉及。

count

string

参数解释：本次查询数量。

取值范围：不涉及。

items

array[customendpointinfo]

参数解释：自定义接入点列表，详情请参见表4。

取值范围：不涉及。

quantity_limit

integer

参数解释：最大自定义接入点数量限制。

取值范围：不涉及。
表4 customendpointinfo

参数

参数类型

描述

id

string

参数解释：自定义接入点的id。

取值范围：不涉及。

source

string

参数解释：自定义接入点的资源类型。

取值范围：

  • custom_from_maas：maas“在线推理”页面的预置服务，由maas计费。
  • custom_from_modelarts_v2：新版的ai开发平台modelarts-在线服务，由modelarts计费。

status

string

参数解释：自定义接入点的状态。

取值范围：不涉及。

cbc_status

string

参数解释：自定义接入点的cbc状态。

取值范围：不涉及。

endpoint_name

string

参数解释：用户填写的自定义接入点的名称。

取值范围：不涉及。

remark

string

参数解释：用户填写的自定义接入点的描述。

取值范围：不涉及。

rpm

integer

参数解释：用户设置自定义接入点流控时的rpm值，未设置时为null。

取值范围：不涉及。

tpm

integer

参数解释：用户设置自定义接入点流控时的tpm值，未设置时为null。

取值范围：不涉及。

served_model_name

string

参数解释：调用自定义接入点时使用的预置模型名称。

取值范围：不涉及。

model_version_id

string

参数解释：记录基于哪个预置模型版本创建出来的自定义接入点，为空则指代整个模型。

取值范围：不涉及。

resident_model_id

string

参数解释：预置服务模型id。

取值范围：不涉及。

moderation

boolean

参数解释：自定义接入点内容安全护栏开关。

取值范围：

  • true：在模型推理链路中，开启内容安全护栏，提供额外拦截输入输出有害内容的能力，可能导致时延增加。
  • false：不开启内容安全护栏，使用模型原生安全能力。

region

string

参数解释：基于ai开发平台modelarts-在线服务的自定义接入点所处的区域。

取值范围：不涉及。

backend_model_name

string

参数解释：调用后端模型时网关改写后的真实模型名称。

取值范围：不涉及。

created_at

string

参数解释：创建时间。

取值范围：不涉及。

updated_at

string

参数解释：更新时间。

取值范围：不涉及。

sku_code

string

参数解释：预置模型的sku码。

取值范围：不涉及。

base_url

string

参数解释：预置模型的baseurl。

取值范围：不涉及。

resident_model_rpm

integer

参数解释：预置模型的rpm值。

取值范围：不涉及。

resident_model_tpm

integer

参数解释：预置模型的tpm值。

取值范围：不涉及。

model_type_key

array[string]

参数解释：模型类型。

取值范围：不涉及。

version_served_model_name

string

参数解释：调用自定义接入点时使用的预置模型版本。

取值范围：不涉及。

billing_mode_for_ui

object

参数解释：计费模式。

取值范围：不涉及。

billing_factor_list

array[object]

参数解释：计价因子列表。

取值范围：不涉及。

billing_desc

object

参数解释：计价描述。

取值范围：不涉及。

model_name

string

参数解释：模型名称。

取值范围：不涉及。

version_name

string

参数解释：模型版本名称。

取值范围：不涉及。

supported_api_schemas

array[string]

参数解释：支持的调用api方式列表。

取值范围：不涉及。

resource_id

string

参数解释：资源id。

取值范围：不涉及。

moderation_visible

boolean

参数解释：是否可以开关安全护栏。

取值范围：不涉及。
表5 错误响应参数

参数

参数类型

描述

error_msg

string

参数解释：错误描述信息。

取值范围：不涉及。

error_code

string

参数解释：错误码，标识错误类型。

取值范围：不涉及。

请求示例

此处以查询接入点列表为例。

get
/v1/{project_id}/maas/services/custom-endpoint/endpoint

响应示例

  • 成功响应，状态码：200。 
    {
    "total": 1,
    "count": 1,
    "quantity_limit": 10,
    "items": [
        {
            "id": "c4513589-df2e-4d58-ab0c-d5a6f2******",
            "endpoint_name": "deepseek-test",
            "served_model_name": "deepseek-v3.1-4zglnu",
            "rpm": null,
            "tpm": null,
            "cbc_status": "bytoken",
            "status": "normal",
            "source": "custom_from_maas",
            "resident_model_id": "1671ce67-033a-4d9e-9fb9-fd81a4******",
            "model_version_id": "8d41f3ad-f75b-4a8f-bd31-5a8f9d******",
            "remark": "deepseek自定义接入点测试1",
            "moderation": true,
            "region": "",
            "backend_model_name": "deepseek-v3.1",
            "created_at": "2025-12-09t11:32:46 08:00",
            "updated_at": "2025-12-09t11:36:21 08:00",
            "base_url": "https://api.modelarts-maas.com",
            "sku_code": "modelarts.tokens.deepseek.v3.1",
            "resident_model_rpm": 1500,
            "resident_model_tpm": 500000,
            "model_type_key": [
                "text generation"
            ],
            "version_served_model_name": "deepseek-v3.1",
            "billing_mode_for_ui": {
                "type": "tokens",
                "zh_cn": "按token计费",
                "en_us": "token-based billing"
            },
            "billing_factor_list": [
                {
                    "type": "input",
                    "zh_cn": "输入",
                    "en_us": "input",
                    "measure_id": 109,
                    "usage_factor_list": [
                        "input"
                    ]
                },
                {
                    "type": "output",
                    "zh_cn": "输出",
                    "en_us": "output",
                    "measure_id": 109,
                    "usage_factor_list": [
                        "output"
                    ]
                }
            ],
            "billing_desc": {
                "zh_cn": "",
                "en_us": ""
            },
            "model_name": "deepseek-v3.1",
            "version_name": "20250929",
            "supported_api_schemas": [
                "v1",
                "v2",
                "anthropic"
            ],
            "resource_id": "062474c0-8124-4e6e-bbeb-01ab86******"
        }
    ]
}
  • 失败响应，状态码：400。 
    {
    "error_msg": "invalid token.",
    "error_code": "modelarts.0104"
}

状态码

请参见状态码。

错误码

请参见错误码。

父主题：

相关文档

网站地图