文档首页/ MaaS模型即服务/ API参考/ 自定义接入点/ 编辑自定义接入点
更新时间：2026-03-17 GMT+08:00
查看PDF
分享

编辑自定义接入点

功能介绍

该API用于编辑指定接入点的流控、内容安全护栏开关、接入点名称、接入点描述。

接口约束

  • 该功能仅支持“中国-香港”区域。
  • 自定义接入点创建后，不支持修改模型服务。

URI

PUT /v1/{project_id}/maas/services/custom-endpoint/endpoint/{custom_endpoint_id}

表1 路径参数

参数

是否必选

参数类型

描述

project-id

是

String

参数解释：项目ID，获取方式请参见获取项目ID和名称。

约束限制：不涉及。

取值范围：不涉及。

默认取值：不涉及。

custom_endpoint_id

是

String

参数解释：自定义接入点ID。创建接入点时接口会返回，或者使用查询接口获取。具体操作，请参见创建自定义接入点或查询自定义接入点。

约束限制：不涉及。

取值范围：不涉及。

默认取值：不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

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

约束限制：不涉及。

取值范围：不涉及。

默认取值：不涉及。

Content-Type

是

String

参数解释：消息体的类型，固定为application/json。

约束限制：不涉及。

取值范围：不涉及。

默认取值：不涉及。
表3 请求Body参数

参数

是否必选

参数类型

描述

endpoint_name

否

String

参数解释：接入点名称。

约束限制：单用户的名称具有唯一性。

取值范围：输入长度1至64位，以中文，大小写字母开始，只包含中文、大小写字母、数字、中划线、下划线和小数点。

默认取值：不涉及。

remark

否

String

参数解释：接入点的描述。

约束限制：不涉及。

取值范围：输入长度最大256个字符。

默认取值：不涉及。

rpm

否

Integer

参数解释：接入点RPM流控值。

约束限制：不涉及。

取值范围：每个模型的取值范围不同，您可以在ModelArts Studio（MaaS）控制台“在线推理 > 预置服务”页签的“模型限流”列查看模型对应的取值范围。

默认取值：不涉及。

tpm

否

Integer

参数解释：接入点TPM流控值。

约束限制：不涉及。

取值范围：每个模型的取值范围不同，您可以在ModelArts Studio（MaaS）控制台“在线推理 > 预置服务”页签的“模型限流”列查看模型对应的取值范围。

默认取值：不涉及。

moderation

否

Boolean

参数解释：是否开启内容安全护栏。仅客户等级为V2及以上，支持开启或关闭内容安全护栏。

说明：

客户等级查看方式：登录MaaS控制台，在右上角用户名下单击“基本信息”，查看账号名后的级别。

约束限制：非必填，默认值为true。

取值范围：

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

默认取值：true。

agreement_id

否

String

参数解释：开关内容安全护栏需要签订协议，这里传入的是协议id。获取方式请参见获取最新内容安全护栏免责声明中的agreement_id。

约束限制：moderation为false时为必填。

取值范围：不涉及。

默认取值：不涉及。

响应参数

表4 响应参数（成功）

参数

参数类型

描述

1

String

参数解释：操作结果标识，固定返回1。

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

参数

参数类型

描述

error_msg

String

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

取值范围：不涉及。

error_code

String

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

取值范围：不涉及。

请求示例

  • MaaS非多模态模型：此处以修改自定义接入点的名称、描述、内容安全护栏开关、RPM和TPM参数为例。 
    /v1/{project_id}/maas/services/custom-endpoint/endpoint/{custom_endpoint_id} 

{
"endpoint_name": "DeepSeek",
"remark": "DeepSeek",
"moderation": false,
"agreement_id": "af247c14-2bee-4d78-a5e8-a419ea62****",
"rpm":0,
"tpm":0 
}

响应示例

  • 成功响应，状态码：200 
    1
  • 失败响应，状态码：400 
    {
"error_msg": "Invalid token.",
"error_code": "ModelArts.0104" 
}

状态码

请参见状态码。

错误码

请参见错误码。

父主题： 自定义接入点